biotech

Normalize a drug name to its canonical RxNorm concept

Resolves a drug brand, generic, or ingredient name (or an RxCUI) to its canonical RxNorm concept, returning the RxCUI, canonical name, term type, and dose forms. confidence 1.0 = exact name match (or direct RxCUI); 0.8 = single approximate match; 0.5 = multiple approximate candidates (lowest RxCUI returned); 0.0 = no match. RxNorm passthrough (cached); an RxNorm outage returns 503 UPSTREAM_UNAVAILABLE. For all known names use /biotech/drug/synonyms. Charges 2 cost_units; 1 when the query is empty (rejected locally before RxNorm is called); an unknown query_type is a request-shape error, rejected unbilled (INVALID_INPUT).

post/v1/biotech/drug/lookup

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/biotech/drug/lookup
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

querystring required

The drug name or RxCUI to look up (e.g. 'Tylenol').

query_typestring

How to interpret the query: 'name' (default; a drug brand, generic, or ingredient name, approximate-matched) or 'rxcui' (an RxNorm concept id).

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.