---
title: "Get the list of CRM contacts"
method: GET
path: "/v2/crm/contacts"
---

# Get the list of CRM contacts

`GET /v2/crm/contacts`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/crm/contacts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/crm/contacts/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get the list of CRM contacts available to the user.

## Response `200`

List of contacts available to the user.

- object
  - `data` object[]: List of contacts.
    - `id` string: ID of the contact.
    - `meta` object: Timestamps of the contact.
      - `created_at` integer: Unix timestamp of when the contact was created.
      - `updated_at` integer: Unix timestamp of the last update.
      - `interacted_at` integer: Unix timestamp of the last interaction with the contact.
    - `email` string: Email address of the contact.
    - `phone` object: Phone number of the contact.
      - `number` string: Phone number.
      - `country_code` string: Two-letter country code of the phone number, for example `US`.
    - `address` object: Address of the contact.
      - `city` string: City.
      - `state` string: State or region.
      - `street` string: Street.
      - `country` string: Two-letter country code.
      - `zip_code` string: ZIP or postal code.
      - `apartment` string: Apartment.
    - `company` object: Company details of the contact.
      - `name` string: Company name.
      - `job_title` string: Job title.
    - `last_name` string: Last name of the contact.
    - `first_name` string: First name of the contact.
    - `description` string: Notes about the contact.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination information for the result set.
      - `count` integer: Number of items on the current page.
      - `links` object: Links to the adjacent pages. An empty array when there are no other pages; otherwise an object with `next` and/or `previous` URLs.
      - `total` integer: Total number of items.
      - `per_page` integer: Maximum number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Wrong, expired, or missing token. * Request with incorrect per_page parameter type. * Request with incorrect per_page parameter value. * Request with incorrect page parameter type. * Request with incorrect page parameter value. * Request without filter parameters value or type. * Request with invalid type of filter parameter type. * Request with invalid expression of email filter parameter type. * Request with invalid type of email filter parameter value. * Request with invalid expression of first_name filter parameter type. * Request with invalid type of first_name filter parameter value. * Request with invalid expression of last_name filter parameter type. * Request with invalid type of last_name filter parameter value. * Request with invalid expression of full_name filter parameter type. * Request with invalid type of full_name filter parameter value. * Request with invalid expression of company filter parameter type. * Request with invalid type of company filter parameter value. * Request with invalid expression of interaction filter parameter type. * Request with invalid type of interaction filter parameter value. * Request with invalid filter format. * Request with invalid sort value. * Request with invalid sort direction value. * Request with invalid sort format. * Request with invalid expression of shared_with_me filter parameter type. * Request with invalid type of shared_with_me filter parameter type. * Request with invalid type of shared_with_me filter parameter value. * Request with invalid expression of owners filter parameter type. * Request with invalid type of owners filter parameter type. * Request with invalid type of owners filter parameter value.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)