Get organization
Organizations API

GET
https://api.mollie.nl/v1/organizations/id
Authentication: OAuth access tokens

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're an official Mollie Reseller, you can retrieve the organizations that you have signed up.

Includes

Some endpoints allow you to indicate if you want more information to be included in the API response via the include querystring parameter.

  • No includes supported for this endpoint.

Response

200
application/json; charset=utf-8
resource
string

Indicates the response contains a organization object.

Possible values: organization

id
string

The organization's identifier, for example org_1234567.

name
string

The organization's official name.

email
string

The email address of the organization.

address
string

The address where the organizations is established.

postalCode
string

The postal code of where the organization is established.

city
string

The name of the city where the organization is established.

country
string

The name of the country where the organization is established.

countryCode
string

The two-letter code of the country where the organization is established.

registrationType
string

National or international registration type of the organization's legal entity.

registrationNumber
string

Registration number of the organization's legal entity.

registrationDatetime
datetime

Registration date of the organization's legal entity.

verifiedDatetime
datetime

Date on which Mollie's verification of this organization completed successfully.

Example

Request code

require_once 'Mollie/API/Autoloader.php';

try
{
    $mollie = new Mollie_API_Client;
    $mollie->setAccessToken('access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ');

    $organization = $mollie->organizations->get('org_1234567');

    echo $organization->id . ': ' . $organization->name;
}
catch (Mollie_API_Exception $e)
{
    echo "API call failed: " . $e->getMessage();
}

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    resource: "organization",
    id: "org_1234567",
    name: "Mollie B.V.",
    email: "info@mollie.com",
    address: "Keizersgracht 313",
    postalCode: "1016EE",
    city: "Amsterdam",
    country: "Netherlands",
    countryCode: "NL",
    registrationType: "bv",
    registrationNumber: "30204462",
    registrationDatetime: "2004-04-01T09:41:00.0Z",
    verifiedDatetime: "2007-06-29T09:41:00.0Z"
}