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

# Get the list of groups

`GET /v2/crm/groups`

## Request

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

This endpoint allows API users to get the list of contact groups.

## Response `200`

List of contact groups.

- object
  - `data` object[]: List of contact groups.
    - `id` string: ID of the group.
    - `name` string: Name of the group.
    - `created_at` integer: Unix timestamp of when the group was created.
    - `updated_at` integer: Unix timestamp of the last update.
  - `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 `name` filter parameter type. * Request with invalid type of `name` 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).
- `404`: Contact does not exist 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)