BitelioBitelio

List contacts

Get a paginated list of contacts with cursor-based pagination.


Path versioning. This resource is also reachable at the unversioned /contacts, which is where it has always lived and which keeps working indefinitely — bitelio@0.1.0 calls it. Prefer /v1/contacts: the /v1 prefix is the path that carries a version promise, and a future /v2 will be able to change shape without breaking anything written against this one.

GET
/v1/contacts

Authorization

ApiKeyAuth

AuthorizationBearer <token>

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. The project is automatically derived from the key.

In: header

Query Parameters

limit?integer

Maximum items per page

Default20
Range1 <= value <= 100
cursor?string

Pagination cursor

search?string

Case-insensitive substring match on email.

Response Body

application/json

curl -X GET "https://api.bitelio.com/v1/contacts"
{
  "data": [
    {
      "id": "string",
      "email": "user@example.com",
      "subscribed": true,
      "data": {},
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "cursor": "string",
  "hasMore": true,
  "total": 0
}