curl -X GET "https://api.omophub.com/v1/concepts/201826/mappings?target_vocabularies=ICD10CM,ICD10&include_mapping_quality=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"source_concept": {
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding"
},
"mappings": [
{
"mapping_id": "map_201826_45757292",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 45757292,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11",
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "3-char billing code",
"standard_concept": "S",
"synonyms": [
{
"concept_synonym_name": "Type II diabetes mellitus",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "Adult-onset diabetes",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.98,
"equivalence_type": "exact",
"semantic_similarity": 0.95,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2024-01-15"
},
"mapping_context": {
"use_case": "billing",
"geographic_scope": ["US"],
"temporal_scope": {
"start_date": "2016-10-01",
"end_date": null
},
"mapping_notes": "Official crosswalk mapping for ICD-10-CM billing purposes",
"cross_walk_source": "CMS ICD-10-CM Official Guidelines"
},
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_4087682",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 4087682,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11.9",
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"domain_id": "Condition",
"concept_class_id": "ICD10 code",
"standard_concept": "S",
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.94,
"equivalence_type": "exact",
"semantic_similarity": 0.92,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2023-08-20"
},
"mapping_context": {
"use_case": "clinical",
"geographic_scope": ["International"],
"mapping_notes": "WHO ICD-10 standard mapping for international use",
"cross_walk_source": "WHO ICD-10 Reference"
},
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_25001",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 25001,
"concept_name": "Type II diabetes mellitus",
"concept_code": "250.00",
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "4-dig billing code",
"standard_concept": "S",
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
},
"mapping_quality": {
"confidence_score": 0.91,
"equivalence_type": "exact",
"semantic_similarity": 0.89,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2014-09-30"
},
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
}
],
"mapping_summary": {
"total_mappings": 12,
"outgoing_mappings": 8,
"incoming_mappings": 4,
"target_vocabularies": [
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"mapping_count": 3
},
{
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"mapping_count": 2
},
{
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"mapping_count": 7
}
],
"mapping_type_distribution": {
"Maps to": 8,
"Mapped from": 4
},
"quality_distribution": {
"exact": 7,
"broader": 3,
"narrower": 1,
"related": 1
},
"coverage_analysis": {
"well_mapped_vocabularies": ["ICD10CM", "ICD10", "ICD9CM"],
"poorly_mapped_vocabularies": [],
"unmapped_domains": []
}
}
},
"meta": {
"pagination": {
"page": 1,
"page_size": 100,
"total_items": 12,
"total_pages": 1,
"has_next": false,
"has_previous": false
},
"query_time_ms": 87.3,
"request_id": "req_mappings_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Retrieve cross-vocabulary mappings for a specific concept, showing equivalent or related concepts in other terminologies
curl -X GET "https://api.omophub.com/v1/concepts/201826/mappings?target_vocabularies=ICD10CM,ICD10&include_mapping_quality=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"source_concept": {
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding"
},
"mappings": [
{
"mapping_id": "map_201826_45757292",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 45757292,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11",
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "3-char billing code",
"standard_concept": "S",
"synonyms": [
{
"concept_synonym_name": "Type II diabetes mellitus",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "Adult-onset diabetes",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.98,
"equivalence_type": "exact",
"semantic_similarity": 0.95,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2024-01-15"
},
"mapping_context": {
"use_case": "billing",
"geographic_scope": ["US"],
"temporal_scope": {
"start_date": "2016-10-01",
"end_date": null
},
"mapping_notes": "Official crosswalk mapping for ICD-10-CM billing purposes",
"cross_walk_source": "CMS ICD-10-CM Official Guidelines"
},
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_4087682",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 4087682,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11.9",
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"domain_id": "Condition",
"concept_class_id": "ICD10 code",
"standard_concept": "S",
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.94,
"equivalence_type": "exact",
"semantic_similarity": 0.92,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2023-08-20"
},
"mapping_context": {
"use_case": "clinical",
"geographic_scope": ["International"],
"mapping_notes": "WHO ICD-10 standard mapping for international use",
"cross_walk_source": "WHO ICD-10 Reference"
},
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_25001",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 25001,
"concept_name": "Type II diabetes mellitus",
"concept_code": "250.00",
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "4-dig billing code",
"standard_concept": "S",
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
},
"mapping_quality": {
"confidence_score": 0.91,
"equivalence_type": "exact",
"semantic_similarity": 0.89,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2014-09-30"
},
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
}
],
"mapping_summary": {
"total_mappings": 12,
"outgoing_mappings": 8,
"incoming_mappings": 4,
"target_vocabularies": [
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"mapping_count": 3
},
{
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"mapping_count": 2
},
{
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"mapping_count": 7
}
],
"mapping_type_distribution": {
"Maps to": 8,
"Mapped from": 4
},
"quality_distribution": {
"exact": 7,
"broader": 3,
"narrower": 1,
"related": 1
},
"coverage_analysis": {
"well_mapped_vocabularies": ["ICD10CM", "ICD10", "ICD9CM"],
"poorly_mapped_vocabularies": [],
"unmapped_domains": []
}
}
},
"meta": {
"pagination": {
"page": 1,
"page_size": 100,
"total_items": 12,
"total_pages": 1,
"has_next": false,
"has_previous": false
},
"query_time_ms": 87.3,
"request_id": "req_mappings_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
201826 (Type 2 diabetes mellitus in SNOMED)ICD10CM,ICD10,HCPCSMaps to,Mapped fromMaps to,Maps to valueoutgoing, incoming, bothvocabulary_id, concept_name, mapping_qualityasc, descShow Source Concept Object
Show Mapping Object
Maps to, Mapped from, Maps to value, Value mapped fromoutgoing, incomingShow Target Concept Object
Show Mapping Quality Object
exact, broader, narrower, related, inexactofficial, community, algorithmic, manualvalidated, pending, disputed, deprecatedShow Mapping Context Object
billing, clinical, research, quality_reportingShow Mapping Summary Object
Show Metadata Object
curl -X GET "https://api.omophub.com/v1/concepts/201826/mappings?target_vocabularies=ICD10CM,ICD10&include_mapping_quality=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"source_concept": {
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding"
},
"mappings": [
{
"mapping_id": "map_201826_45757292",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 45757292,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11",
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "3-char billing code",
"standard_concept": "S",
"synonyms": [
{
"concept_synonym_name": "Type II diabetes mellitus",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "Adult-onset diabetes",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.98,
"equivalence_type": "exact",
"semantic_similarity": 0.95,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2024-01-15"
},
"mapping_context": {
"use_case": "billing",
"geographic_scope": ["US"],
"temporal_scope": {
"start_date": "2016-10-01",
"end_date": null
},
"mapping_notes": "Official crosswalk mapping for ICD-10-CM billing purposes",
"cross_walk_source": "CMS ICD-10-CM Official Guidelines"
},
"valid_start_date": "2016-10-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_4087682",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 4087682,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "E11.9",
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"domain_id": "Condition",
"concept_class_id": "ICD10 code",
"standard_concept": "S",
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
"mapping_quality": {
"confidence_score": 0.94,
"equivalence_type": "exact",
"semantic_similarity": 0.92,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2023-08-20"
},
"mapping_context": {
"use_case": "clinical",
"geographic_scope": ["International"],
"mapping_notes": "WHO ICD-10 standard mapping for international use",
"cross_walk_source": "WHO ICD-10 Reference"
},
"valid_start_date": "1990-01-01",
"valid_end_date": "2099-12-31"
},
{
"mapping_id": "map_201826_25001",
"mapping_type": "Maps to",
"direction": "outgoing",
"target_concept": {
"concept_id": 25001,
"concept_name": "Type II diabetes mellitus",
"concept_code": "250.00",
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"domain_id": "Condition",
"concept_class_id": "4-dig billing code",
"standard_concept": "S",
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
},
"mapping_quality": {
"confidence_score": 0.91,
"equivalence_type": "exact",
"semantic_similarity": 0.89,
"mapping_source": "official",
"validation_status": "validated",
"last_reviewed_date": "2014-09-30"
},
"valid_start_date": "1970-01-01",
"valid_end_date": "2014-09-30"
}
],
"mapping_summary": {
"total_mappings": 12,
"outgoing_mappings": 8,
"incoming_mappings": 4,
"target_vocabularies": [
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"mapping_count": 3
},
{
"vocabulary_id": "ICD10",
"vocabulary_name": "International Classification of Diseases, Tenth Revision",
"mapping_count": 2
},
{
"vocabulary_id": "ICD9CM",
"vocabulary_name": "International Classification of Diseases, Ninth Revision, Clinical Modification",
"mapping_count": 7
}
],
"mapping_type_distribution": {
"Maps to": 8,
"Mapped from": 4
},
"quality_distribution": {
"exact": 7,
"broader": 3,
"narrower": 1,
"related": 1
},
"coverage_analysis": {
"well_mapped_vocabularies": ["ICD10CM", "ICD10", "ICD9CM"],
"poorly_mapped_vocabularies": [],
"unmapped_domains": []
}
}
},
"meta": {
"pagination": {
"page": 1,
"page_size": 100,
"total_items": 12,
"total_pages": 1,
"has_next": false,
"has_previous": false
},
"query_time_ms": 87.3,
"request_id": "req_mappings_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
const mappings = await fetch('/v1/concepts/201826/mappings');
const icdMappings = await fetch('/v1/concepts/201826/mappings?target_vocabularies=ICD10CM,ICD10');
const qualityMappings = await fetch('/v1/concepts/201826/mappings?include_mapping_quality=true&sort_by=mapping_quality&sort_order=desc');
const outgoingMappings = await fetch('/v1/concepts/201826/mappings?direction=outgoing');
const detailedMappings = await fetch('/v1/concepts/201826/mappings?include_mapping_quality=true&include_context=true&include_synonyms=true&include_indirect=true');
Was this page helpful?