---
title: "Get contacts from group"
url: "https://docs.signnow.com/docs/contact-groups/operations/get-v2-crm-groups-group_id-contacts"
type: "endpoint"
section: "contact-groups"
slug: "contact-groups/operations/get-v2-crm-groups-group_id-contacts"
method: "GET"
path: "/v2/crm/groups/{group_id}/contacts"
operation_id: "get-v2-crm-groups-group_id-contacts"
authorization: "bearer"
---

# Get contacts from group

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

Allows users to retrieve contacts from the group.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `group_id` | string | Yes | ID of the group |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `sort` | string | No | Format: `sort[last_interaction_at]="desc"`. Allowed values: `asc` for ascending order, `desc` for descending order. |
| `filter:owners` | string | No | Format: `filters=[{"owners":{"type":IN,"value":["e6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"]}}] |
| `filters:shared_with_me` | string | No | Format: `filters=[{"shared_with_me":{"type":"=","value":"true"}}]` |
| `combined filter with `OR` for email `first_name` and `last_name` and `full_name`` | string | No | Format: `filters=[{"_OR":[{"email":{"type":"like","value":"%value%"}},{"first_name":{"type":"like","value":"%value%"}},{"last_name":{"type":"like","value":"%value%"}},{"full_name":{"type":"like","value":"%value%"}}]}]` |
| `combined filter with `OR`` | string | No | Format: `filters=[{"_OR":[{"interaction":{"type":">","value":1652965774}},{"company":{"type":"=","value":"Best company"}}]}]` |
| `combined filter` | string | No | Format: `filters=[{"interaction":{"type":">","value":1652918152}, "company":{"type":"=","value":"Best company"}}]` |
| `filters:interaction_before` | string | No | Filter by interaction before. Format: `filters=[{"interaction":{"type":"<","value":1652918152}}]` |
| `filters:interaction_after` | string | No | Filter by interaction after. Format: `filters=[{"interaction":{"type":">","value":1652918152}}]` |
| `filters:not_company` | string | No | Filter out users without a company. Format: `filters=[{"company":{"type":"!=","value":"Best company"}}]` |
| `filters:company` | string | No | Filter by company. Format: `filters=[{"company":{"type":"=","value":"Best company"}}]` |
| `filters:full_name` | string | No | Filter by contact last name. Format: `filters=[{"full_name":{"type":"like","value":"value"}}]` |
| `filters:last_name` | string | No | Filter by contact last name. Format: `filters=[{"last_name":{"type":"like","value":"value"}}]` |
| `filters:first_name` | string | No | Filter by contact first name. Format: `filters=[{"first_name":{"type":"like","value":"value"}}]` |
| `filters:email ` | string | No | Filter by email. Format: `filters=[{"email":{"type":"=","value":"crm@email.com"}}]` |
| `per_page` | string | No | How many search items to view per page. Allowed values: positive integers from 1 to 100. |
| `page` | string | No | How many pages to fit the results in. Allowed values: any positive integer starting from 1. |

## Responses

### 200

Success

**Example** (`Example 1`)

```json
{
  "data": [
    {
      "id": "8fXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "meta": {
        "created_at": 1649926419,
        "updated_at": 1649926419,
        "interacted_at": 1649926419
      },
      "email": "crm@email.com",
      "phone": {
        "number": "1234567890",
        "country_code": "US"
      },
      "address": {
        "city": "New York",
        "state": "New York",
        "street": "5 Avenue",
        "country": "US",
        "zip_code": "0",
        "apartment": "Penthouse"
      },
      "company": {
        "name": "SignNow",
        "job_title": "PHP Developer"
      },
      "last_name": "Doe",
      "first_name": "John",
      "description": "Best client"
    }
  ],
  "meta": {
    "pagination": {
      "count": 10,
      "links": {
        "next": "https://https://example.com/v2/crm/groups/group_id/contacts?per_page=10&page=3",
        "previous": "https://https://example.com/v2/crm/groups/group_id/contacts?per_page=10&page=1"
      },
      "total": 50,
      "per_page": 15,
      "total_pages": 5,
      "current_page": 2
    }
  }
}
```

### 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

**Example** (`Invalid sort value`)

```json
{
  "code": 27400906,
  "message": "The `sort` key must be one of the following values:` created_at`, `full_name`, `company_name`, `email`, `last_interaction_at`"
}
```

**Example** (`Authorization issues`)

```json
{
  "code": 1537,
  "message": "invalid_token"
}
```

**Example** (`Invalid filter format`)

```json
{
  "code": 0,
  "message": "Wrong filters format."
}
```

**Example** (`Invalid `sort` order value`)

```json
{
  "code": 27400907,
  "message": "The `sort` value must be one of the following values: `asc, desc`"
}
```

**Example** (`Incorrect `page` parameter type`)

```json
{
  "code": 27400904,
  "message": "Query parameter `page` must be a digit"
}
```

**Example** (`Request with `page` less than 0`)

```json
{
  "code": 27400905,
  "message": "Query parameter `page` must be more than 0"
}
```

**Example** (`Invalid type of email filter value`)

```json
{
  "code": 27400054,
  "message": "The `email` filter value should be of type string"
}
```

**Example** (`Invalid type of owners filter type`)

```json
{
  "code": 274001152,
  "message": "The `owners` filter value should be of type string"
}
```

**Example** (`Incorrect `per_page` parameter type`)

```json
{
  "code": 27400901,
  "message": "Query parameter `per_page` must be a digit"
}
```

**Example** (`Invalid type of owners filter value`)

```json
{
  "code": 27400153,
  "message": "The `owners` contains invalid unique_id (\"123\")"
}
```

**Example** (`Request with `per_page` less than 0`)

```json
{
  "code": 27400902,
  "message": "Query parameter `per_page` must be more than 0"
}
```

**Example** (`Invalid sort format (expected array)`)

```json
{
  "code": 0,
  "message": "Expected array, but got {{ type }}: {{ value }}"
}
```

**Example** (`Invalid type of company filter value`)

```json
{
  "code": 27400062,
  "message": "The `company` filter value should be of type string"
}
```

**Example** (`Request with `per_page` more than 100`)

```json
{
  "code": 27400903,
  "message": "Query parameter `per_page` must be less than or equal 100"
}
```

**Example** (`Invalid data type of the `type` filter`)

```json
{
  "code": 27400052,
  "message": "Invalid filter format, filter `type` should be string"
}
```

**Example** (`Invalid expression of email filter type`)

```json
{
  "code": 27400053,
  "message": "The `email` filter expression should be `=` or `like`"
}
```

**Example** (`Invalid type of `full_name` filter value`)

```json
{
  "code": 27400060,
  "message": "The `full_name` filter value should be of type string"
}
```

**Example** (`Invalid type of `last_name` filter value`)

```json
{
  "code": 27400058,
  "message": "The `last_name` filter value should be of type string"
}
```

**Example** (`Invalid type of interaction filter value`)

```json
{
  "code": 27400064,
  "message": "The `interaction` filter value should be of type integer and contain not more than 10 characters"
}
```

**Example** (`Invalid expression of company filter type`)

```json
{
  "code": 27400061,
  "message": "The `company` filter expression should be one of `=`, `!=`, `like"
}
```

**Example** (`Invalid type of `first_name` filter value`)

```json
{
  "code": 27400056,
  "message": "The `first_name` filter value should be of type string"
}
```

**Example** (`Invalid expression of `owners` filter type`)

```json
{
  "code": 27400151,
  "message": "The `owners` filter expression should be `in`"
}
```

**Example** (`Invalid type of shared_with_me filter type`)

```json
{
  "code": 27400066,
  "message": "The `shared_with_me` filter value should be of type string"
}
```

**Example** (`Invalid `sort` format (more than one field)`)

```json
{
  "code": 27400908,
  "message": "The `sort` must contain only one field for sorting"
}
```

**Example** (`Invalid expression of full_name filter type`)

```json
{
  "code": 27400059,
  "message": "The `full_name` filter expression should be equal to `like`"
}
```

**Example** (`Invalid type of shared_with_me filter value`)

```json
{
  "code": 27400067,
  "message": "The `shared_with_me` filter value should be `true` or `false`"
}
```

**Example** (`Invalid expression of `last_name` filter type`)

```json
{
  "code": 27400057,
  "message": "The `last_name` filter expression should be equal to `like`"
}
```

**Example** (`Invalid expression of interaction filter type`)

```json
{
  "code": 27400063,
  "message": "The `interaction` filter expression should be `<` or `>`"
}
```

**Example** (`Invalid expression of `first_name` filter type`)

```json
{
  "code": 27400055,
  "message": "The `first_name` filter expression should be equal to `like`"
}
```

**Example** (`Invalid expression of shared_with_me filter type`)

```json
{
  "code": 27400065,
  "message": "The `shared_with_me` filter expression should be `=`"
}
```

**Example** (`Request without `filter` parameters value or type`)

```json
{
  "code": 27400051,
  "message": "Invalid filter format, filter must have `type` and `value` fields"
}
```

### 404

Contact group not found or does not belong to authorized user

**Example** (`Contact group not found or does not belong to authorized user`)

```json
{
  "code": 27404001,
  "message": "Contact `contactUniqueId` not found"
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/v2/crm/groups/{group_id}/contacts" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/contact-groups/operations/get-v2-crm-groups-group_id-contacts*