ABDM allows a user to find their health records from any health facility they have visited via the discovery process.

When a discovery request is initiated by the user, the HIP will receive a list of verified identifiers along with name and demographic information. Verified information includes the ABHA address, the mobile number name, gender, year of birth.

PHR Flow

1

Discover Unlinked CareContexts

Use the discover api to get a list of care-contexts that are not linked to the user’s account. Linking Process is initiated by the user by providing the care-context id and the verification code is sent to the user’s mobile number.

2

Initate the linking

Use the link init api to initiate the linking process, the HIP will send an OTP to the user’s mobile number.

3

Confirm the linking with OTP

Use txn_id from the previous step and OTP sent to the user’s mobile number to confirm the linking.

HIP Flow

1

On Discover

The HIP receives a discovery request and returns the list of unlinked care-contexts associated with the user.

2

On Link Init

After generating the OTP, the HIP should call the on-link-init API to notify the ABDM gateway about the OTP sent.

3

On Link Confirm

After verifying the OTP and initiating the linking of the care-context, the HIP should call the on-link-confirm API to notify the ABDM gateway about the successful linking of the unlinked health record.