Skip to main content
GET
https://api.omophub.com
/
v1
/
vocabularies
/
concept-classes
curl -X GET "https://api.omophub.com/v1/vocabularies/concept-classes?vocabulary_id=SNOMED&include_stats=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "success": true,
  "data": {
    "concept_classes": [
      {
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "concept_class_concept_id": 404684003,
        "concept_count": 125847,
        "vocabulary_id": "SNOMED",
        "description": "A clinical finding represents a result of an observation, assessment, or judgment"
      },
      {
        "concept_class_id": "Procedure",
        "concept_class_name": "Procedure",
        "concept_class_concept_id": 71388002,
        "concept_count": 87234,
        "vocabulary_id": "SNOMED",
        "description": "A procedure is an act of care provided to a patient"
      },
      {
        "concept_class_id": "Substance",
        "concept_class_name": "Substance",
        "concept_class_concept_id": 105590001,
        "concept_count": 45692,
        "vocabulary_id": "SNOMED",
        "description": "A substance is a physical material or chemical compound"
      }
    ]
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 89,
      "total_pages": 5,
      "has_next": true,
      "has_previous": false
    },
    "request_id": "req_vocab_classes_abc123",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

This endpoint returns all OMOP concept classes from vocabularies, providing insights into the classification structure of medical concepts. Concept classes group related concepts and help understand the semantic organization of medical terminology.

​
Query Parameters

​
vocabulary_id
string
Filter concept classes by specific vocabulary ID (e.g., “SNOMED”, “ICD10CM”)
​
include_stats
boolean
default:"false"
Include concept count statistics for each class
​
include_invalid
boolean
default:"false"
Include invalid/deprecated concept classes
​
vocab_release
string
Specific vocabulary release version (e.g., “2024.1”)
​
page
integer
default:"1"
Page number for pagination (1-based)
​
page_size
integer
default:"20"
Number of concept classes per page

​
Response

​
success
boolean
required
Indicates whether the request was successful
​
concept_classes
array
required
Array of concept classes with their details
​
meta
object
required
Response metadata including pagination
curl -X GET "https://api.omophub.com/v1/vocabularies/concept-classes?vocabulary_id=SNOMED&include_stats=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "success": true,
  "data": {
    "concept_classes": [
      {
        "concept_class_id": "Clinical Finding",
        "concept_class_name": "Clinical Finding",
        "concept_class_concept_id": 404684003,
        "concept_count": 125847,
        "vocabulary_id": "SNOMED",
        "description": "A clinical finding represents a result of an observation, assessment, or judgment"
      },
      {
        "concept_class_id": "Procedure",
        "concept_class_name": "Procedure",
        "concept_class_concept_id": 71388002,
        "concept_count": 87234,
        "vocabulary_id": "SNOMED",
        "description": "A procedure is an act of care provided to a patient"
      },
      {
        "concept_class_id": "Substance",
        "concept_class_name": "Substance",
        "concept_class_concept_id": 105590001,
        "concept_count": 45692,
        "vocabulary_id": "SNOMED",
        "description": "A substance is a physical material or chemical compound"
      }
    ]
  },
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 89,
      "total_pages": 5,
      "has_next": true,
      "has_previous": false
    },
    "request_id": "req_vocab_classes_abc123",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

​
Usage Examples

​
Get All Concept Classes

Retrieve all concept classes across all vocabularies: 
curl -X GET "https://api.omophub.com/v1/vocabularies/concept-classes" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get SNOMED Concept Classes with Statistics

Get concept classes from SNOMED with count statistics: 
curl -X GET "https://api.omophub.com/v1/vocabularies/concept-classes?vocabulary_id=SNOMED&include_stats=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Filter by Multiple Vocabularies

Get concept classes from specific vocabularies: 
curl -X GET "https://api.omophub.com/v1/vocabularies/concept-classes?vocabulary_id=SNOMED,ICD10CM&include_stats=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Important Notes

  • Concept classes group related concepts and define their semantic type
  • Statistics are available when include_stats=true but may impact response time
  • Pagination is recommended for large result sets
  • Invalid classes are excluded by default but can be included with include_invalid=true
  • Vocabulary versions can be specified using the vocab_release parameter