Skip to main content
curl -X GET "https://api.omophub.com/v1/mappings/coverage?source_vocabulary=SNOMED&target_vocabulary=ICD10CM" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "source_vocabulary": "SNOMED",
    "target_vocabulary": "ICD10CM",
    "domain_coverage": [
      {
        "domain_id": "Condition",
        "domain_name": "Condition",
        "source_concepts": 234567,
        "mapped_concepts": 178234,
        "coverage_percentage": 75.9
      },
      {
        "domain_id": "Procedure",
        "domain_name": "Procedure",
        "source_concepts": 89234,
        "mapped_concepts": 45678,
        "coverage_percentage": 51.2
      },
      {
        "domain_id": "Observation",
        "domain_name": "Observation",
        "source_concepts": 45678,
        "mapped_concepts": 12345,
        "coverage_percentage": 27.0
      }
    ],
    "overall_coverage": 65.5,
    "unmapped_concepts": [
      {
        "concept_id": 4087682,
        "concept_name": "Finding related to ability to move",
        "domain_id": "Condition",
        "reason": "No direct mapping"
      },
      {
        "concept_id": 4273391,
        "concept_name": "Coronary artery bypass graft",
        "domain_id": "Procedure",
        "reason": "No direct mapping"
      }
    ]
  },
  "meta": {
    "request_id": "req_coverage_abc123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

This endpoint analyzes mapping coverage between two vocabularies, providing domain-level breakdown and identifying unmapped concepts. Useful for understanding interoperability between vocabulary pairs.

​
Query Parameters

​
source_vocabulary
string
required
Source vocabulary ID to analyze mappings from
Example: SNOMED
​
target_vocabulary
string
required
Target vocabulary ID to analyze mappings to
Example: ICD10CM
​
domain_ids
string
Comma-separated domain IDs to filter the analysis
Example: Condition,Drug
​
vocab_release
string
Specific vocabulary release version (e.g., “2025.1”)

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
object
required
Coverage analysis results
​
meta
object
required
Response metadata and API information
curl -X GET "https://api.omophub.com/v1/mappings/coverage?source_vocabulary=SNOMED&target_vocabulary=ICD10CM" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "source_vocabulary": "SNOMED",
    "target_vocabulary": "ICD10CM",
    "domain_coverage": [
      {
        "domain_id": "Condition",
        "domain_name": "Condition",
        "source_concepts": 234567,
        "mapped_concepts": 178234,
        "coverage_percentage": 75.9
      },
      {
        "domain_id": "Procedure",
        "domain_name": "Procedure",
        "source_concepts": 89234,
        "mapped_concepts": 45678,
        "coverage_percentage": 51.2
      },
      {
        "domain_id": "Observation",
        "domain_name": "Observation",
        "source_concepts": 45678,
        "mapped_concepts": 12345,
        "coverage_percentage": 27.0
      }
    ],
    "overall_coverage": 65.5,
    "unmapped_concepts": [
      {
        "concept_id": 4087682,
        "concept_name": "Finding related to ability to move",
        "domain_id": "Condition",
        "reason": "No direct mapping"
      },
      {
        "concept_id": 4273391,
        "concept_name": "Coronary artery bypass graft",
        "domain_id": "Procedure",
        "reason": "No direct mapping"
      }
    ]
  },
  "meta": {
    "request_id": "req_coverage_abc123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Usage Examples

​
Basic Coverage Analysis

Analyze coverage from SNOMED to ICD-10-CM:
TypeScript
const { data: coverage } = await client.get('/mappings/coverage', {
  query: { source_vocabulary: 'SNOMED', target_vocabulary: 'ICD10CM' },
});

​
Filter by Domain

Analyze coverage for specific domains only:
TypeScript
const { data: conditionCoverage } = await client.get('/mappings/coverage', {
  query: {
    source_vocabulary: 'SNOMED',
    target_vocabulary: 'ICD10CM',
    domain_ids: 'Condition,Procedure',
  },
});

​
Use Specific Vocabulary Version

Analyze coverage for a specific vocabulary release:
TypeScript
const { data: coverage } = await client.get('/mappings/coverage', {
  query: {
    source_vocabulary: 'SNOMED',
    target_vocabulary: 'ICD10CM',
    vocab_release: '2025.1',
  },
});

​
Notes

  • Both source_vocabulary and target_vocabulary are required parameters
  • The unmapped_concepts array contains a sample of up to 100 unmapped concepts
  • Coverage percentages are calculated based on valid, non-deprecated concepts
  • Use domain_ids to focus analysis on specific medical domains