Child ABHA KYC - send Aadhaar OTP
Starts KYC of a non-KYC Child ABHA. UIDAI sends an OTP to the mobile linked with the child's Aadhaar number. Send the child's X-token.
Endpoint: POST /abha/api/v3/profile/account/request/otp
Flow: Child ABHA - step 4 of 5
- Previous: Update Child ABHA profile
- Next: Child ABHA KYC - verify Aadhaar OTP
Headers (plus Authorization: Bearer <gateway token>):
| Header | Required | Description |
|---|---|---|
| X-token | yes | User token (Bearer <token>) received after ABHA creation / login. |
| REQUEST-ID | yes | Unique UUID for every request. |
| TIMESTAMP | yes | Current UTC timestamp in ISO-8601 format. |
Request body for this use case:
| Field | Value / Type | Required | Description |
|---|---|---|---|
scope |
["ABHA-profile", "re-KYC"] |
yes | Scope that selects this use case. Send exactly the values listed for this API. |
loginHint |
"Aadhaar" |
yes | Type of identifier sent in loginId. |
loginId |
string | yes | Identifier value, RSA-encrypted with the ABHA public certificate. |
otpSystem |
"Aadhaar" |
yes | System that generates and delivers the OTP (Aadhaar = UIDAI, ABDM = ABDM). |
Responses
200Success: KYC Child ABHA -Send OTP
txnIdstringmessagestring400Bad Request (request validation failed).
Invalid Scopestringtimestampstring401Unauthorized (invalid / expired gateway token, X-token or benefit access): Invalid access token
codestringmessagestringdescriptionstring