Cloud Administration Retrieve Hardware Token Details API

The Cloud Administration Retrieve Hardware Token Details API enables Help Desk Administrators to retrieve a hardware token record by providing a token serial number.

For information about managing access to this API, see Accessing the Cloud Administration APIs.

Authentication

Clients calling this API must authenticate themselves by including a JSON web token in the request. For instructions on using this token, see Authentication for the Cloud Administration APIs.

Software Developer Kit

You can download the API Software Developer Kit (SDK) from Cloud Administration REST API Download.

Request Requirements

Use the following information to retrieve a hardware token by providing a token serial number.

Example Request Data

The following example displays a request.

POST /AdminInterface/restapi/v1/sidTokens/lookup

Accept: application/json

Authorization: Bearer <JWT token>

Example Request Body

{

"tokenSerialNumber": "000000200002"

}

Request Property Descriptions

The following table shows request property descriptions and other associated information.

Example Response

The following example response shows the status of a single hardware token with the token serial number specified in the request.

{

"deviceType": "SID700",

"tokenStatus": "Enabled",

"assignedBy": null,

"registeredDate": null,

"assignedAt": null,

"tokenStatusChangedAt": null,

"userId": null,

"expiryDate": "2027-02-12T00:00:00.000Z",

"tokenSerialNumber": "000000200002",

"pinSet": false,

"name": null,

"id": "486177dd-5e3a-4094-a98f-9ee03f4ad0cd",

"tokenState": "Unassigned",

"tokenStatusChangedBy": null,

"updatedAt": "2021-06-04T16:16:56.879Z"

}

Response Property Descriptions

The following table shows response property descriptions and the associated data types.

Response Codes

The following table shows response codes and descriptions for this API.