---
title: "List contact groups"
method: GET
path: "/accounts/self/contact-groups"
tags: ["Contacts"]
---

# List contact groups

`GET /accounts/self/contact-groups`

Get contact groups with optional search and pagination. You can also retrieve specific groups by providing comma-separated IDs (Permitted scopes: **fax:all:read**)

## Query parameters

- `ids` string
- `group` string
- `offset` integer
- `limit` integer
- `shared` boolean

## Response `200`

Response containing a list of groups

- ContactGroupList
  - `records` ContactGroup[] — List of groups
    - `id` string — Group ID
    - `name` string — Group name
    - `notes` string — Additional notes or description for the group
    - `is_shared` boolean — Whether group is shared with corporate members
    - `creation_date` string — Date group was created
    - `modification_date` string — Date group was last modified
  - `total_count` integer — Total number of groups matching the query

## Other responses

- `400` — Error object in case there's a problem with given data
- `401` — Error object in case there's a problem with the authorization
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/versions/c1afc85d2c15/schema)