Skip to main content
GET
/
v1
/
lists
List lists
curl --request GET \
  --url https://api.vendaze.com/v1/lists \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Newsletter Subscribers",
      "people_count": 142,
      "companies_count": 0,
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 8,
    "page": 1,
    "per_page": 50,
    "has_more": false
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.1 access token.

Query Parameters

page
integer
default:1

Page number.

Required range: x >= 1
per_page
integer
default:50

Number of records per page. Maximum: 100.

Required range: 1 <= x <= 100
order_by
enum<string>
default:created_at

Field to sort by.

Available options:
created_at,
name
order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

Lists returned successfully.

data
object[]
meta
object