Skip to main content

Login via Biometric (Iris) - send authentication request

Starts IRIS login for an ABHA number. Use the returned txnId in *Login via Biometric (Iris) - verify*.

POST/abha/api/v3/profile/login/request/otp

Endpoint: POST /abha/api/v3/profile/login/request/otp

Flow: Login - Biometric v3 (Iris) - step 1 of 2

  • Previous: none (first call of this flow)
  • Next: Login via Biometric (Iris) - verify

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

Header Required Description
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-login", "Aadhaar-iris-verify"] yes Scope that selects this use case. Send exactly the values listed for this API.
loginHint "ABHA-number" yes Type of identifier sent in loginId.
loginId string yes Identifier value, RSA-encrypted with the ABHA public certificate.
otpSystem "ABDM" yes System that generates and delivers the OTP (Aadhaar = UIDAI, ABDM = ABDM).

Note: The Postman collection does biometric login with a single call to /abha/api/v3.1/profile/login/verify (see tag Login - Biometric v3.1). Confirm which contract is current.

Responses

200

Success: Login Via Biometric - Using Iris - Send OTP

txnIdstring
messagestring
400

Bad Request (request validation failed).

Error codes for this module

txnIdstring
timestampstring
401

Unauthorized (invalid / expired gateway token, X-token or benefit access): Invalid Credentials (generic)

Everything returns 401

codestring
messagestring
descriptionstring
404

Not Found: Resource not found

Error codes for this module

timestampstring
pathstring
descriptionstring
errorstring
requestIdstring
500

Internal Server Error.

Error codes for this module