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

# List contacts

`GET /contacts`

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string[]
- `order` 'asc' | 'desc'
- `q[]` string[]

## Response `200`

successful operation

- object
  - `contacts` Contact[]
    - `address_1` string, nullable
    - `address_2` string, nullable
    - `address_3` string, nullable
    - `archived_at` string, date-time, nullable
    - `city` string, nullable
    - `company_name` string, nullable
    - `country` string, nullable
    - `country_code` string, nullable — [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes) country code
    - `created_at` string, date-time
    - `deleted_at` string, date-time, nullable
    - `doctor_type` 'general_practitioner' | 'specialist', nullable
    - `email` string, nullable
    - `first_name` string, nullable
    - `id` string, int64
    - `last_name` string, nullable
    - `links` object
      - `self` string, uri
    - `notes` string, nullable
    - `occupation` string, nullable
    - `phone_numbers` PhoneNumber[], nullable
      - `normalized_number` string, phone
      - `number` string, phone
      - `phone_type` 'Fax' | 'Home' | 'Mobile' | 'Other' | 'Work'
    - `post_code` string, nullable
    - `preferred_name` string, nullable
    - `provider_number` string, nullable
    - `state` string, nullable
    - `title` string, nullable
    - `type` 'Doctor' | '3rd Party Payer' | 'Standard', nullable
    - `type_code` 0 | 1 | 2
    - `updated_at` string, date-time
  - `total_entries` integer
  - `links` object
    - `self` string, uri
    - `previous` string, uri
    - `next` string, uri

---

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