2106: Get entity permission acceptance status

2106: Get entity permission acceptance status

Fetch all permissions the entity has given

Endpoint ID:

2106

Method:

GET

URL:

/permissions/entity/id/{entityID}/permission/{permissionID}

/permissions/entity/ext-key/{ext-key}/{ext-type}/permission/{permissionID}

 

 

entityID

Rubiq master ID that uniquely identifies the entity

 

ext-key

External key that uniquely identifies the entity

 

ext-type

Type of external key

 

permissionID

A GUID string identifying a permission. If present, it will limit the status data to a specific permission. If omitted, status data for all permissions are returned.

Request body:

None

{ "accepted": [ { "isActive": true, "isWithdrawn": false, "isExpired": false, "permissionID": "848a6fe7-89ea-45c0-827e-652c79e8ed34", "permissionName": "Some permission", "acceptance": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239" }, "terms": { "id": "98397963-8c93-4ba4-86ff-368e2dbaac32", "name": "Some terms", "version": "1.2" } }, { "isActive": true, "isWithdrawn": false, "isExpired": false, "permissionID": "ff11961d-8ae7-4508-aed7-867220a89668", "permissionName": "Another permission", "acceptance": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239" } } ], "withdrawn": [ { "isActive": false, "isWithdrawn": true, "isExpired": false, "permissionID": "ae11961d-8fe7-4508-aed7-867220a89668", "permissionName": "My very important permission", "acceptance": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239" }, "withdrawal": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239", "reason": "plain text explanation for withdrawal if supplied by user upon time of withdrawal" } } ], "expired": [ { "isActive": false, "isWithdrawn": false, "isExpired": true, "permissionID": "ae11961d-8fe7-4508-aed7-867220a89668", "permissionName": "My very important permission", "terms": { "id": "98397963-8c93-4ba4-86ff-368e2dbaac32", "name": "Some terms", "version": "1.0" }, "acceptance": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239" }, "expiry": { "timestamp": "utc timestamp" } } ], "declined": [ { "permissionID": "ae11961d-8fe7-4508-aed7-867220a89668", "permissionName": "My very important permission", "declined": { "timestamp": "utc timestamp", "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239" }, "terms": { "id": "98397963-8c93-4ba4-86ff-368e2dbaac32", "name": "Some terms", "version": "1.1" } } ] }

Status codes:

200

OK

 

404

The entity or permission (if specified) were not found.

The following sub codes may be returned:

404.1

Entity not found

404.2

External entity reference could not be found

404.5

Permission not found