Check next available approval time and number of approved devices

Request

To check when the next available approval request can be made and how many devices are approved, send a GET request to:

https://<host>:<port>/adm/v1/user/devices/canIApproveADevice

This request also returns the current and maximum number of approved devices (both overall and within the configured approval period) and the length of the approval period.

Headers

• x-correlation-id – identifier for logging, to correlate messages across a call flow
• nv-tenant-id – the tenant ID
• token – request authentication token

Mandatory arguments

None

Other arguments

None

Response

A successful request returns an HTTP 200 status.

An unauthorised request returns an HTTP 401 status.

Example

A successful request returns a response that looks like this:

{
  "currentNumberOfApprovedDevices": 2,
  "numberOfDevicesApprovedInPeriod": 1,
  "numberOfAllowedApprovalsInPeriod": 1,
  "maximumNumberOfDevicesCanBeApproved": 5,
  "numberOfDaysInApprovalPeriod": 1,
  "nextDeviceCanBeApprovedOn": "2022-07-20T10:10:47.012Z",
  "allowedToApprove": true
}

See also

For full details of this API, see the Account and Device Manager (ADM) API documentation.