Translate Item
Translates a medical code from one vocabulary to another (also called code mapping). Given a source vocabulary and code — for example SNOMED code 25064002 — and a target vocabulary such as ICD-10, the TranslateItem API returns the set of matching target codes along with the relationship of each match to the source (exact, broader, narrower, and so on).
Common uses include deriving billing codes from clinical documentation, converting terminology in interoperability payloads, and exploring how two vocabularies align.
GET /Quippe/Coding/TranslateItem
Use this endpoint when you already have a source code. To find a code from free-text instead, use /Quippe/Coding/Search/Search. To map every finding in a whole patient chart at once, use /Quippe/Coding/ChartMap.
Authentication
Login and password used to access quippe.medicomp.com. On-premise Quippe deployments can be configured to use whatever authentication and authorization your application is configured for, so basic authentication is used here to access the Quippe sandbox and is not a product requirement.
JSON web token generated by a request to the /Quippe/Security/Token web service endpoint in Quippe.
Query parameters
The vocabulary that SourceCode belongs to — the vocabulary you are translating from. Common values: snomed, icd10 (ICD-10-CM), icd10pcs, cpt, hcpcs, loinc, rxnorm, medcin. When this is a MEDCIN vocabulary, the optional qualifier parameters (Prefix, Status, Modifier, Result, Specifier, Value, Age, Sex) are applied to the source code; otherwise they are ignored. The list of supported vocabularies can be retrieved from the /Quippe/Coding/Vocabs endpoint.
The code to translate, expressed in the vocabulary named by SourceVocabulary — for example 25064002 when SourceVocabulary is snomed, or E11.9 when it is icd10. MEDCIN source codes must be numeric; if SourceVocabulary is a MEDCIN vocabulary but this value is not numeric, the code is treated as a plain code from another vocabulary and the MEDCIN qualifier parameters (Prefix, Status, Modifier, Result, Specifier, Value, Age, Sex) are ignored. A code that exists in the source vocabulary but has no maps to the target — and a code that is not recognized at all — both return an empty Map element.
The vocabulary to translate into — the vocabulary of the codes returned in each Entry/@Code. Common values: icd10 (ICD-10-CM), icd10pcs, cpt, hcpcs, snomed, loinc, rxnorm. Note that icd is ICD-9-CM, not ICD-10 — use icd10 for ICD-10-CM. Not every source/target pair has maps; a pair with no maps returns an empty Map element. The list of supported vocabularies can be retrieved from the /Quippe/Coding/Vocabs endpoint.
Optional MEDCIN prefix qualifier for the source code — the prefix positions a finding in context, such as a family-history or “history of” framing. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise, and affects which target codes the translation produces.
Optional MEDCIN result qualifier for the source code — for example to indicate a positive vs. negative finding. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
Optional MEDCIN status qualifier for the source code — for example to mark a finding as absent, resolved, or historical rather than currently present. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
Optional MEDCIN modifier qualifier for the source code, refining the finding (for example laterality or severity). Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
Optional MEDCIN specification string for the source code, carrying the finding’s post-coordinated detail. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
Optional patient age in minutes, used as translation context for age-specific MEDCIN source findings. MEDCIN expresses age in minutes for neonatal/pediatric precision; for example 1 year is about 525,960 minutes. Applies only to MEDCIN source codes. Defaults to 0 (no age context).
Optional patient sex (M or F), used as translation context for sex-specific MEDCIN source findings. Applies only to MEDCIN source codes. Leave blank (default) for no sex context.
Optional test or measurement value for the source code — for example a numeric result attached to a MEDCIN finding that carries a value. Applies only to MEDCIN source codes. Defaults to none.