Get organization

Organizations API v2
GEThttps://api.mollie.com/v2/organizations/*id*
Authentication:OAuth access tokens

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; charset=utf-8

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.

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 by Mollie.

_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

Request

1
2
    curl -X GET https://api.mollie.com/v2/organizations/org_12345678 \
    -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
20
21
22
23
24
25
26
27
HTTP/1.1 200 OK
Content-Type: application/hal+json; charset=utf-8

{
     "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"
         }
     }
 }