Verifying user-supplied PINs

Request

To verify the PIN that the user has supplied, send a POST request to:

http://<server>:<port>/adm/v1/user/accounts/actions/validatePin

This request will fail if the PIN's status is LOCKED. You can check the status of each PIN as described in Getting the status of all PINs for the account.

Headers

• Content-Type: application/json
• Authorisation
• nv-tenant-id

Mandatory arguments

None

Example

A POST request with this payload checks whether the supplied PIN value is correct for the specified PIN type:

{
    "type": "ParentalPin",
    "value": "1A2B3C4D5E"
}

Response

A successful request returns an HTTP 200 status.

An unsuccessful request returns an HTTP 401 status.

See also

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