List Contacts

GET

/contacts

Retrieve a comprehensive list of all contacts with advanced filters. This operation supports multiple search criteria including contact name, company name, address, email, phone, and general text search. You can filter contacts by status (active, inactive, duplicate, CRM) and sort by various fields. The response includes essential contact information, financial data including outstanding amounts and credit limits, and pagination details for efficient data retrieval.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Scopes:

ZohoBooks.contacts.READ-Read Contacts

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/contacts?contact_type=customer&contact_name=Bowman and Co&company_name=Bowman and Co&first_name=Will&last_name=Smith&address=4900 Hopyard Rd&email=willsmith@bowmanfurniture.com&phone=+1-925-921-9201&filter_by=&search_text=&sort_column=contact_name&zcrm_contact_id=460000000026049&zcrm_account_id=460000000026049&zcrm_vendor_id=460000000026049&page=1&per_page=200'

Response Example

{
    "code": 0,
    "message": "success",
    "contacts": [
        {
            "contact_id": 460000000026049,
            "contact_name": "Bowman and co",
            "company_name": "ABC Studios",
            "contact_type": "customer",
            "status": "active",
            "payment_terms": 0,
            "payment_terms_label": "Due on Receipt",
            "currency_id": "460000000000097",
            "currency_code": "USD",
            "outstanding_receivable_amount": 250,
            "unused_credits_receivable_amount": 1369.66,
            "first_name": "Peter",
            "last_name": "Parker",
            "email": "willsmith@bowmanfurniture.com",
            "phone": "+1-925-921-9201",
            "mobile": "+1-4054439562",
            "created_time": "2016-06-05T02:30:08-0700",
            "last_modified_time": "string"
        }
    ],
    "page_context": {
        "page": 1,
        "per_page": 200,
        "has_more_page": false,
        "applied_filter": "Status.All",
        "sort_column": "created_time",
        "sort_order": "D"
    }
}

Modified at 2025-10-12 16:28:37

Create a Contact

Update a contact using a custom field's unique value