Get permission

Permissions API v2
GEThttps://api.mollie.com/v2/permissions/*id*

All API actions through OAuth are by default protected for privacy and/or money related reasons and therefore require specific permissions. These permissions can be requested by apps during the OAuth authorization flow. The Permissions resource allows the app to check whether an API action is (still) allowed by the authorization.

Parameters

Replace id in the endpoint URL by the permission’s ID, for example payments.read. See Permissions for details about the available permissions.

Response

200 application/hal+json

resourcestring
Indicates the response contains a permission object. Will always contain permission for this endpoint.
idstring
The permission’s unique identifier, for example payments.read
descriptionstring
A short description of what the permission allows.
grantedboolean
Whether this permission is granted to the app by the organization or not.
_linksobject

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

Show child parameters

selfURL object
The API resource URL of the permission itself.
documentationURL object
The URL to the permission retrieval endpoint documentation.

Example

cURLPHPPythonRubyNode.js
1
2
curl -X GET https://api.mollie.com/v2/permissions/payments.read \
   -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"
1
2
3
4
<?php
$mollie = new \Mollie\Api\MollieApiClient();
$mollie->setAccessToken("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ");
$permission = $mollie->permissions->get("payments.read");
1
2
3
4
5
6
from mollie.api.client import Client

mollie_client = Client()
mollie_client.set_access_token('access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ')

permissions = mollie_client.permissions.get('payments.read')
1
2
3
4
5
6
7
require 'mollie-api-ruby'

Mollie::Client.configure do |config|
  config.api_key = 'access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ'
end

permission = Mollie::Permission.get('payments.read')
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
HTTP/1.1 200 OK
Content-Type: application/hal+json

{
    "resource": "permission",
    "id": "payments.read",
    "description": "View your payments",
    "granted": true,
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/permissions/payments.read",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/permissions-api/get-permission",
            "type": "text/html"
        }
    }
}