Clients

Manage the customers you bill from Qonto

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 [e-mail]’s billing address to 12 rue de Rivoli, Paris.

Delete the duplicate “Acme” client.

Related

• To bill a client, see Invoices and billing.