MOmonaco
Contacts

List Contacts

Changed on

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/{contact_id} always returns them.

post/v1/contacts/list

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/contacts/list
  • Auth
    none declared

Request body

pageinteger

Page number (1-indexed)

page_sizeinteger

Number of results per page

sortstring

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

include_custom_fieldsboolean

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.

Example request

{
  "page": 1,
  "page_size": 25,
  "sort": "-created_at"
}

Response

Successful Response

Example response

{
  "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": "linkedin",
      "notes": "Met at SaaStr 2025",
      "scoring": {
        "heat_score": "Hot"
      },
      "tags": [
        "Interested",
        "Decision Maker"
      ],
      "created_at": "2025-06-15T10:30:00Z",
      "updated_at": "2025-06-15T10:30:00Z",
      "last_activity_at": "2025-06-15T10:30:00Z",
      "last_activity_type": "outbound_email",
      "last_outbound_at": "2025-06-15T10:30:00Z",
      "last_outbound_type": "email",
      "last_inbound_at": "2025-06-15T10:30:00Z",
      "last_inbound_type": "email"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}

Changes

  • fc720ada2a81Revision changes
    • breaking

      removed subschema #1 from the request property anyOf list

    • info

      the request property default value changed from true to false

    • info

      added subschema #1 to the request property oneOf list

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status