Skip to main content
curl -X POST "https://api.omophub.com/v1/concepts/map/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mapping_requests": [
      {
        "request_id": "diabetes_icd10",
        "source_concepts": [201826, 443735],
        "target_vocabulary": "ICD10CM"
      },
      {
        "request_id": "hypertension_snomed",
        "source_concepts": [4182210],
        "target_vocabulary": "SNOMED"
      }
    ]
  }'

{
  "success": true,
  "data": [
    {
      "request_id": "diabetes_icd10",
      "source_concepts": [201826, 443735],
      "target_vocabulary": "ICD10CM",
      "mappings": [
        {
          "source_concept_id": 201826,
          "target_concept_id": 443735,
          "target_concept_name": "Type 2 diabetes mellitus without complications",
          "target_concept_code": "E11.9",
          "relationship_id": "Maps to"
        }
      ],
      "success": true,
      "error": null,
      "request_index": 0
    },
    {
      "request_id": "hypertension_snomed",
      "source_concepts": [4182210],
      "target_vocabulary": "SNOMED",
      "mappings": [
        {
          "source_concept_id": 4182210,
          "target_concept_id": 316866,
          "target_concept_name": "Hypertensive disorder",
          "target_concept_code": "38341003",
          "relationship_id": "Maps to"
        }
      ],
      "success": true,
      "error": null,
      "request_index": 1
    }
  ],
  "meta": {
    "request_id": "req_batch_abc123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

This endpoint allows you to perform multiple concept mapping operations in a single API call. Each mapping request maps a set of source concepts to a target vocabulary, enabling efficient bulk processing.

​
Request Body

​
mapping_requests
array
required
Array of mapping requests (1-50 items)

​
Query Parameters

​
vocab_release
string
Specific vocabulary release version (e.g., “2025.1”)

​
Response

​
success
boolean
required
Indicates if the batch request was processed successfully
​
data
array
required
Array of mapping results matching the input order
​
meta
object
required
Response metadata and API information
curl -X POST "https://api.omophub.com/v1/concepts/map/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mapping_requests": [
      {
        "request_id": "diabetes_icd10",
        "source_concepts": [201826, 443735],
        "target_vocabulary": "ICD10CM"
      },
      {
        "request_id": "hypertension_snomed",
        "source_concepts": [4182210],
        "target_vocabulary": "SNOMED"
      }
    ]
  }'

{
  "success": true,
  "data": [
    {
      "request_id": "diabetes_icd10",
      "source_concepts": [201826, 443735],
      "target_vocabulary": "ICD10CM",
      "mappings": [
        {
          "source_concept_id": 201826,
          "target_concept_id": 443735,
          "target_concept_name": "Type 2 diabetes mellitus without complications",
          "target_concept_code": "E11.9",
          "relationship_id": "Maps to"
        }
      ],
      "success": true,
      "error": null,
      "request_index": 0
    },
    {
      "request_id": "hypertension_snomed",
      "source_concepts": [4182210],
      "target_vocabulary": "SNOMED",
      "mappings": [
        {
          "source_concept_id": 4182210,
          "target_concept_id": 316866,
          "target_concept_name": "Hypertensive disorder",
          "target_concept_code": "38341003",
          "relationship_id": "Maps to"
        }
      ],
      "success": true,
      "error": null,
      "request_index": 1
    }
  ],
  "meta": {
    "request_id": "req_batch_abc123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Important Notes

  • Batch size limit: Maximum 50 mapping requests per batch
  • Error isolation: Individual mapping failures don’t affect other mappings in the batch
  • Result ordering: Results are returned in the same order as input requests
  • Request IDs: Use unique request_id values to correlate results with your input