Skip to main content

Overview

This endpoint allows you to perform multiple relationship-related queries for multiple concepts in a single API call. It supports different operation types: relationships, related, and traverse.

Request Body

queries
array
required
Array of relationship query requests (1-100 queries)

Query Parameters

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

Response

success
boolean
required
Indicates whether the overall batch request was successful
data
array
required
Array of query results matching the input order
meta
object
required
Response metadata

Usage Examples

Basic Batch Query

Get relationships for multiple concepts:

Filtered by Relationship Type

Get only mapping relationships:

Mixed Operations

Combine different operations in one batch:

Important Notes

  • Batch size limit: Maximum 100 queries per batch request
  • Performance optimization: Batch processing is significantly more efficient than individual requests
  • Error isolation: Individual query failures don’t affect other queries in the batch
  • Result matching: Use query_id to match results to your input queries
  • Rate limiting: Batch requests count as single requests for rate limiting purposes