Get organization

Organizations API v2
GEThttps://api.mollie.com/v2/organizations/*id*

Retrieve an organization by its ID.

If you do not know the organization’s ID, you can use the organizations list endpoint to retrieve all organizations that are accessible.

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

string
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

string
The organization’s VAT regulation, if based in the European Union. Either shifted (VAT is shifted) or dutch (Dutch VAT rate).

_links

object

An 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.

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
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 Python code example for this API call yet.

If you have some time to spare, feel free to open a pull request at:
https://github.com/mollie/api-documentation
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 open a pull request at:
https://github.com/mollie/api-documentation

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
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 313",
        "postalCode": "1016 EE",
        "city": "Amsterdam",
        "country": "NL"
    },
    "registrationNumber": "30204462",
    "vatNumber": "NL815839091B01",
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/organizations/org_12345678",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/organizations-api/get-organization",
            "type": "text/html"
        }
    }
}