Skip to main content
curl -X GET "https://api.omophub.com/v1/domains/Condition/concepts?vocabulary_ids=SNOMED&standard_only=true&page_size=50" \
  -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",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null
      },
      {
        "concept_id": 46635009,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 847,
      "total_pages": 17,
      "has_next": true,
      "has_previous": false
    }
  }
}
This endpoint provides access to all medical concepts within a particular domain, such as all conditions, drugs, or procedures.

​
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 (comma-separated).
Example: SNOMED,ICD10CM
​
standard_only
boolean
default:"false"
Return only standard concepts (standard_concept = ‘S’).
​
include_invalid
boolean
default:"true"
Include invalid/deprecated concepts in results.
​
page
integer
default:"1"
Page number for pagination (1-based).
​
page_size
integer
default:"20"
Number of concepts to return per page (max 1000).
​
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 and pagination information.
curl -X GET "https://api.omophub.com/v1/domains/Condition/concepts?vocabulary_ids=SNOMED&standard_only=true&page_size=50" \
  -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",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null
      },
      {
        "concept_id": 46635009,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 847,
      "total_pages": 17,
      "has_next": true,
      "has_previous": false
    }
  }
}

​
Usage Examples

​
All Concepts in a Domain

Get all concepts within the Condition domain: 
GET /v1/domains/Condition/concepts?page_size=100

​
Standard Concepts Only

Get only standard concepts from a specific vocabulary: 
GET /v1/domains/Drug/concepts?standard_only=true&vocabulary_ids=RxNorm

​
Filter by Multiple Vocabularies

Get concepts from multiple vocabularies: 
GET /v1/domains/Procedure/concepts?vocabulary_ids=SNOMED,CPT4,HCPCS

​
Include Invalid Concepts

Include deprecated concepts in results: 
GET /v1/domains/Condition/concepts?include_invalid=true

​
Notes

  • Domain queries can return large result sets - use pagination appropriately
  • Standard concepts (S) are preferred for most clinical applications
  • Default page size is 20, maximum is 1000
  • Results are not sorted by default