---
title: "List clients"
method: GET
path: "/v1/clients"
tags: ["Clients"]
---

# List clients

`GET /v1/clients`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/v1/clients`
- Auth: HTTP bearer

Return the address book of clients this account has sent intakes to. There is no clients table — this is a view over `intakes`, grouped case-insensitively by email, so it knows about every client from before this endpoint existed and can never drift from what was actually sent. `name`, `language`, `phone`, `timezone` and `folder_id` come from that client's most recent intake. Results are ordered by `intake_count` descending, then by `last_intake_at` descending. An API key sees only clients from intakes in its own mode (test/live), exactly like GET /v1/intakes.

## Query parameters

- `q` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of clients

- object
  - `clients` object[], required
    - `email` string, email, required
    - `name` string, nullable, required
    - `language` string, required
    - `phone` string, nullable, required
    - `timezone` string, required
    - `folder_id` string, nullable, required
    - `last_intake_id` string, required
    - `last_intake_at` string, date-time, required
    - `intake_count` integer, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Missing or invalid API key
- `403`: Authenticated but not allowed to perform this action
- `422`: Validation error — the body shape is correct but values are invalid

---

[API](https://skmtc.dev/briefgate/apis/briefgate-api.md) · [All operations](https://skmtc.dev/briefgate/apis/briefgate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/briefgate/apis/briefgate-api/revisions/b21afed4748b?raw)