---
title: "List contacts"
method: GET
path: "/api/{cloudId}/v1/users/contacts"
tags: ["Contacts"]
---

# List contacts

`GET /api/{cloudId}/v1/users/contacts`

Returns the list of the contacts of a user.

## Query parameters

- `offset` integer
- `size` integer
- `targetAccountId` string

## Response `200`

Returned if the request is successful.

- PaginatedResponseContactWithApplyOrderResponse
  - `values` ContactWithApplyOrderResponse[]
    - `id` string — The id of the contact.
    - `method` 'email' | 'sms' | 'voice' | 'mobile' — The method of the contact.
    - `to` string — The contact address.
    - `status` ContactStatus
      - `enabled` boolean — The status of the contact.
      - `disabledReason` string — The reason why the contact is deactivated.
    - `applyOrder` integer
  - `links` CustomRolesLinks
    - `next` string
    - `first` string
    - `last` string

## Other responses

- `401` — Returned if the user is not authorized to do the operation.
- `404` — Returned if the user with the identifier cannot be found.
- `422` — Returned if an field is not properly set.

---

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