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

# Discover Link On Init

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

This API is used by HIP to initiate the linking of unlinked health records (care contexts). HIP must send an OTP and provide details such as OTP expiry and other related information.

## Headers

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

## Request body

- ModelsLinkOnInitHmisConnect
  - `error` ModelsError
    - `code` integer — Error code indicating the type of error
    - `message` string — Detailed error message
  - `otp_expiry` string — Expiry time of the OTP sent for linking care contexts.
  - `ref_num` string — patient reference number.
  - `request_id` string, required — Request ID that is received in the webhook call.
  - `txn_id` string, required — Transaction ID 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)