Permissions API

List permissions

Changed on

Retrieve a list of all permissions available to the current access token.

The results are not paginated.

get/v2/permissions

Request

  • Base URL
    https://api.mollie.com
  • URL
    https://api.mollie.com/v2/permissions
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://my.mollie.com/oauth2/authorize
      Token URL: https://api.mollie.com/oauth2/tokens

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

Response

A list of permission objects.

countinteger required

The number of items in this result set. If more items are available, a _links.next URL will be present in the result as well.

The maximum number of items per result set is controlled by the limit property provided in the request. The default limit is 50 items.

Example response

{
  "count": 5,
  "_embedded": {
    "permissions": [
      {
        "resource": "permission",
        "id": "payments.read",
        "description": "View your payments",
        "granted": true,
        "_links": {
          "self": {
            "href": "https://...",
            "type": "application/hal+json"
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://...",
      "type": "application/hal+json"
    },
    "documentation": {
      "href": "https://...",
      "type": "application/hal+json"
    }
  }
}

Changes

    • breaking

      the response property's min was decreased from 1.00 to 0.00 for the response status

    • info

      the response property //// became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status