---
title: "Discover Link On Confirm"
method: POST
path: "/abdm/v1/care-contexts/discover/link/on-confirm"
---

# Discover Link On Confirm

`POST /abdm/v1/care-contexts/discover/link/on-confirm`

This API is used by HIP to confirm the linking of care contexts after OTP verification.

## Headers

- `X-Pt-Id` string
- `X-Partner-Pt-Id` string
- `X-Hip-Id` string

## Request body

- ModelsLinkOnConfirmHmisConnect
  - `error` ModelsError
    - `code` integer — Error code indicating the type of error
    - `message` string — Detailed error message
  - `patients` ModelsPatient[] — List of patients including reference number, display name, care contexts, and HI type
    - `care_contexts` ModelsCareContext[] — List of care contexts of the patient
      - `display` string — Display name or identifier for the care context
      - `ref_num` string — Unique reference number for the care context
    - `display` string — Display name or identifier for the patient
    - `hi_type` 'OPConsultation' | 'Prescription' | 'DischargeSummary' | 'DiagnosticReport' | 'ImmunizationRecord' | 'HealthDocumentRecord' | 'WellnessRecord' — Type of health information (HI)
    - `ref_num` string — patient reference number.
  - `request_id` string, required — Request ID that is received in the webhook call.

## Response `204`

No Content

## Other responses

- `4XX`
- `5XX`

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)