--- title: "Get client's details" method: GET path: "/v2/clients/{id}" tags: ["Clients"] --- # Get client's details `GET /v2/clients/{id}` OAuth scope: `client.read` --- Get information about a client that constitutes the addressee of client invoices for a particular organization by client id. See further details below. --- Price plans: this endpoint is available for all Qonto price plans --- The response contains the attributes of the client entered in the request, along with additional fields that are computed by Qonto, including the associated client id. ## Path parameters - `id` string, uuid, required ## Headers - `X-Qonto-Staging-Token` string ## Response `200` Retrieve details about a client - object - `client` union, required - ClientCompany - `id` string, uuid - `name` string — represents the name of the client that needs to pay the client invoice. - `type` 'company' — describes the client type. `individual` represents a physical person (a consumer) whereas `company` or `freelancer` represent a legal entity. Usually a `freelancer` is a legal entity with the name of a person. - `email` string, email — represents the e-mail address of the client that needs to pay the invoice, which is displayed in the invoice. - `vat_number` string — represents the Value Added Tax number of the client (a legal entity) that needs to pay the invoice. - `tax_identification_number` string — represents the Tax Identification Number of the client (a physical person) that needs to pay the invoice. It corresponds to the SIREN/SIRET for 🇫🇷 companies. - `address` string — represents the address of the client that needs to pay the invoice. - `city` string — represents the city of the client that needs to pay the invoice. - `zip_code` string — represents the zip code of the client that needs to pay the invoice. - `province_code` string — Only for italian organizations. Represents the province code of the client. - `country_code` string — represents the country code of the client that needs to pay the invoice. - `billing_address` object — represents the billing address of the client that needs to pay the invoice. Stores the same data as the root-level fields address fields (`address`, `city`, `zip_code`, `province_code`, `country_code`). - `street_address` string — represent the street address section of the billing address of the client. (eg street, number, floor, door, etc) - `city` string — represents the city on the billing address of the client that needs to pay the invoice - `zip_code` string — represents the zip code on the billing address of the client that needs to pay the invoice - `province_code` string — represents the province code of the client's billing address - `country_code` string — represents the country code on the billing address of the client that needs to pay the invoice - `delivery_address` object — represents the delivery address of the client that needs to pay the invoice. Stores the same data as the root-level fields address fields (`address`, `city`, `zip_code`, `province_code`, `country_code`). - `street_address` string — represent the street address section of the delivery address of the client. (eg street, number, floor, door, etc) - `city` string — represents the city on the delivery address of the client that needs to pay the invoice - `zip_code` string — represents the zip code on the delivery address of the client that needs to pay the invoice - `province_code` string — represents the province code of the client's delivery address that needs to pay the invoice - `country_code` string — represents the country code on the delivery address of the client that needs to pay the invoice - `recipient_code` string — Only for italian clients. Represents the client’s recipient code for receiving an the e-invoice in his SdI portal. - `created_at` string — represents the date the client was created. Note that this is a machine date. - `locale` string — represents the language of the documents created on Qonto (invoices, quotes, credit notes) for this particular client. - ClientIndividual - `id` string, uuid - `first_name` string — represents the first name of the client that needs to pay the invoice. - `last_name` string — represents the last name of the client that needs to pay the invoice - `type` 'individual' | 'freelancer' — describes the client type. `individual` represents a physical person (a consumer) whereas `company` or `freelancer` represent a legal entity. Usually a `freelancer` is a legal entity with the name of a person. - `email` string, email — represents the e-mail address of the client that needs to pay the invoice, which is displayed in the invoice. - `vat_number` string — represents the Value Added Tax number of the client (a legal entity) that needs to pay the invoice. - `tax_identification_number` string — represents the Tax Identification Number of the client (a physical person) that needs to pay the invoice. It corresponds to the SIREN/SIRET for 🇫🇷 companies. - `address` string — represents the address of the client that needs to pay the invoice. - `city` string — represents the city of the client that needs to pay the invoice. - `zip_code` string — represents the zip code of the client that needs to pay the invoice. - `province_code` string — Only for italian organizations. Represents the province code of the client. - `country_code` string — represents the country code of the client that needs to pay the invoice. - `billing_address` object — represents the billing address of the client that needs to pay the invoice. Stores the same data as the root-level fields address fields (`address`, `city`, `zip_code`, `province_code`, `country_code`). - `street_address` string — represent the street address section of the billing address of the client. (eg street, number, floor, door, etc) - `city` string — represents the city on the billing address of the client that needs to pay the invoice - `zip_code` string — represents the zip code on the billing address of the client that needs to pay the invoice - `province_code` string — represents the province code of the client's billing address - `country_code` string — represents the country code on the billing address of the client that needs to pay the invoice - `delivery_address` object — represents the delivery address of the client that needs to pay the invoice. Stores the same data as the root-level fields address fields (`address`, `city`, `zip_code`, `province_code`, `country_code`). - `street_address` string — represent the street address section of the delivery address of the client. (eg street, number, floor, door, etc) - `city` string — represents the city on the delivery address of the client that needs to pay the invoice - `zip_code` string — represents the zip code on the delivery address of the client that needs to pay the invoice - `province_code` string — represents the province code of the client's delivery address that needs to pay the invoice - `country_code` string — represents the country code on the delivery address of the client that needs to pay the invoice - `recipient_code` string — Only for italian clients. Represents the client’s recipient code for receiving an the e-invoice in his SdI portal. - `created_at` string — represents the date the client was created. Note that this is a machine date. - `locale` string — represents the language of the documents created on Qonto (invoices, quotes, credit notes) for this particular client. ## Other responses - `400` — Bad request error - `401` — Unauthorized error - `403` — Forbidden error - `404` — Not found - `422` — Unprocessable content Error - `500` — Internal Server Error --- [API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)