Skip to main content
curl -X POST "https://api.omophub.com/v1/concepts/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "concept_ids": [320128, 201826, 4329847],
    "include_relationships": true,
    "include_synonyms": true
  }'
{
  "success": true,
  "data": {
    "concepts": [
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "concept_code": "59621000",
        "vocabulary_id": "SNOMED",
        "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,
        "synonyms": [
          {
            "concept_synonym_name": "Primary hypertension",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Idiopathic hypertension",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 316866,
            "target_concept_name": "Hypertensive disorder",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "outbound"
          }
        ]
      },
      {
        "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",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "synonyms": [
          {
            "concept_synonym_name": "Type II diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Adult-onset diabetes",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 73211009,
            "target_concept_name": "Diabetes mellitus",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "outbound"
          }
        ]
      },
      {
        "concept_id": 4329847,
        "concept_name": "Myocardial infarction",
        "concept_code": "22298006",
        "vocabulary_id": "SNOMED",
        "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,
        "synonyms": [
          {
            "concept_synonym_name": "Heart attack",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "MI - Myocardial infarction",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 134057,
            "target_concept_name": "Acute myocardial infarction",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "inbound"
          }
        ]
      }
    ],
    "failed_concepts": [],
    "summary": {
      "total_requested": 3,
      "successful_retrievals": 3,
      "failed_retrievals": 0,
      "vocabularies_represented": ["SNOMED"],
      "domains_represented": ["Condition"]
    }
  },
  "meta": {
    "request_id": "req_batch_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "query_time_ms": 45.2
  }
}

Overview

Efficiently retrieve information for multiple concepts at once. This endpoint is optimized for bulk operations and reduces the number of API calls needed.

Request Body

concept_ids
array
required
Array of concept IDs to retrieve (max: 1000)
include_relationships
boolean
default:"false"
Include relationships for all concepts
include_synonyms
boolean
default:"false"
Include synonyms for all concepts
include_mappings
boolean
default:"false"
Include cross-vocabulary mappings for all concepts
vocabulary_filter
array
Filter results to specific vocabularies
standard_only
boolean
default:"true"
Only return standard concepts
curl -X POST "https://api.omophub.com/v1/concepts/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "concept_ids": [320128, 201826, 4329847],
    "include_relationships": true,
    "include_synonyms": true
  }'
{
  "success": true,
  "data": {
    "concepts": [
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "concept_code": "59621000",
        "vocabulary_id": "SNOMED",
        "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,
        "synonyms": [
          {
            "concept_synonym_name": "Primary hypertension",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Idiopathic hypertension",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 316866,
            "target_concept_name": "Hypertensive disorder",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "outbound"
          }
        ]
      },
      {
        "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",
        "valid_start_date": "1970-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "synonyms": [
          {
            "concept_synonym_name": "Type II diabetes mellitus",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "Adult-onset diabetes",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 73211009,
            "target_concept_name": "Diabetes mellitus",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "outbound"
          }
        ]
      },
      {
        "concept_id": 4329847,
        "concept_name": "Myocardial infarction",
        "concept_code": "22298006",
        "vocabulary_id": "SNOMED",
        "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,
        "synonyms": [
          {
            "concept_synonym_name": "Heart attack",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          },
          {
            "concept_synonym_name": "MI - Myocardial infarction",
            "language_concept_id": 4180186,
            "language_concept_name": "English"
          }
        ],
        "relationships": [
          {
            "relationship_id": "Is a",
            "target_concept_id": 134057,
            "target_concept_name": "Acute myocardial infarction",
            "target_vocabulary_id": "SNOMED",
            "relationship_direction": "inbound"
          }
        ]
      }
    ],
    "failed_concepts": [],
    "summary": {
      "total_requested": 3,
      "successful_retrievals": 3,
      "failed_retrievals": 0,
      "vocabularies_represented": ["SNOMED"],
      "domains_represented": ["Condition"]
    }
  },
  "meta": {
    "request_id": "req_batch_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "query_time_ms": 45.2
  }
}
I