Clients

Clients are the external counterparties you invoice from Qonto: companies, individuals, or freelancers. They are referenced by id when creating client invoices, quotes, and credit notes.

Tool	What it does	Upstream
`list_clients`	Paginated list of clients. The `filter` query supports `tax_identification_number`, `vat_number`, `email`, and `name`.	List clients
`get_client`	Fetch one client by UUID. Returns identity (kind / type, name or first_name + last_name, email, phone, currency, locale), addresses, and tax fields.	Retrieve a client
`create_client`	Create a client. Body is discriminated on `kind`: `individual` and `freelancer` need first + last name; `company` needs `name`.	Create a client
`update_client`	Patch one client by UUID. Switching `kind` enforces upstream invariants (clears `vat_number` for individuals, etc.).	Update a client
`delete_client`	Permanent delete. Recurring invoices on the client are auto-canceled; issued invoices keep displaying the client’s information.	Delete a client

Try it

Add ACME GmbH (DE123456789) as a company client based in Berlin. Update john@example.com’s billing address to 12 rue de Rivoli, Paris. Delete the duplicate “Acme” client.

To bill a client, see Invoices and billing.

Cash flow categories Invoices and billing

⌘I

Install

Tools

​Related

Related