Verify my number with a code

Verifies the code and latches the caller’s number as verified (204). 410 when the challenge is unknown/expired, 422 on a wrong code, 429 once locked out.

POST /api/v1/otp/phone-verifications/{challengeId}/verify

Verify my number with a code

cURL

curl --request POST \
  --url https://sandbox.api.nkama.ga/api/v1/otp/phone-verifications/{challengeId}/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>"
}
'

Authorizations

Authorization · string · header · required

Bearer access token (JWT) issued by Keycloak or the sandbox token endpoint.

Path Parameters

challengeId · string · required

Body

application/json

code · string · required

Minimum string length: 1

Pattern: \d{4,8}

Response

204

No Content