List clients
OAuth scope: client.read
Retrieves the list of clients for the authenticated organization.
You can filter (ex: only retrieve the latest clients) and sort this list by using query parameters π
Price plans: this endpoint is available for all Qonto price plans.
Authorizations
Bearer authorization header: Bearer <token>
, where <token>
is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Headers
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Query Parameters
Clients can be filtered based on their tax_identification_number
, vat_number
, or email
. The response will return exact and case-insensitive match(es). <br>Clients can also be filtered based on their name
. The response will return exact and partial matches, case-insensitive and accent-insensitive match(es). When type is individual or freelancer, name consists of the concatenation of first_name
& β β & last_name
. The value must at least contain 2 characters minimum.
Returned page (cf. Pagination).
25
Number of clients per page (cf. Pagination).
25
Clients can be sorted by their created_at
/ name
property in 2 possible orders: asc
(Ascending) / desc
(Descending).
created_at:asc
, created_at:desc
, name:asc
, name:desc
Response
The response is of type object
.