Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?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": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 125847,
      "total_pages": 12585,
      "has_next": true,
      "has_previous": false
    }
  }
}
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

​
search
string
Search term to filter concepts by name or code.
​
page
integer
default:"1"
Page number for pagination (1-based, max 1000). For large vocabularies, use the search parameter to filter results instead of deep pagination.
​
page_size
integer
default:"20"
Number of concepts per page (max 1000).
​
standard_concept
string
default:"all"
Filter by standard concept status. Options: S (standard), C (classification), all.
​
include_invalid
boolean
default:"true"
Include invalid or deprecated concepts.
​
include_relationships
boolean
default:"false"
Include concept relationships in response.
​
include_synonyms
boolean
default:"false"
Include concept synonyms in response.
​
sort_by
string
default:"name"
Sort field. Options: name, concept_id, concept_code.
​
sort_order
string
default:"asc"
Sort order. Options: asc, desc.
​
vocab_release
string
Specific vocabulary release version to query
Example: 2025.1

​
Response

​
success
boolean
Indicates if the request was successful.
​
data
object
Response data container.
​
meta
object
Response metadata.
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?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": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 125847,
      "total_pages": 12585,
      "has_next": true,
      "has_previous": false
    }
  }
}

​
Usage Examples

​
Basic List

Get concepts from a vocabulary: 
GET /v1/vocabularies/SNOMED/concepts?page_size=50

​
Search Within Vocabulary

Search for concepts by name: 
GET /v1/vocabularies/SNOMED/concepts?search=diabetes&standard_concept=S

​
With Sorting

Sort by concept name descending: 
GET /v1/vocabularies/RxNorm/concepts?sort_by=name&sort_order=desc

​
Include Additional Data

Include relationships and synonyms: 
GET /v1/vocabularies/SNOMED/concepts?include_relationships=true&include_synonyms=true