List capabilities
Changed on🚧 Beta feature
This feature is currently in beta testing, and the final specification may still change.
Retrieve a list of capabilities for an organization.
This API provides detailed insights into the specific requirements and status of each client's onboarding journey.
Capabilities are at the organization level, indicating if the organization can perform a given capability. Capabilities may have requirements, which provide more information on what is needed to use this capability. Requirements may have a due date, which indicates the date by which the requirement should be fulfilled. If a requirement is past due, the capability is disabled until the requirement is fulfilled.
For payments, regardless them being at the profile level, the capability is listed at the organization level. This means that if at least one of the clients's profiles can receive payments, the payments capability is enabled, communicating that the organization can indeed receive payments.
Request
- Base URLhttps://api.mollie.com
- URLhttps://api.mollie.com/v2/capabilities
- Auth
- HTTP bearer
- or OAuth 2Authorization code: https://my.mollie.com/oauth2/authorizeToken URL: https://api.mollie.com/oauth2/tokens scopes: onboarding.read
Headers
A unique key to ensure idempotent requests. This key should be a UUID v4 string.
Response
A list of capabilities.
Example response
{
"count": 2,
"_embedded": {
"capabilities": [
{
"resource": "capability",
"name": "payments",
"status": "pending",
"statusReason": "requirement-past-due",
"requirements": [
{
"id": "needs-data",
"status": "past-due",
"dueDate": "2024-01-01T12:00:00+00:00",
"_links": {
"dashboard": {
"href": "https://...",
"type": "application/hal+json"
}
}
}
]
}
]
},
"_links": {
"documentation": {
"href": "https://...",
"type": "application/hal+json"
}
}
}Changes
- info
added the non-success response with the status
- info
- info
the endpoint scheme security
advancedAccessTokenwas added to the API - info
the endpoint scheme security
organizationAccessTokenwas removed from the API
- info