Ir al contenido principal
Contacts

List contacts

Returns a list of contacts (customers and leads) in your organization using cursor-based pagination.

GET
/v2/contacts

Query Parameters

  • limit - Number of contacts to return (1-100, default 10)
  • cursor - Cursor from previous response for pagination
  • contactType - Filter by contact type: "customer" (default), "lead", or "all"

Response Format

Returns a list object with:

  • object - Always "list"
  • data - Array of contact objects
  • nextCursor - Cursor for the next page, or null if no more results

Contact Object

Each contact includes:

  • id - Unique contact identifier
  • userId - External user ID from SSO (if set)
  • email - Contact email address
  • name - Contact display name
  • profilePicture - Profile picture URL
  • type - Contact type ("customer" or "lead")
  • companies - Array of companies the contact belongs to
  • customFields - Custom field values
  • postsCreated - Number of posts created
  • commentsCreated - Number of comments created
  • lastActivity - Last activity timestamp

Example

{
  "object": "list",
  "data": [
    {
      "object": "contact",
      "id": "676f0f6765bdaa7d7d760f88",
      "email": "john@example.com",
      "name": "John Doe",
      "type": "customer",
      ...
    }
  ],
  "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
}

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de consulta

limitintegerquerydefault:10

A limit on the number of objects to be returned, between 1 and 100.

Rango requerido: 1 <= x <= 100
Ejemplo: 10
cursorstringquery

An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page of results.

Maximum string length: 512
Ejemplo: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
contactTypeenum<string>querydefault:customer

Filter contacts by type. Defaults to "customer".

Opciones disponibles: customer, lead, all
Ejemplo: customer

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

data(object | null)[]obligatorio

Array of contacts

nextCursorstring | nullobligatorio

Cursor for fetching the next page (cursor-based pagination)

Ejemplo: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: list
Ejemplo: list

¿Aún necesitas ayuda? Pregunta al equipo