Skip to main content

Create ABHA - Aadhaar fingerprint (bio)

Creates an ABHA number by authenticating the Aadhaar holder's fingerprint. The PID block is captured with a UIDAI-registered fingerprint RD device.

POST/abha/api/v3/enrollment/enrol/byAadhaar

The response contains the ABHA profile and tokens.token (user X-token).

Endpoint: POST /abha/api/v3/enrollment/enrol/byAadhaar

Flow: Create ABHA - Fingerprint - step 1 of 7

  • Previous: none (first call of this flow)
  • Next: After ABHA creation - send OTP to verify mobile (optional)

Headers (plus Authorization: Bearer <gateway token>):

Header Required Description
TIMESTAMP yes Current UTC timestamp in ISO-8601 format.
REQUEST-ID yes Unique UUID for every request.
Benefit-Name no Applicable for user who is enrolling via Benefit Program.

Request body for this use case:

Field Value / Type Required Description
authData object yes Authentication payload for this use case.
authData.authMethods ["bio"] yes Authentication method used in this step.
authData.bio object yes Fingerprint authentication block.
authData.bio.aadhaar string yes Aadhaar number, RSA-encrypted.
authData.bio.fingerPrintAuthPid string yes Base64 PID block captured from a registered fingerprint RD device.
authData.bio.mobile string no Mobile number to be linked with the ABHA (plain, 10 digits).
consent object yes Consent captured from the user for ABHA enrolment.
consent.code string yes Consent code. Use ABHA-enrollment.
consent.version string yes Consent version. Use 1.4.

Note: The Postman collection (Create ABHA - Fingerprint 3.1) sends authMethods: ["OTP"]. This spec uses ["bio"]; confirm with NHA.

Responses

200

Success: Create ABHA via Fingerprint - Positive Flow

messagestring
tokensobject
tokens.tokenstring
tokens.expiresIninteger
tokens.refreshTokenstring
tokens.refreshExpiresIninteger
ABHAProfileobject
ABHAProfile.firstNamestring
ABHAProfile.middleNamestring
ABHAProfile.lastNamestring
ABHAProfile.dobstring
ABHAProfile.genderstring
ABHAProfile.mobilestring
ABHAProfile.phrAddressstring[]
ABHAProfile.districtCodestring
ABHAProfile.stateCodestring
ABHAProfile.abhaTypestring
ABHAProfile.stateNamestring
ABHAProfile.districtNamestring
ABHAProfile.ABHANumberstring
ABHAProfile.abhaStatusstring
isNewboolean
400

Bad Request (request validation failed).

Error codes for this module

txnIdstring
timestampstring
401

Unauthorized (invalid / expired gateway token, X-token or benefit access): Aadhaar Bio-Invalid Benefit Name

Everything returns 401

messagestring
timestampstring
422

Unprocessable Entity (business rule or UIDAI failure): Aadhaar Bio-Invalid certificate

Error codes for this module

errorobject
error.codestring
error.messagestring
500

Internal Server Error.

Error codes for this module