POST
/
auth
/
v1
/
status
curl --request POST \
  --url https://auth.otpless.app/auth/v1/status \
  --header 'Content-Type: application/json' \
  --header 'clientId: <api-key>' \
  --header 'clientSecret: <api-key>' \
  --data '{
  "requestId": "unique_request_id"
}'
{
  "token": "unique_token_for_transaction",
  "status": "SUCCESS",
  "completedAt": 1725945420000,
  "identities": [
    {
      "identityType": "MOBILE",
      "identityValue": "USER_PHONENUMBER",
      "channel": "VOICE_APPROVAL",
      "methods": [
        "VOICE_CALL"
      ],
      "verified": true,
      "verifiedTimestamp": 1725945420000
    }
  ]
}

Authorizations

​
clientId
string
header
required
​
clientSecret
string
header
required

Body

application/json
​
requestId
string
required

The unique request ID of the authentication process.

Example:

"unique_request_id"

Response

200
application/json
Status retrieved successfully.
​
token
string

A token representing the completed transaction.

Example:

"unique_token_for_transaction"

​
status
string

The status of the authentication.

Example:

"SUCCESS"

​
completedAt
integer

The timestamp when the authentication was completed.

Example:

1725945420000

​
identities
object[]

Was this page helpful?

Phone Call ApprovalSend Message