Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/domains?vocabulary_ids=SNOMED,ICD10CM&include_counts=true&include_examples=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": [
    {
      "domain_id": "Condition",
      "domain_name": "Condition",
      "domain_concept_id": 19,
      "description": "A condition is a clinical or pathological state or episode that is observable, measurable, and is considered clinically significant for a patient's health status, clinical care or research purposes.",
      "total_concepts": 125643,
      "vocabulary_breakdown": [
        {
          "vocabulary_id": "SNOMED",
          "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
          "concept_count": 98765,
          "percentage": 78.6
        },
        {
          "vocabulary_id": "ICD10CM",
          "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
          "concept_count": 26878,
          "percentage": 21.4
        }
      ],
      "example_concepts": [
        "Type 2 diabetes mellitus",
        "Essential hypertension",
        "Acute myocardial infarction",
        "Pneumonia, unspecified organism",
        "Chronic obstructive pulmonary disease"
      ]
    },
    {
      "domain_id": "Procedure",
      "domain_name": "Procedure",
      "domain_concept_id": 10,
      "description": "A procedure is an activity directed at or performed on a patient with the intention of diagnosing, treating, or preventing a condition.",
      "total_concepts": 87321,
      "vocabulary_breakdown": [
        {
          "vocabulary_id": "SNOMED",
          "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
          "concept_count": 65432,
          "percentage": 74.9
        },
        {
          "vocabulary_id": "ICD10PCS",
          "vocabulary_name": "International Classification of Diseases, Tenth Revision, Procedure Coding System",
          "concept_count": 21889,
          "percentage": 25.1
        }
      ],
      "example_concepts": [
        "Coronary artery bypass graft",
        "Appendectomy",
        "Chest radiography",
        "Blood glucose measurement",
        "Surgical repair of inguinal hernia"
      ]
    }
  ],
  "meta": {
    "request_id": "req_vocab_domains_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "filters_applied": {
      "vocabulary_ids": ["SNOMED", "ICD10CM"],
      "min_concept_count": 1000,
      "include_counts": true,
      "include_examples": true
    },
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 18,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "vocab_release": "2025.2"
  }
}

Overview

This endpoint returns all OMOP domains that contain concepts from any vocabulary, providing a cross-vocabulary view of domain distribution with optional concept counts and filtering.

Query Parameters

vocabulary_ids
string
Filter domains to those containing concepts from specific vocabularies
Examples: SNOMED, SNOMED,ICD10CM, LOINC,RXNORM
include_counts
boolean
default:"false"
Include concept counts for each domain
min_concept_count
integer
default:"1"
Only include domains with at least this many concepts
include_examples
boolean
default:"false"
Include example concept names for each domain
page
integer
default:"1"
Page number for pagination
page_size
integer
default:"50"
Number of domains per page (max 100)
vocab_release
string
Specific vocabulary release version

Response

success
boolean
Indicates if the request was successful
data
array
Array of domain objects with vocabulary-specific information
meta
object
curl -X GET "https://api.omophub.com/v1/vocabularies/domains?vocabulary_ids=SNOMED,ICD10CM&include_counts=true&include_examples=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": [
    {
      "domain_id": "Condition",
      "domain_name": "Condition",
      "domain_concept_id": 19,
      "description": "A condition is a clinical or pathological state or episode that is observable, measurable, and is considered clinically significant for a patient's health status, clinical care or research purposes.",
      "total_concepts": 125643,
      "vocabulary_breakdown": [
        {
          "vocabulary_id": "SNOMED",
          "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
          "concept_count": 98765,
          "percentage": 78.6
        },
        {
          "vocabulary_id": "ICD10CM",
          "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
          "concept_count": 26878,
          "percentage": 21.4
        }
      ],
      "example_concepts": [
        "Type 2 diabetes mellitus",
        "Essential hypertension",
        "Acute myocardial infarction",
        "Pneumonia, unspecified organism",
        "Chronic obstructive pulmonary disease"
      ]
    },
    {
      "domain_id": "Procedure",
      "domain_name": "Procedure",
      "domain_concept_id": 10,
      "description": "A procedure is an activity directed at or performed on a patient with the intention of diagnosing, treating, or preventing a condition.",
      "total_concepts": 87321,
      "vocabulary_breakdown": [
        {
          "vocabulary_id": "SNOMED",
          "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
          "concept_count": 65432,
          "percentage": 74.9
        },
        {
          "vocabulary_id": "ICD10PCS",
          "vocabulary_name": "International Classification of Diseases, Tenth Revision, Procedure Coding System",
          "concept_count": 21889,
          "percentage": 25.1
        }
      ],
      "example_concepts": [
        "Coronary artery bypass graft",
        "Appendectomy",
        "Chest radiography",
        "Blood glucose measurement",
        "Surgical repair of inguinal hernia"
      ]
    }
  ],
  "meta": {
    "request_id": "req_vocab_domains_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "filters_applied": {
      "vocabulary_ids": ["SNOMED", "ICD10CM"],
      "min_concept_count": 1000,
      "include_counts": true,
      "include_examples": true
    },
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 18,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "vocab_release": "2025.2"
  }
}

Usage Examples

Basic Domain List

Get all domains with concepts:
curl -X GET "https://api.omophub.com/v1/vocabularies/domains" \
  -H "Authorization: Bearer YOUR_API_KEY"

SNOMED Domains with Counts

Get domains containing SNOMED concepts with statistics:
curl -X GET "https://api.omophub.com/v1/vocabularies/domains?vocabulary_ids=SNOMED&include_counts=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Large Domains Only

Get domains with at least 10,000 concepts:
curl -X GET "https://api.omophub.com/v1/vocabularies/domains?min_concept_count=10000&include_counts=true&include_examples=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Multiple Vocabularies Comparison

Compare domain coverage across vocabularies:
curl -X GET "https://api.omophub.com/v1/vocabularies/domains?vocabulary_ids=SNOMED,ICD10CM,LOINC&include_counts=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Domain Categories

Common domains across healthcare vocabularies:

Clinical Domains

  • Condition: Diseases, disorders, and clinical findings
  • Procedure: Medical procedures and interventions
  • Observation: Clinical observations and assessments
  • Measurement: Quantitative test results and vital signs

Pharmaceutical Domains

  • Drug: Medications and pharmaceutical products
  • Device: Medical devices and equipment
  • Specimen: Biological specimens and samples

Administrative Domains

  • Visit: Healthcare encounters and visit types
  • Provider: Healthcare provider roles and specialties
  • Payer: Insurance and payment-related concepts
  • Cost: Healthcare cost and pricing information
I