Medication name normalization and resolution

Resolve an identity when evidence is sufficient#

POST /v1/resolve accepts a required query string of 1–512 characters. It identifies a canonical MedicationVariant; it does not select medication for a patient. The response preserves the original query.

curl --fail-with-body "$IABULA_API_BASE/v1/resolve" \
  --header "X-API-Key: $IABULA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"query":"NATULAXE CAPSULA"}'

Verified positive example#

NATULAXE CAPSULA was confirmed as resolved in the RapidAPI Hub. Confirmed facts are product_name = NATULAXE, entity_type = medication_variant and dosage_form = cápsula. These facts are documented without inventing a UUID or additional response values.

When status is resolved, resolved contains id, entity_type, product_name, brand_name, dosage_form and active_ingredient_text. brand_name and active_ingredient_text may be null. Ingredient text does not guarantee a canonical link to an ingredient entity.

Abstention is a valid outcome#

When evidence is insufficient for a safe identity, status is unresolved and resolved is null. Both outcomes use HTTP 200. Short, ambiguous or misspelled queries are not guaranteed to resolve. Scores, candidates and internal gate diagnostics are not public fields.

const response = await fetch(`${process.env.IABULA_API_BASE}/v1/resolve`, {
  method: "POST",
  headers: {
    "X-API-Key": process.env.IABULA_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "NATULAXE CAPSULA" }),
});
const result = await response.json();
if (!response.ok) throw new Error(`${response.status}: ${result.code}`);
if (result.status === "unresolved") {
  // Ask for more source information or route to manual review.
} else {
  console.log(result.resolved.product_name, result.resolved.dosage_form);
}

Distinguish no match from failure#

HTTP 503 indicates temporary unavailability, not unresolved. Do not translate authentication, quota or service errors into absence of identity. Applications should allow manual review or request more source information after abstention.

POST /v1/resolve#

OpenAPI contract fields#