Link Entities (Batch)

Links up to 5 free-text entities in a single call. All queries in a batch share the same ontology, version, top_k and metadata. The response contains one result block per query, in request order.

POST /med-link/nel/link/batch

Link entities (batch)

cURL

curl --request POST \
  --url https://api.eka.care/med-link/nel/link/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    "fever",
    "headache"
  ],
  "ontology": "snomed",
  "version": "20250401_extended",
  "top_k": 2
}
'

200

{
  "results": [
    {
      "request_id": "e4b280cf-40a1-4a83-9f25-f7f07f3766ed",
      "query": "fever",
      "query_breakdown": null,
      "ontology": "snomed",
      "version": "20250401_extended",
      "index_name": "snomed_20250401_extended_c88b15811956d4fcb54da9ae_1bfcc90540_pg",
      "model_version": "c88b15811956d4fcb54da9ae6d14a733ac90e7a7",
      "results": [
        {
          "term_id": "386661006",
          "term_name": "Febrile",
          "score": 0.89858478307724,
          "is_linked": true,
          "metadata": {
            "semantic_tag": "finding",
            "is_core": true,
            "source": "snomed_ct_20250401_extended",
            "language": "en",
            "script": "latin"
          }
        }
      ]
    },
    {
      "request_id": "e4b280cf-40a1-4a83-9f25-f7f07f3766ed",
      "query": "headache",
      "query_breakdown": null,
      "ontology": "snomed",
      "version": "20250401_extended",
      "index_name": "snomed_20250401_extended_c88b15811956d4fcb54da9ae_1bfcc90540_pg",
      "model_version": "c88b15811956d4fcb54da9ae6d14a733ac90e7a7",
      "results": [
        {
          "term_id": "25064002",
          "term_name": "Headache",
          "score": 0.9999999403953606,
          "is_linked": true,
          "metadata": {
            "semantic_tag": "finding",
            "is_core": true,
            "source": "snomed_ct_20250401_extended",
            "language": "en",
            "script": "latin"
          }
        }
      ]
    }
  ]
}

About this endpoint

POST /med-link/nel/link/batch links up to 5 free-text entities in a single call. Every query in the batch shares the same ontology, version, top_k and metadata.

The response results[] array contains one block per query, in request order — each block has the same shape as a single Link Entity response.

When to use it

• Coding several entities from the same document (e.g. all symptoms in a note).
• Reducing round-trips when the ontology and metadata are identical.

Because metadata is shared across the whole batch, group queries that need different hints — especially LOINC tests with different units or specimens — into separate batches, or use the single Link Entity endpoint.

Limits

Constraint	Value
Queries per request	1–5
top_k	1–10 (default 5)

Authorizations

Authorization · string · header · required

Bearer access token issued by the Eka authorization flow. See Authorization.

Body

application/json

queries · string[] · required

List of free-text entities to link (1–5).

Required array length: 1 - 5 elements

ontology · string · required

Ontology name applied to every query in the batch.

Example:

"snomed"

version · string · required

Ontology version applied to every query in the batch.

Example:

"20250401_extended"

top_k · integer · default: 5

Number of candidate results to return per query.

Required range: 1 <= x <= 10

metadata · object

Ontology-specific hints applied to every query in the batch.

request_id · string | null

Optional request ID. Generated automatically if omitted.

Response

200

application/json

One result block per query, in request order.

results · object[] · required

One NELResponse per query, in request order.

Show child attributes