Skip to main content
A Care Context represents a logical grouping of health records. Each HMIS, LMIS, or PHR system should determine how to organize data into one or more care contexts for a user. For example, a hospital system might create a care context for each hospital visit, a lab test is a care-context for LMIS, or user-uploaded records in a PHR app.

​
Care Context Linking and Data Sharing

Enables health data exchange between Health Information Providers (HIPs) and Health Information Users (HIUs).
1

Link Care Contexts (HIP)

The HIP links a care context to the patient’s ABHA address using the Care Context Link API. This registers the care context with ABDM so it can be discovered and requested by HIUs.You can optionally include the FHIR data as a base64-encoded string in the data field of the Link API request. If provided, Eka stores the data on its servers and handles data sharing automatically when an HIU requests it — you will not need to handle the abha.hip_data_fetch webhook.
2

Receive Linking Confirmation

Listen for the abha.link_care_context webhook to confirm whether the care context was successfully linked (LINKED) or failed (ERRORED).
3

Handle Data Fetch Requests

When an HIU requests data for a linked care context (after the user grants consent), you receive the abha.hip_data_fetch webhook. This webhook is sent only if you are not storing the data on Eka servers and need to provide it yourself.
4

Push Encrypted Data

Prepare the ABDM-compliant FHIR bundle for the requested care contexts, encrypt it using the key information from the webhook, and push it via the Care Context Data On-Fetch API.
If you store health data on Eka servers — either by passing base64-encoded FHIR data in the data field of the Link API, or via the Upload API — Eka handles data sharing automatically and you will not receive the abha.hip_data_fetch webhook.

​
Listing Care Contexts

This feature is useful for displaying a list of care contexts to a doctor (HMIS) or within a PHR app.
Listing linked Care Contexts involves two steps, as an ABHA address could have thousands of documents associated with multiple providers.
1

List Linked Providers

Use the List Providers API to retrieve all linked providers. This API returns a hip_id and the name for each linked provider.
2

List Care Contexts for a Provider

Using the hip_id obtained from the previous step, use the List Care Contexts API to retrieve all linked care contexts for that provider.

​
Linking Care Contexts

​
Creating a new Care Context

Care contexts can be linked to an ABHA in various ways, depending on the document type.

​
HIP Initiated Linking

Use the Link API to create the care context. Once linked, you will receive the abha.link_care_context webhook with the linking status.

​
Upload a Medical Record

Use the Upload API to upload a document and API will automatically create a care context.

​
Discover Unlinked Care Contexts

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