Push care context data to HIU

Use this API to push encrypted FHIR data to the HIU after receiving the abha.hip_data_fetch webhook.

The HIP is responsible for preparing ABDM-compliant FHIR bundles, encrypting them using the key information received in the webhook, and pushing the data through this API. Use the transaction_id from the webhook payload to correlate the request.

This API is only needed if you are not storing health data on Eka servers.

POST /abdm/v1/hip/care-context/data/on-fetch

cURL

cURL

curl --request POST \
  --url https://api.eka.care/abdm/v1/hip/care-context/data/on-fetch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entries": [
    {
      "care_context_id": "<string>",
      "checksum": "<string>",
      "content": "<string>",
      "media": "application/fhir+json"
    }
  ],
  "key_information": {
    "crypto_alg": "<string>",
    "curve": "<string>",
    "dh_public_key": {
      "expiry": "<string>",
      "key_value": "<string>",
      "parameters": "<string>"
    },
    "nonce": "<string>"
  },
  "transaction_id": "<string>"
}
'

4XX

{
  "code": 123,
  "error": "<string>",
  "source_error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization · string · header · required

The API requires a Bearer token (JWT) for authentication.

Headers

X-Pt-Id · string

Eka User ID (OID)

X-Partner-Pt-Id · string

Partner User ID

X-Hip-Id · string

Partner HIP ID

Body

application/json

entries · object[] | null

Show child attributes

key_information · object

Show child attributes

transaction_id · string

Response

202

Accepted