Skip to main content

Login & Verification

Search ABHA Profile (for Password Login)

Look up a profile by ABHA Number as the first step of the password login flow. Returns basic profile info to confirm the correct account before requesting password.

POST/profile/login/search

Authorizations

Authorizationbearer tokenRequired

The accessToken from POST /api/hiecm/gateway/v3/sessions. Send it as Authorization: Bearer <ACCESS_TOKEN>.

Headers

REQUEST-IDstringRequired

Unique UUID v4 per request. Used for idempotency and distributed tracing. Generate a fresh UUID for every call.

TIMESTAMPstringRequired

ISO 8601 UTC timestamp of the request.

Body

ABHANumberstringRequired

14-digit ABHA number (with or without hyphens)

Responses

200

Profile found

400

Bad Request, invalid scope, loginHint, or encrypted field

Error codes for this module

401

Unauthorized, missing, invalid, or expired Bearer token

Everything returns 401

403

Forbidden, the token is valid but not permitted for this operation

Error codes for this module

404

Resource not found

Error codes for this module

500

Server error, retry

Error codes for this module