---
title: "GET /v2/contacts"
method: GET
path: "/v2/contacts"
tags: ["contacts"]
---

# GET /v2/contacts

`GET /v2/contacts`

Returns contacts list for current user according to given params

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `X-Caliopen-PI` string, required
- `X-Caliopen-IL` string, required

## Response `200`

Contacts list

- object
  - `total` integer — number of contacts found for current user for the given parameters
  - `contacts` object[]
    - `additional_name` string
    - `addresses` object[]
      - `address_id` string
      - `city` string, required
      - `country` string
      - `is_primary` boolean
      - `label` string
      - `postal_code` string
      - `region` string
      - `street` string
      - `type` string
    - `avatar` string
    - `contact_id` string, required
    - `date_insert` string, date-time
    - `date_update` string, date-time
    - `deleted` string, date-time
    - `emails` object[]
      - `email_id` string
      - `address` string, required
      - `is_primary` boolean
      - `label` string
      - `type` string
    - `family_name` string
    - `given_name` string
    - `groups` string[]
    - `identities` object[]
      - `social_id` string
      - `infos` object
      - `name` string, required
      - `type` string
    - `ims` object[]
      - `im_id` string
      - `address` string, required
      - `is_primary` boolean
      - `label` string
      - `protocol` string
      - `type` string
    - `infos` object
    - `name_prefix` string
    - `name_suffix` string
    - `organizations` object[]
      - `deleted` boolean
      - `organization_id` string
      - `department` string
      - `is_primary` boolean
      - `job_description` string
      - `label` string
      - `name` string, required
      - `title` string
      - `type` string
    - `phones` object[]
      - `phone_id` string
      - `normalized_number` string
      - `is_primary` boolean
      - `number` string, required
      - `type` string
      - `uri` string
    - `pi` object
      - `technic` integer
      - `context` integer
      - `comportment` integer
      - `version` integer
    - `privacy_features` object
    - `public_keys` object[]
      - `privacy_features` object
      - `pi` object
        - `technic` integer
        - `context` integer
        - `comportment` integer
        - `version` integer
      - `date_insert` string, date-time
      - `date_update` string, date-time
      - `contact_id` string
      - `type` string
      - `user_id` string
      - `expire_date` string, date-time
      - `fingerprint` string
      - `key` string, required
      - `name` string, required
      - `size` integer
    - `tags` string[]
    - `title` string
    - `user_id` string, required

## Changes

- **2018-04-25** `55efa6cbf8cf` — 1 warning
  - deleted the `query` request parameter `uri`

[Change history](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api/changes/v2/contacts/get.md)

---

[API](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.dev/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/55efa6cbf8cf/schema)