---
title: "List clients"
method: GET
path: "/v3/client-book/client"
tags: ["Client Book"]
---

# List clients

`GET /v3/client-book/client`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/client-book/client`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/client-book/client/get.ts> (a function with typed inputs; its response is checked against the schema)

Paginated clients of the caller's organization. `search` matches name, email or phone (digits only also work). `scope` is `active` (default), `archived` or `all`.

## Query parameters

- `search` string
- `scope` 'active' | 'archived' | 'all'
- `page` integer
- `limit` integer

## Response `200`

{ items, total, page, limit }

## Other responses

- `401`: Unauthorized
- `403`: Access denied

## Changes

- **2026-10-02** `82c79770c36b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/client-book/client/get.md)

---

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