--- title: "Get client" method: GET path: "/v2/clients/{organizationId}" tags: ["Clients API"] --- # Get client `GET /v2/clients/{organizationId}` ## Request - Base URL: `https://api.mollie.com` - URL: `https://api.mollie.com/v2/clients/{organizationId}` - Auth: HTTP bearer Retrieve a single client by its ID. > 🔑 Access with > > [Advanced access token with **clients.read**](/reference/authentication) ## Query parameters - `embed` string, nullable ## Response `200` The client object. - object - `resource` string, required: Indicates the response contains a client object. Will always contain the string `client` for this resource type. - `id` string, required: The identifier uniquely referring to this client. Example: `org_12345678`. - `commission` object, nullable: The commission object. - `count` integer: The commission count. - `organizationCreatedAt` string: The date and time the client organization was created, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field. - `self` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `organization` object: The API resource URL of the client's organization. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `onboarding` object: The API resource URL of the client's onboarding status. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `documentation` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `_embedded` object - `organization` object - `resource` string, required: Indicates the response contains an organization object. Will always contain the string `organization` for this resource type. - `id` string, required - `name` string, required: The name of the organization. - `email` string, required: The email address associated with the organization. If the domain contains non-ASCII characters, encode it as Punycode per [RFC 3492](https://www.rfc-editor.org/rfc/rfc3492). - `locale` string, nullable, required: Sets the language for customer-facing content and communications. Possible values: `ca_ES` `cs_CZ` `da_DK` `de_AT` `de_CH` `de_DE` `de_LU` `el_GR` `en_BE` `en_GB` `en_NL` `en_US` `es_ES` `fi_FI` `fr_BE` `fr_FR` `fr_LU` `hu_HU` `is_IS` `it_IT` `lt_LT` `lv_LV` `nb_NO` `nl_BE` `nl_NL` `pl_PL` `pt_PT` `sk_SK` `sl_SI` `sv_SE` `tr_TR` - `address` object: The address of the organization. - `streetAndNumber` string, required: A street and street number. - `postalCode` string, required: A postal code. This field may be required if the provided country has a postal code system. - `city` string, required - `country` string, required: A country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. - `registrationNumber` string, nullable: The registration number of the organization at their local chamber of commerce. - `vatNumber` string, nullable: The VAT number of the organization, if based in the European Union or in The United Kingdom. VAT numbers are verified against the international registry *VIES*. The field is not present for merchants residing in other countries. - `vatRegulation` string, nullable: Mollie applies Dutch VAT for merchants based in The Netherlands, British VAT for merchants based in The United Kingdom, and shifted VAT for merchants in the European Union. The field is not present for merchants residing in other countries. Possible values: `dutch` `british` `shifted` - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field. - `self` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `dashboard` object: Direct link to the organization's Mollie dashboard. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `documentation` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `onboarding` object - `resource` string, required: Indicates the response contains an onboarding status object. Will always contain the string `onboarding` for this resource type. - `name` string, required: The name of the organization. - `status` string, required: The current status of the organization's onboarding process. Possible values: `needs-data` `in-review` `completed` - `canReceivePayments` boolean, required: Whether the organization can receive payments. - `canReceiveSettlements` boolean, required: Whether the organization can receive settlements to their external bank account. - `signedUpAt` string, required: The sign up date time of the organization in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field. - `self` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `dashboard` object: Direct link to the onboarding process in the Mollie dashboard. The merchant can be redirected to this page to complete their onboarding. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `organization` object: The API resource URL of the organization. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `documentation` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `capabilities` object[] - `resource` string, required: Always the word `capability` for this resource type. - `name` string, required: A unique name for this capability like `payments` / `settlements`. - `status` 'unrequested' | 'enabled' | 'disabled' | 'pending', required - `statusReason` 'requirement-past-due' | 'onboarding-information-needed' | 'null', nullable, required - `requirements` object[], required - `id` string, required: The name of this requirement, referring to the task to be fulfilled by the organization to enable or re-enable the capability. The name is unique among other requirements of the same capability. Examples include `needs-data` and `process-first-payment`. - `status` string, required: The status of the requirement depends on its due date. If no due date is given, the status will be `requested`. Possible values: `currently-due` `past-due` `requested` - `dueDate` string, nullable, required: Due date until the requirement must be fulfilled, if any. The date is shown in ISO-8601 format. - `_links` object, required - `dashboard` object: If known, a deep link to the Mollie dashboard of the client, where the requirement can be fulfilled. For example, where necessary documents are to be uploaded. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. ## Other responses - `404`: No entity with this ID exists. - `429`: Rate Limit has been reached. --- [API](https://skmtc.dev/mollie/apis/mollie-connect.md) - [All operations](https://skmtc.dev/mollie/apis/mollie-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-connect/revisions/65271e79a786?raw)