---
title: "Get contacts from group"
method: GET
path: "/v2/crm/groups/{group_id}/contacts"
---

# Get contacts from group

`GET /v2/crm/groups/{group_id}/contacts`

## Request

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

This endpoint allows API users to get the contacts in a contact group.

## Response `200`

List of contacts in the group.

- 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`: * Request with any of these cases: invalid token of user, expired token of user, empty header, authorization = null, authorization without value. * Request with incorrect `per_page` parameter type. * Request with `per_page` less than 0. * Request with `per_page` more than 100. * Request with incorrect `page` parameter type. * Request with `page` less than 0. * 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` order value. * Request with invalid `sort` format (expected array). * Request with invalid `sort` format (more than one field for sorting). * 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.
- `404`: Contact group not found or does not belong to authorized user.

---

[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)