Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/releases?vocabulary_id=SNOMED&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": [
    {
      "release_id": "snomed_2024_03",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "release_version": "2024.2",
      "release_date": "2024-03-01T00:00:00Z",
      "status": "active",
      "total_concepts": 354652,
      "schema_name": "vocabs_2024_1",
      "is_latest": true,
      "description": "March 2024 International Release"
    },
    {
      "release_id": "snomed_2024_01",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "release_version": "2024-01",
      "release_date": "2024-01-01T00:00:00Z",
      "status": "active",
      "total_concepts": 352890,
      "schema_name": "vocabs_2024_1",
      "is_latest": false,
      "description": "January 2024 International Release"
    }
  ],
  "meta": {
    "request_id": "req_releases123",
    "timestamp": "2024-03-15T10:30:00Z",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}

​
Overview

This endpoint provides information about all vocabulary release versions available in the system, including release dates, status, and version identifiers.

​
Query Parameters

​
vocabulary_id
string
Filter releases for a specific vocabulary (e.g., “SNOMED”, “ICD10CM”)
​
status
string
Filter by release status
Options: active, deprecated, beta
​
page
integer
default:"1"
Page number for pagination
​
page_size
integer
default:"20"
Number of items per page (max 100)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
array
Array of vocabulary release objects
​
meta
object
curl -X GET "https://api.omophub.com/v1/vocabularies/releases?vocabulary_id=SNOMED&status=active" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": [
    {
      "release_id": "snomed_2024_03",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "release_version": "2024.2",
      "release_date": "2024-03-01T00:00:00Z",
      "status": "active",
      "total_concepts": 354652,
      "schema_name": "vocabs_2024_1",
      "is_latest": true,
      "description": "March 2024 International Release"
    },
    {
      "release_id": "snomed_2024_01",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "release_version": "2024-01",
      "release_date": "2024-01-01T00:00:00Z",
      "status": "active",
      "total_concepts": 352890,
      "schema_name": "vocabs_2024_1",
      "is_latest": false,
      "description": "January 2024 International Release"
    }
  ],
  "meta": {
    "request_id": "req_releases123",
    "timestamp": "2024-03-15T10:30:00Z",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}

​
Usage Examples

​
All Releases

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

​
SNOMED Releases Only

Get all SNOMED releases: 
curl -X GET "https://api.omophub.com/v1/vocabularies/releases?vocabulary_id=SNOMED" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Active Releases Only

Get only active releases: 
curl -X GET "https://api.omophub.com/v1/vocabularies/releases?status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"
⌘I