Get organization¶
Organizations API v2
GET
https://api.mollie.com/v2/organizations/*id*
Authentication:Organization access tokensApp access tokens
Retrieve an organization by its ID.
Note
You can only retrieve organizations that the authenticated organization is connected to.
Parameters¶
No parameters applicable for this endpoint.
Response¶
200
application/hal+json
resource
string
Indicates the response contains a method object. Will always contain
organization
for this endpoint.id
string
The unique identifier of the organization method.
name
string
The name of the organization.
locale
string
The preferred locale of the merchant which has been set in Mollie Dashboard.
address
address object
The address of the organization.
registrationNumber
string
The registration number of the organization at the (local) chamber of commerce.
vatNumber
stringoptional
The VAT number of the organization, if based in the European Union. The VAT number has been checked with the
VIES service by Mollie.
vatRegulation
stringoptional
The organization’s VAT regulation, if based in the European Union. Either
shifted
(VAT is shifted) or dutch
(Dutch VAT rate)._links
objectAn object with several URL objects relevant to the organization. Every URL object will contain an href
and a
type
field.
self
URL object
The API resource URL of the organization itself.
dashboard
URL object
Direct link to the organization’s Mollie Dashboard.
documentation
URL object
The URL to the payment method retrieval endpoint documentation.
Example¶
cURLPHPPythonRubyNode.js
1 2 | curl -X GET https://api.mollie.com/v2/organizations/org_12345678 \ -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ" |
1 2 3 4 | <?php $mollie = new \Mollie\Api\MollieApiClient(); $mollie->setAccessToken("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"); $organization = $mollie->organizations->get("org_12345678"); |
1 2 3 4 5 6 | from mollie.api.client import Client mollie_client = Client() mollie_client.set_access_token("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ") organization = mollie_client.organizations.get("org_12345678") |
1 2 3 4 5 6 7 | require 'mollie-api-ruby' Mollie::Client.configure do |config| config.api_key = 'access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ' end organization = Mollie::Organization.get('org_12345678') |
1 2 3 4 | We don't have a Node.js code example for this API call yet. If you have some time to spare, feel free to share suggestions on our Discord: https://discord.gg/VaTVkXB4aQ |
Response¶
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | HTTP/1.1 200 OK Content-Type: application/hal+json { "resource": "organization", "id": "org_12345678", "name": "Mollie B.V.", "email": "info@mollie.com", "address": { "streetAndNumber": "Keizersgracht 126", "postalCode": "1015 CW", "city": "Amsterdam", "country": "NL" }, "registrationNumber": "30204462", "vatNumber": "NL815839091B01", "_links": { "self": { "href": "https://api.mollie.com/v2/organizations/org_12345678", "type": "application/hal+json" }, "dashboard": { "href": "https://mollie.com/dashboard/org_12345678", "type": "text/html" }, "documentation": { "href": "https://docs.mollie.com/reference/v2/organizations-api/get-organization", "type": "text/html" } } } |