Sign in

v1

latestOpenAPI 3.0.32026-07-26229361630.0 KB
Entity Linking

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

Request body

queriesstring[] required

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

ontologystring required

Ontology name applied to every query in the batch.

versionstring required

Ontology version applied to every query in the batch.

top_kinteger

Number of candidate results to return per query.

metadataobject

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

request_idstring nullable

Optional request ID. Generated automatically if omitted.

Example request

{
  "ontology": "snomed",
  "version": "20250401_extended"
}

Response

One result block per query, in request order.

Example response

{
  "results": [
    {
      "results": [
        {
          "term_id": "29857009",
          "term_name": "Chest pain"
        }
      ]
    }
  ]
}