Get organization

Organizations API v2
GEThttps://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

resourcestring
Indicates the response contains a method object. Will always contain organization for this endpoint.
idstring
The unique identifier of the organization method.
namestring
The name of the organization.
emailstring
The email address associated with the organization.
localestring
The preferred locale of the merchant which has been set in Mollie Dashboard.
addressaddress object
The address of the organization.
registrationNumberstring
The registration number of the organization at the (local) chamber of commerce.
vatNumberstringoptional
The VAT number of the organization, if based in the European Union. The VAT number has been checked with the VIES service by Mollie.
vatRegulationstringoptional
The organization’s VAT regulation, if based in the European Union. Either shifted (VAT is shifted) or dutch (Dutch VAT rate).
_linksobject

An object with several URL objects relevant to the organization. Every URL object will contain an href and a type field.

Show child parameters

selfURL object
The API resource URL of the organization itself.
dashboardURL object
Direct link to the organization’s Mollie Dashboard.
documentationURL 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"
        }
    }
}