Skip to main content
POST
/
v1
/
contacts
/
list
List Contacts
curl --request POST \
  --url https://api.example.com/v1/contacts/list \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "condition": "contains",
      "field": "name",
      "value": "Acme"
    },
    {
      "condition": "is",
      "field": "status",
      "value": "active"
    }
  ],
  "page": 1,
  "page_size": 50,
  "sort": "-created_at"
}
'
{
  "data": [
    {
      "id": "con_abc123",
      "account_id": "acc_def456",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acme.com",
      "title": "VP of Engineering",
      "do_not_contact": false,
      "tags": [
        "Decision Maker"
      ],
      "created_at": "2025-06-15T10:30:00Z",
      "custom_field_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d": "buyer",
      "custom_field_2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e": "2026-04-18"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_count": 87,
    "total_pages": 2
  },
  "meta": {
    "timestamp": "2026-04-21T12:00:00Z"
  }
}

Documentation Index

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

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

Body

application/json
filters
FilterRule · object
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
Example:

1

page_size
integer
default:50

Number of results per page

Required range: 1 <= x <= 500
Example:

25

sort
string
default:-created_at

Field to sort by. Prefix with '-' for descending order.

Example:

"-created_at"

Response

Successful Response

data
ContactResponse · object[]
required
pagination
PaginationInfo · object
required
meta
ResponseMeta · object