---
title: "List capabilities"
method: GET
path: "/v2/capabilities"
tags: ["Capabilities API"]
---

# List capabilities

`GET /v2/capabilities`

## Request

- Base URL: `https://api.mollie.com`
- URL: `https://api.mollie.com/v2/capabilities`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `onboarding.read`

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

> 🔑 Access with
>
> [Advanced access token with **onboarding.read**](/reference/authentication)
>
> [OAuth access with **onboarding.read**](/reference/authentication)

## Response `200`

A list of capabilities.

- object
  - `count` integer, required: The number of items in this result set.
  - `_embedded` object, required
    - `capabilities` object[], required
      - `resource` string, required: Always the word `capability` for this resource type.
      - `name` string, required: A unique name for this capability like `payments` / `settlements`.
      - `status` 'unrequested' | 'enabled' | 'disabled' | 'pending', required
      - `statusReason` 'requirement-past-due' | 'onboarding-information-needed' | 'null', nullable, required
      - `requirements` object[], required
        - `id` string, required: The name of this requirement, referring to the task to be fulfilled by the organization to enable or re-enable the capability. The name is unique among other requirements of the same capability. Examples include `needs-data` and `process-first-payment`.
        - `status` string, required: The status of the requirement depends on its due date. If no due date is given, the status will be `requested`. Possible values: `currently-due` `past-due` `requested`
        - `dueDate` string, nullable, required: Due date until the requirement must be fulfilled, if any. The date is shown in ISO-8601 format.
        - `_links` object, required
          - `dashboard` object: If known, a deep link to the Mollie dashboard of the client, where the requirement can be fulfilled. For example, where necessary documents are to be uploaded.
            - `href` string, required: The actual URL string.
            - `type` string, required: The content type of the page or endpoint the URL points to.
  - `_links` object, required
    - `documentation` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/mollie-connect.md) - [All operations](https://skmtc.dev/mollie/apis/mollie-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-connect/revisions/65271e79a786?raw)