URL

https://verify.safeid.io/api/v1.0/oath/verify

Input Parameters

clientId
non/aClient ID of your account provided by the service provider
apiKey
non/aAPI Key of your account provided by the service provider
tsn
non/aThe serial number of the token to be verified
otp
non/aA one-time passcode 
dtfc
yescurrent timeDate Time in UTC when the OTP was captured2022-06-28T17:22:00
authtrue/falseyestrue

true=authentication only

false=return the date time when the OTP was generated


ParamValuesOptionalDefault ValueRemarksExample

Output Result

The output of this api function is a JSON object containing the following key/value pairs:

  1. error: the error code of the result. 0 means success, others mean failure
  2. message: the description of the error
  3. time: the date time when the OTP was generated (when auth=false)

Examples

Example 1

GET: https://verify.safeid.io/api/v1.0/oath/verify?clientID=10011001&ApiKey=cl9ASENZV1k=&tsn=10011001&otp=576151

Result: {"error":0,"message":"OK"}

Example 2

GET: https://verify.safeid.io/api/v1.0/oath/verify?clientID=10011001&ApiKey=cl9ASENZV1k=&tsn=10011001&otp=576151&auth=false

Result: {"error":0,"message":"OK","time":"2019-12-30T12:34:49000:00"}