Skip to main content
POST
DigiLocker verify
Finalizes the Aadhaar verification via DigiLocker after the customer completes OAuth. Pass the access_request_id from DigiLocker Initiate. linked_number is optional (92-series per-number binding).
Authenticate with your parent main account’s X-Auth-ID and X-Auth-Token - the same credentials used everywhere else in the API.

Request body

Response example

200 OK
Call this only after the customer has completed the DigiLocker OAuth flow. Calling it before the customer authorizes will not return verified.

Authorizations

X-Auth-ID
string
header
required

Your Vobiz account Auth ID

X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

sub_auth_id
string
required

The sub-account's Auth ID.

Example:

"SA_XXXXXX"

Body

application/json
access_request_id
string
required
Example:

"AR_xxxxxxxx"

linked_number
string

Optional. Binds the Aadhaar to a specific number (92-series).

Example:

"+91XXXXXXXXXX"

Response

200 - application/json

Verification result

Outcome of a single KYC verification step.

verification_type
enum<string>
required
Available options:
pan,
gst,
cin,
aadhaar
status
enum<string>
required
Available options:
verified,
failed,
pending
kyc_calls_blocked
boolean

Recomputed sub-account call-blocking state after this verification.

mock
boolean

Present and true on responses from the test-mode endpoints.