Skip to main content
GET
List all clients

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Query Parameters

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
per_page
integer
default:50

Number of items per page

Required range: 1 <= x <= 100

Search term for name, email, or CUI

client_type
enum<string>

Filter by client type (b2b = companies, b2c = individuals)

Available options:
b2b,
b2c
sort
enum<string>

Sort field. When omitted, results are ordered by aggregated total_invoiced DESC (the default surface for the client list).

Available options:
name,
created_at,
total_invoiced,
invoices_count
order
enum<string>
default:asc

Sort order (ignored when sort is omitted)

Available options:
asc,
desc

Response

List of clients. Each item includes a metadata block with invoices_count and total_invoiced aggregated across the firm's fiscal invoices (snapshot-aware), so the list view can render totals without a follow-up call.

success
boolean
data
object
meta
object