# Clients A Client is an entity you send invoices to. ## List Clients - [GET /api/v3/clients](https://docs.invoicexpress.com/v3/clients/listv3clients.md): Returns a paginated list of the clients in the account. Archived clients are included unless status says otherwise. ## Create Client - [POST /api/v3/clients](https://docs.invoicexpress.com/v3/clients/createv3client.md): Creates a new client. ## Get Client Suggestions - [GET /api/v3/clients/suggestions](https://docs.invoicexpress.com/v3/clients/getv3clientsuggestions.md): Returns client suggestions. With client_text, searches the account's clients by that text. Without it, returns the last clients used on documents of the document_tab family (at most 10, most recent first); an empty list when none were recorded. ## Get Client - [GET /api/v3/clients/{id}](https://docs.invoicexpress.com/v3/clients/getv3client.md): Returns a specific client by ID. ## Update Client - [PUT /api/v3/clients/{id}](https://docs.invoicexpress.com/v3/clients/updatev3client.md): Updates an existing client. Partial update — only the keys sent inside client are changed. ## Delete Client - [DELETE /api/v3/clients/{id}](https://docs.invoicexpress.com/v3/clients/deletev3client.md): Deletes a client. ## Archive Client - [PUT /api/v3/clients/{id}/archive](https://docs.invoicexpress.com/v3/clients/archivev3client.md): Archives a client. Archiving hides the client from GET /api/v3/clients?status=active and nothing else: the client can still be read and updated, documents created through the API can still use it, and it still counts when another client is created with the same name or code. Use it for clients that cannot be deleted (can_be_deleted is false), but any client can be archived. No request body. Archiving an archived client succeeds and keeps the original archived_at. ## Unarchive Client - [PUT /api/v3/clients/{id}/unarchive](https://docs.invoicexpress.com/v3/clients/unarchivev3client.md): Unarchives a client, so it is listed again with status=active. No request body. Unarchiving a client that is not archived succeeds and changes nothing. ## Get Client Balance - [GET /api/v3/clients/{id}/balance](https://docs.invoicexpress.com/v3/clients/getv3clientbalance.md): Returns the current account balance for a client. ## Update Client Initial Balance - [PUT /api/v3/clients/{id}/initial_balance](https://docs.invoicexpress.com/v3/clients/updatev3clientinitialbalance.md): Updates the initial balance for a client. ## List Client Regularizations - [GET /api/v3/clients/{client_id}/regularization](https://docs.invoicexpress.com/v3/clients/listv3clientregularizations.md): Returns the client's regularizations, paginated. ## Create Client Regularization - [POST /api/v3/clients/{client_id}/regularization](https://docs.invoicexpress.com/v3/clients/createv3clientregularization.md): Creates a new regularization for a client. ## Delete Client Regularization - [DELETE /api/v3/clients/{client_id}/regularization/{id}](https://docs.invoicexpress.com/v3/clients/deletev3clientregularization.md): Cancels one or more of the client's regularizations. This is a soft cancel (the movements are marked as canceled, not removed). Ids that are not regularizations of this client are skipped. ## Send Open Account Link Mail - [POST /api/v3/clients/{id}/send_open_account_link_mail](https://docs.invoicexpress.com/v3/clients/sendv3clientopenaccountlinkmail.md): Sends an open account link email to a chosen client. ## Create Treasury Movement - [POST /api/v3/clients/{client_id}/treasury_movements](https://docs.invoicexpress.com/v3/clients/createv3clienttreasurymovement.md): Creates a new treasury movement for a client. A Payment settles the client's open documents up to value and issues a receipt for each. A Reimbursement is spread over the client's settled documents (or only document_id when sent). Send an Idempotency-Key header to make retries safe: a repeated request with the same key and payload replays the first answer instead of creating a second movement. ## Delete Treasury Movement - [DELETE /api/v3/clients/{client_id}/treasury_movements/{id}](https://docs.invoicexpress.com/v3/clients/deletev3clienttreasurymovement.md): Cancels a treasury movement of the client (soft cancel; the movement is marked as canceled, not removed). When the movement has child movements, every child is canceled too.