List visitors

GET/v1/visitors

Auth: Secret API key (rk_sk_)

List visitors with cursor pagination.

Query parameters

Name	Type	Description
`email`	`string`	Filter by email
`external_id`	`string`	Filter by external ID
`limit`	`integer`	1–100, default 20
`cursor`	`string`	Pagination cursor

Responses

200Paginated list

{
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440002",
      "externalId": "usr_123",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "attributes": {
        "plan": "pro"
      },
      "createdAt": "2026-01-04T10:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}