user_initiated_linking

02 link-init

Initiates linking of the care contexts discovered at a HIP. The HIP replies with how the person will authenticate.

POST/user-initiated-linking/link/init

Authorizations

Authorizationbearer tokenRequired

The access token from POST /api/hiecm/gateway/v3/sessions.

Body

transactionIdstringRequired

patientobject[]Required

patient.referenceNumberstringRequired

patient.displaystringRequired

patient.careContextsobject[]Required

patient.careContexts.referenceNumberstringRequired

patient.careContexts.displaystringRequired

patient.hiTypestringRequired

patient.countintegerRequired

Responses

200

No response body is documented for this request.

02 link-init

curl --request POST \
  --url https://phrsbx.abdm.gov.in/user-initiated-linking/link/init \
  --header 'Authorization: Bearer <ACCESS_TOKEN_FROM_SESSIONS_CALL>' \
  --header 'Content-Type: application/json' \
  --data '{
  "transactionId": "<TXN_ID>",
  "patient": [
    {
      "referenceNumber": "<ABHA_ADDRESS>",
      "display": "Test",
      "careContexts": [
        {
          "referenceNumber": "Test 1",
          "display": "Sugar Test"
        }
      ],
      "hiType": "Invoice",
      "count": 1
    }
  ]
}'

No response body is documented for this request.