---
title: "Retrieve all contacts"
method: GET
path: "/consumers/{consumer_id}/invoicing/contacts"
tags: ["Invoicing", "Contacts"]
---

# Retrieve all contacts

`GET /consumers/{consumer_id}/invoicing/contacts`

Returns a list of all the contacts. Optionally contact type can be defined to retrieve contact from a certain type.

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `contact_type` 'prospect' | 'customer' | 'supplier' | 'all'

## Response `200`

Successful Response

- ChiftPageContactItemOut
  - `items` ContactItemOut[], required
    - `id` string, required — Technical id in Chift
    - `source_ref` Ref, required
      - `id` string, nullable — Technical id in the target software
      - `model` string, nullable — Name of the model/entity in the target software
    - `is_prospect` boolean, nullable — Is a prospect?
    - `is_customer` boolean, nullable — Is a customer?
    - `is_supplier` boolean, nullable — Is a supplier?
    - `is_company` boolean, nullable — Is a company?
    - `company_name` string, nullable — Name of the company
    - `first_name` string, nullable — Firstname
    - `last_name` string, nullable — Lastname
    - `email` string, nullable — Email
    - `phone` string, nullable — Phone
    - `mobile` string, nullable — Mobile
    - `company_id` string, nullable — Technical id of the contact' company in Chift
    - `vat` string, nullable — VAT number
    - `company_number` string, nullable — Company number (identification number different than the VAT (e.g. siret))
    - `currency` string, nullable — Currency matching target sofware name
    - `language` string, nullable — Language matching target sofware name
    - `comment` string, nullable — Comment
    - `customer_account_number` string, nullable — Number of the accounting account used for sales (e.g. 701000)
    - `supplier_account_number` string, nullable — Number of the accounting account used for purchases (e.g. 601000)
    - `birthdate` string, date, nullable — Birthdate
    - `gender` 'H' | 'F' | 'N/A'
    - `addresses` AddressItemOutInvoicing[], nullable — Addresses
      - `address_type` 'main' | 'delivery' | 'invoice' | 'other', required
      - `name` string, nullable
      - `number` string, nullable
      - `box` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `email` string, nullable
      - `street` string, nullable
      - `city` string, nullable
      - `postal_code` string, nullable
      - `country` string, nullable — Format: ISO 3166-1 codes.
    - `external_reference` string, nullable — External reference of the contact in the invoicing system
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

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