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

# List contacts

`GET /accounts/self/contacts`

Get user contacts with optional filters, pagination, or retrieve specific contacts by IDs (Permitted scopes: **fax:all:read**)

## Query parameters

- `ids` string
- `name` string
- `fax_number` string
- `groups` string
- `note` string
- `offset` integer
- `limit` integer
- `sort` 'name' | 'creation_date' | 'modification_date'
- `direction` 'asc' | 'desc'
- `shared` boolean

## Response `200`

Response containing a list of contacts

- ContactList
  - `records` Contact[] — List of contacts
    - `id` string — Contact ID
    - `name` string — Contact name
    - `fax_number` string — Contact's fax number
    - `groups` string[] — List of group names
    - `email` string — Contact's email address
    - `cellphone` string — Contact's cellphone number
    - `phone` string — Contact's phone number
    - `notes` string — Additional notes
    - `is_shared` boolean — Whether contact is shared with corporate members
    - `is_telefax` boolean — Whether contact has a human fax operator
    - `creation_date` string — Date contact was created
    - `modification_date` string — Date contact was last modified
  - `total_count` integer — Total number of contacts 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)