Get organization¶
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.
GET
https://api.mollie.com/v1/organizations/*id*
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
resource
stringorganization
for this endpoint.id
stringorg_1234567
.name
stringemail
stringaddress
stringpostalCode
stringcity
stringcountry
stringcountryCode
stringregistrationType
stringregistrationNumber
stringregistrationDatetime
datetimevatNumber
stringvatRegulation
stringshifted
(VAT is shifted) or dutch
(Dutch VAT rate).verifiedDatetime
datetimeExample¶
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" } |