Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?domain=Condition&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "invalid_reason": null,
        "valid_start_date": "2002-01-31",
        "valid_end_date": "2099-12-31"
      },
      {
        "concept_id": 201254,
        "concept_name": "Hypertensive disorder",
        "concept_code": "38341003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "invalid_reason": null,
        "valid_start_date": "2002-01-31",
        "valid_end_date": "2099-12-31"
      }
    ]
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 125847,
      "total_pages": 12585,
      "has_next": true,
      "has_previous": false
    },
    "request_id": "req_vocab_concepts_def456",
    "timestamp": "2024-12-22T10:31:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

Retrieve concepts that belong to a specific vocabulary with optional filtering and pagination.

​
Path Parameters

​
vocabularyId
string
required
The vocabulary identifier (e.g., “SNOMED”, “ICD10CM”, “LOINC”, “RxNorm”)

​
Query Parameters

​
domain
string
Filter by medical domain (e.g., “Condition”, “Procedure”, “Drug”)
​
concept_class
string
Filter by concept class (e.g., “Clinical Finding”, “Procedure”)
​
include_invalid
boolean
default:"false"
Include invalid or deprecated concepts
​
page
integer
default:"1"
Page number for pagination (1-based)
​
page_size
integer
default:"50"
Maximum number of concepts to return (max: 1000)

​
Examples

​
Get SNOMED Conditions

curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?domain=Condition&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "invalid_reason": null,
        "valid_start_date": "2002-01-31",
        "valid_end_date": "2099-12-31"
      },
      {
        "concept_id": 201254,
        "concept_name": "Hypertensive disorder",
        "concept_code": "38341003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "invalid_reason": null,
        "valid_start_date": "2002-01-31",
        "valid_end_date": "2099-12-31"
      }
    ]
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 125847,
      "total_pages": 12585,
      "has_next": true,
      "has_previous": false
    },
    "request_id": "req_vocab_concepts_def456",
    "timestamp": "2024-12-22T10:31:00Z",
    "vocab_release": "2025.2"
  }
}
⌘I