Skip to main content
GET
/
contacts
List contacts
curl --request GET \
  --url https://api.quo.com/contacts \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'
{
  "data": [
    {
      "id": "6a145ff26212a192852c856e",
      "createdAt": "2021-01-01T00:00:00Z",
      "updatedAt": "2021-01-01T00:00:00Z",
      "actorId": "US123abc",
      "externalId": "1234567890",
      "source": "public-api",
      "sourceUrl": "https://example.com/contacts/001",
      "firstName": "John",
      "lastName": "Doe",
      "company": "Quo",
      "role": "admin"
    }
  ],
  "nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}
{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"trace": "6897907457496870895"
}
{
"message": "The contact was not found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}
{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}
{
"message": "User is unauthorized to perform this action",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}
{
"message": "An unknown error has occurred",
"docs": "https://quo.com/docs",
"title": "Unknown Error",
"trace": "6897907457496870895"
}

Authorizations

Authorization
string
header
required

Headers

Quo-Api-Version
enum<string>
required

API version header. Supported values: 2026-03-30

Available options:
2026-03-30

Query Parameters

externalIds
string[] | null

Filter by external IDs

Maximum array length: 50
sources
string[] | null

Filter by source labels

Maximum array length: 50
limit
integer | null
default:10

Page size

Required range: 1 <= x <= 50
after
string | null
Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

Response

OK

data
object[]
required
nextCursor
string | null
required

Cursor for the next page, or null when there are no more pages.

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"