Get onboarding status

Onboarding API v2
GEThttps://api.mollie.com/v2/onboarding/me

Get the status of onboarding of the authenticated organization.

Parameters

There are no parameters for this endpoint.

Response

200 application/hal+json

resource

string
Indicates the response contains an onboarding object. Will always contain onboarding for this endpoint.

name

string
The name of the organization.

signedUpAt

datetime
The sign up date and time of the organization.

status

string

The current status of the organization’s onboarding process. Possible values:

  • needs-data The onboarding is not completed and the merchant needs to provide (more) information
  • in-review The merchant provided all information and Mollie needs to check this
  • completed The onboarding is completed

canReceivePayments

boolean
Whether or not the organization can receive payments.

canReceiveSettlements

boolean
Whether or not the organization can receive settlements.

_links

object

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

self

URL object
The API resource URL of this endpoint itself.

dashboard

URL object
The URL of the onboarding process in Mollie Dashboard. You can redirect your customer to here for e.g. completing the onboarding process.

organization

URL object
The API resource URL of the organization.

documentation

URL object
The URL to the onboarding status retrieval endpoint documentation.

Example

cURLPHPPythonRubyNode.js
1
2
curl -X GET https://api.mollie.com/v2/onboarding/me \
     -H "Authorization: Bearer access_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"
1
2
3
4
We don't have a PHP 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 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 Ruby 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
28
29
HTTP/1.1 200 OK
Content-Type: application/json

{
    "resource": "onboarding",
    "name": "Mollie B.V.",
    "signedUpAt": "2018-12-20T10:49:08+00:00",
    "status": "completed",
    "canReceivePayments": true,
    "canReceiveSettlements": true,
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/onboarding/me",
            "type": "application/hal+json"
        },
        "onboarding": {
            "href": "https://www.mollie.com/dashboard/onboarding",
            "type": "text/html"
        },
        "organization": {
            "href": "https://api.mollie.com/v2/organization/org_12345",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/onboarding-api/get-onboarding-status",
            "type": "text/html"
        }
    }
}