Skip to main content

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

array
required
Array of mapping requests (1-50 items)
Mapping batches are capped at 50 requests because each request can contain multiple source_concepts and performs mapping work for every source concept. Hierarchy and relationship batches allow 100 entries because each entry addresses one concept.

Query Parameters

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

Response

boolean
required
Indicates if the batch request was processed successfully
array
required
Array of mapping results matching the input order
object
required
Response metadata and API information

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