Get organization

Organizations API v1

Warning

The v1 API has been deprecated. The v1 API will be supported for the foreseeable future, at least until July 2023. However, new features will only be added to the v2 API.

The documentation for retrieving organizations in the new v2 API can be found here. For more information on the v2 API, refer to our v2 migration guide.

GEThttps://api.mollie.com/v1/organizations/*id*
Authentication:App access tokens

Organizations reflect the legal entities associated with the Mollie account. Payments, Refunds, Profiles, Settlements, all belong to an Organization, therefore it’s often referred to as Resource Owner. The Organizations resource contains basic information about the legal entity, as well as insight into the activation statuses of payment methods for example. Mollie performs identity verification and business intent validation before accepting organizations and transferring payments to them, in order to protect buyers.

Parameters

Replace id in the endpoint URL by a full organization ID like org_1234567 or use the me alias.

If you are an official Mollie reseller, you can retrieve the organizations that you have signed up.

Response

200 application/json

resourcestring
Indicates the response contains an organization object. Will always contain organization for this endpoint.
idstring
The identifier uniquely referring to this organization, for example org_1234567.
namestring
The organization’s official name.
emailstring
The email address of the organization.
addressstring
The address where the organizations is established.
postalCodestring
The postal code of where the organization is established.
citystring
The name of the city where the organization is established.
countrystring
The name of the country where the organization is established.
countryCodestring
The two-letter code of the country where the organization is established.
registrationTypestring
National or international registration type of the organization’s legal entity.
registrationNumberstring
Registration number of the organization’s legal entity.
registrationDatetimedatetime
Registration date of the organization’s legal entity.
vatNumberstring
The VAT number of the organization, if based in the European Union. The VAT number has been checked with the VIES service by Mollie.
vatRegulationstring
The organization’s VAT regulation, if based in the European Union. Either shifted (VAT is shifted) or dutch (Dutch VAT rate).
verifiedDatetimedatetime
Date on which Mollie’s verification of this organization completed successfully.

Example

Request

1
2
curl -X GET https://api.mollie.com/v1/organizations/org_1234567 \
    -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
HTTP/1.1 200 OK
Content-Type: application/json

{
    "resource": "organization",
    "id": "org_1234567",
    "name": "Mollie B.V.",
    "email": "info@mollie.com",
    "address": "Keizersgracht 126",
    "postalCode": "1015CW",
    "city": "Amsterdam",
    "country": "Netherlands",
    "countryCode": "NL",
    "registrationType": "bv",
    "registrationNumber": "30204462",
    "registrationDatetime": "2004-04-01T09:41:00.0Z",
    "vatNumber": "NL123456789B01",
    "verifiedDatetime": "2007-06-29T09:41:00.0Z"
}