> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qonto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/business-api/clients/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](/api-reference/business-api/clients/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](/api-reference/business-api/clients/create-a-client)     |
| `update_client` | Patch one client by UUID. Switching `kind` enforces upstream invariants (clears `vat_number` for individuals, etc.).                                   | [Update a client](/api-reference/business-api/clients/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](/api-reference/business-api/clients/delete-a-client)     |

**Try it**

> Add ACME GmbH (DE123456789) as a company client based in Berlin.
>
> Update [john@example.com](mailto:john@example.com)'s billing address to 12 rue de Rivoli, Paris.
>
> Delete the duplicate "Acme" client.

## Related

* To bill a client, see [Invoices and billing](/mcp/tools/invoices).