---
title: "List All Clients"
method: GET
path: "/clients.json"
tags: ["Clients"]
---

# List All Clients

`GET /clients.json`

Returns a list of all your clients.

## Query parameters

- `api_key` string, required
- `page` integer
- `per_page` integer

## Response `200`

SUCCESS

- ClientsListAll
  - `clients` object[]
    - `id` integer
    - `name` string
    - `code` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `email` string, nullable
    - `language` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `address` string, nullable — No enforced character limit (text column).
    - `city` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `postal_code` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `country` string, nullable — Omitted entirely for clients with no country set. Maximum length is the database default, not an enforced business rule.
    - `fiscal_id` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `website` string, nullable
    - `phone` string, nullable
    - `fax` string, nullable
    - `preferred_contact` object — May be an empty object when no preferred contact is set.
      - `name` string, nullable — Contact-level name has no length validation, unlike the client-level `name` (max 100); the limit shown is the database default.
      - `email` string, nullable — Contact-level email allows one character more than the client-level `email` (max 254).
      - `phone` string, nullable — Contact-level phone has no length validation, unlike the client-level `phone` (max 20); the limit shown is the database default.
      - `mobile` string, nullable — Digits only (4-14). Validated against /\A\d{4,14}\z/.
    - `observations` string, nullable — No enforced character limit (text column).
    - `send_options` integer, nullable
  - `pagination` object
    - `total_entries` integer
    - `current_page` integer
    - `total_pages` integer
    - `per_page` integer

## Other responses

- `401` — ACCESS DENIED

---

[API](https://skmtc.dev/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/revisions/5b82d4eb0d9f/schema)