Get permission

Permissions API v1
GEThttps://api.mollie.com/v1/permissions/*id*
Authentication:App access tokens

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/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. See Permissions for details about the available permissions.

Possible values: apikeys.read apikeys.write customers.read customers.write mandates.read mandates.write organizations.read organizations.write payments.read payments.write profiles.read profiles.write refunds.read refunds.write settlements.read

descriptionstring
A short description of what the permission allows.
warningstring
A mandatory warning message when necessary.
grantedboolean
Whether this permission is granted to the app by the organization or not.

Example

Request

1
2
curl -X GET https://api.mollie.com/v1/permissions/payments.read \
    -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
HTTP/1.1 200 OK
Content-Type: application/json

{
    "resource": "permission",
    "id": "payments.read",
    "description": "View your payments",
    "warning": null,
    "granted": true
}