Skip to main content
GET
/
v1
/
domains
/
{domain_id}
/
concepts
curl -X GET "https://api.omophub.com/v1/domains/Condition/concepts?search=diabetes&vocabulary_ids=SNOMED&include_synonyms=true&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "domain": {
      "domain_id": "Condition",
      "domain_name": "Condition",
      "description": "Medical conditions, diseases, disorders, and clinical findings",
      "total_concepts_in_domain": 845672
    },
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z",
        "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"
          },
          {
            "concept_synonym_name": "Non-insulin dependent diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationship_summary": {
          "total_relationships": 47,
          "relationship_types": ["Is a", "Maps to", "Has associated morphology"],
          "has_hierarchy": true,
          "has_mappings": true
        },
        "hierarchy_info": {
          "has_parents": true,
          "has_children": true,
          "hierarchy_level": 4,
          "top_level_ancestor": {
            "concept_id": 404684003,
            "concept_name": "Clinical finding"
          }
        }
      },
      {
        "concept_id": 46635009,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z",
        "synonyms": [
          {
            "concept_synonym_name": "Type I diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Insulin-dependent diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Juvenile diabetes",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationship_summary": {
          "total_relationships": 42,
          "relationship_types": ["Is a", "Maps to", "Has associated morphology"],
          "has_hierarchy": true,
          "has_mappings": true
        },
        "hierarchy_info": {
          "has_parents": true,
          "has_children": true,
          "hierarchy_level": 4,
          "top_level_ancestor": {
            "concept_id": 404684003,
            "concept_name": "Clinical finding"
          }
        }
      }
    ],
    "filters_applied": {
      "vocabulary_filter": ["SNOMED"],
      "search_term": "diabetes",
      "search_type": "fuzzy"
    },
    "domain_statistics": {
      "concepts_returned": 50,
      "total_matching_concepts": 847,
      "vocabulary_distribution": {
        "SNOMED": 847
      },
      "concept_class_distribution": {
        "Clinical Finding": 723,
        "Disorder": 124
      },
      "standard_concept_distribution": {
        "S": 612,
        "C": 89,
        "null": 146
      }
    }
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 847,
      "total_pages": 17,
      "has_next": true,
      "has_previous": false
    },
    "query_time_ms": 124.5,
    "request_id": "req_domain_concepts_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}
This endpoint provides access to all medical concepts within a particular domain, such as all conditions, drugs, or procedures. It supports comprehensive filtering and search to help users find relevant concepts within the domain scope.

​
Path Parameters

​
domain_id
string
required
The domain identifier to retrieve concepts from
Example: Condition, Drug, Procedure

​
Query Parameters

​
vocabulary_ids
string
Filter concepts to specific vocabularies within the domain
Example: SNOMED,ICD10CM
​
concept_class_ids
string
Filter to specific concept classes within the domain
Example: Clinical Finding,Disorder
​
standard_concept
string
Filter by standard concept designation. Three behaviors:
  • Omitting the parameter: applies no filter (returns both standard and non-standard concepts)

  • Passing "S" or "C": filters to standard-only or classification-only respectively

  • Passing "null" (string): returns non-standard-only concepts. For GET query params, use the literal string value null (e.g., ?standard_concept=null).

Options: S, C, "null" (literal string)
Default (when omitted): no filter (returns standard + classification + non-standard).
​
search
string
Search term to filter concepts by name or synonyms
Example: diabetes
​
search_type
string
default:"fuzzy"
Type of search to perform
Options: exact, prefix, fuzzy, semantic
​
include_invalid
boolean
default:"false"
Include invalid/deprecated concepts in results
​
include_synonyms
boolean
default:"false"
Include synonym information for each concept
​
include_relationships
boolean
default:"false"
Include relationship counts and types for each concept
​
include_hierarchy
boolean
default:"false"
Include hierarchical parent/child information
​
min_concept_id
integer
Filter to concepts with IDs greater than or equal to this value
​
max_concept_id
integer
Filter to concepts with IDs less than or equal to this value
​
valid_start_date
string
Filter to concepts valid after this date (ISO format)
​
valid_end_date
string
Filter to concepts valid before this date (ISO format)
​
sort_by
string
default:"concept_name"
Sort concepts by specified field
Options: concept_name, concept_id, concept_code, valid_start_date
​
sort_order
string
default:"asc"
Sort order for results
Options: asc, desc
​
page_size
integer
default:"100"
Number of concepts to return per page (max 1000)
​
page
integer
default:"1"
Page number for pagination (1-based)

​
Response

​
domain
object
Information about the domain being queried
​
concepts
array
Array of concept objects within the domain
​
filters_applied
object
Summary of filters applied to the query
​
domain_statistics
object
Statistics about the filtered result set
​
meta
object
Response metadata and pagination information
curl -X GET "https://api.omophub.com/v1/domains/Condition/concepts?search=diabetes&vocabulary_ids=SNOMED&include_synonyms=true&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "domain": {
      "domain_id": "Condition",
      "domain_name": "Condition",
      "description": "Medical conditions, diseases, disorders, and clinical findings",
      "total_concepts_in_domain": 845672
    },
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z",
        "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"
          },
          {
            "concept_synonym_name": "Non-insulin dependent diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationship_summary": {
          "total_relationships": 47,
          "relationship_types": ["Is a", "Maps to", "Has associated morphology"],
          "has_hierarchy": true,
          "has_mappings": true
        },
        "hierarchy_info": {
          "has_parents": true,
          "has_children": true,
          "hierarchy_level": 4,
          "top_level_ancestor": {
            "concept_id": 404684003,
            "concept_name": "Clinical finding"
          }
        }
      },
      {
        "concept_id": 46635009,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z",
        "synonyms": [
          {
            "concept_synonym_name": "Type I diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Insulin-dependent diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Juvenile diabetes",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationship_summary": {
          "total_relationships": 42,
          "relationship_types": ["Is a", "Maps to", "Has associated morphology"],
          "has_hierarchy": true,
          "has_mappings": true
        },
        "hierarchy_info": {
          "has_parents": true,
          "has_children": true,
          "hierarchy_level": 4,
          "top_level_ancestor": {
            "concept_id": 404684003,
            "concept_name": "Clinical finding"
          }
        }
      }
    ],
    "filters_applied": {
      "vocabulary_filter": ["SNOMED"],
      "search_term": "diabetes",
      "search_type": "fuzzy"
    },
    "domain_statistics": {
      "concepts_returned": 50,
      "total_matching_concepts": 847,
      "vocabulary_distribution": {
        "SNOMED": 847
      },
      "concept_class_distribution": {
        "Clinical Finding": 723,
        "Disorder": 124
      },
      "standard_concept_distribution": {
        "S": 612,
        "C": 89,
        "null": 146
      }
    }
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 847,
      "total_pages": 17,
      "has_next": true,
      "has_previous": false
    },
    "query_time_ms": 124.5,
    "request_id": "req_domain_concepts_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Usage Examples

​
All Concepts in a Domain

Get all concepts within the Condition domain: 
const conditions = await fetch('/v1/domains/Condition/concepts?page_size=1000');

​
Search Within Domain

Search for diabetes-related concepts: 
const diabetesConcepts = await fetch('/v1/domains/Condition/concepts?search=diabetes&search_type=semantic');

​
Standard Concepts Only

Get only standard concepts from a domain: 
const standardDrugs = await fetch('/v1/domains/Drug/concepts?standard_concept=S&vocabulary_ids=RxNorm');

​
Concepts from Specific Vocabularies

Get procedures from specific vocabularies: 
const snomedProcedures = await fetch('/v1/domains/Procedure/concepts?vocabulary_ids=SNOMED,RxNorm&include_hierarchy=true');

​
Detailed Concept Information

Get comprehensive concept details: 
const detailedConcepts = await fetch('/v1/domains/Drug/concepts?include_synonyms=true&include_relationships=true&include_hierarchy=true');

​
Notes

  • Domain queries can return very large result sets - use pagination appropriately
  • Search functionality within domains supports fuzzy matching and semantic search
  • Standard concepts (S) are preferred for most clinical applications
  • Hierarchy information helps understand concept relationships within the domain
  • Some concepts may appear in multiple domains through different vocabularies
  • Including synonyms significantly increases response size but improves search capability
  • Vocabulary filtering is essential when working with specific terminology systems
  • Concept classes provide finer-grained categorization within domains