curl --request POST \
--url https://api.monaco.com/v1/contacts/list \
--header 'Content-Type: application/json' \
--data '
{
"filters": [
{
"field": "email",
"condition": "equals",
"value": "jane@acme.com"
}
],
"page_size": 1
}
'{
"data": [
{
"id": "con_abc123",
"account_id": "acc_def456",
"account_name": "Acme Corp",
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@acme.com",
"title": "VP of Engineering",
"phone_number": "+1-415-555-0132",
"linkedin_url": "https://linkedin.com/in/janesmith",
"location": "San Francisco, CA",
"source": "api",
"do_not_contact": false,
"notes": "Met at SaaStr 2025",
"scoring": {
"heat_score": "Hot"
},
"tags": [
"Decision Maker"
],
"created_at": "2025-06-15T10:30:00Z",
"updated_at": "2025-06-16T10:30:00Z"
}
],
"pagination": {
"page": 1,
"page_size": 50,
"total_count": 87,
"total_pages": 2
},
"meta": {
"timestamp": "2026-04-21T12:00:00Z"
}
}{
"error": {
"code": "not_found",
"message": "Resource not found"
}
}Contacts
List Contacts
Returns a paginated list of contacts.
Custom fields — list items omit custom_field_<uuid> keys by default. Pass include_custom_fields: true to include them; GET /v1/contacts/ always returns them.
POST
/
v1
/
contacts
/
list
curl --request POST \
--url https://api.monaco.com/v1/contacts/list \
--header 'Content-Type: application/json' \
--data '
{
"filters": [
{
"field": "email",
"condition": "equals",
"value": "jane@acme.com"
}
],
"page_size": 1
}
'{
"data": [
{
"id": "con_abc123",
"account_id": "acc_def456",
"account_name": "Acme Corp",
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@acme.com",
"title": "VP of Engineering",
"phone_number": "+1-415-555-0132",
"linkedin_url": "https://linkedin.com/in/janesmith",
"location": "San Francisco, CA",
"source": "api",
"do_not_contact": false,
"notes": "Met at SaaStr 2025",
"scoring": {
"heat_score": "Hot"
},
"tags": [
"Decision Maker"
],
"created_at": "2025-06-15T10:30:00Z",
"updated_at": "2025-06-16T10:30:00Z"
}
],
"pagination": {
"page": 1,
"page_size": 50,
"total_count": 87,
"total_pages": 2
},
"meta": {
"timestamp": "2026-04-21T12:00:00Z"
}
}{
"error": {
"code": "not_found",
"message": "Resource not found"
}
}Body
application/json
- FilterRule · object[]
- FilterExpression · object
Show child attributes
Show child attributes
Page number (1-indexed)
Required range:
x >= 1Example:
1
Number of results per page
Required range:
1 <= x <= 500Example:
25
Field to sort by. Prefix with '-' for descending order.
Example:
"-created_at"
Whether to include custom fields on each returned contact. Defaults to false. Set true to include custom_field_<uuid> keys on each returned contact; GET /v1/contacts/{contact_id} always returns them.