Skip to main content
GET
/
users
List contacts
curl --request GET \
  --url https://apix.spotzee.com/api/client/users \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": 1024,
      "project_id": 42,
      "external_id": "cust-9f4b21",
      "created_at": "2026-04-28T05:14:00.000Z",
      "updated_at": "2026-04-28T05:14:00.000Z",
      "anonymous_id": "anon-2c8a3e",
      "email": "jane@example.com",
      "phone": "+61400123456",
      "timezone": "Australia/Sydney",
      "locale": "en-AU",
      "data": {
        "first_name": "Jane",
        "last_name": "Doe",
        "plan": "pro"
      },
      "has_push_device": true,
      "devices": [
        {}
      ]
    }
  ],
  "nextCursor": "<string>",
  "prevCursor": "<string>",
  "limit": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Project-scoped secret API key (sk_…). Pass in the Authorization: Bearer <key> header. Grants access to the project the key was issued for.

Query Parameters

​
cursor
string

Opaque cursor returned by a previous page response. Omit on the first request.

​
page
enum<string>

Direction to walk relative to cursor. Defaults to next when omitted.

Available options:
next,
prev
​
limit
integer | null
default:25

Maximum results per page. Use -1 to request all (rate-limited; large pages may be rejected).

Required range: -1 <= x <= 100
Example:

25

​
sort
string

Field to sort by. Defaults vary per resource.

Example:

"created_at"

​
direction
enum<string>

Sort direction. Defaults vary per resource.

Available options:
asc,
desc
​
q
string

Free-text search across the resource’s indexed fields.

Response

A page of contacts.

Paginated response of ContactList.

​
results
object[]
required

Page of results, ordered per the request’s sort and direction.

​
nextCursor
string | null
required

Opaque cursor for the next page. null when no further pages exist.

​
prevCursor
string | null
required

Opaque cursor for the previous page. null when on the first page.

​
limit
integer
required

Page size used to build this response.