v1

latestOpenAPI 3.1.02026-07-23103037.2 KB
api

Retrieve multiple datasets in a batch, optionally with scores

This endpoint allows retrieving multiple datasets in a batch using their IDs. Optionally, it can also return impact scores for the specified indicators.

POST is used despite this being a read operation because dataset IDs are submitted in the request body: batches can contain up to 1000 IDs, which would exceed practical URL length limits if passed as query parameters.

post/v3/api1/datasets/batch

Query parameters

offsetinteger

Pagination start index

Pagination start index

limitinteger

Number of results to return

Number of results to return

versionstring

Version name or 'latest'

Version name or 'latest'

system_modelstring

System model name or 'cutoff'

System model name or 'cutoff'

Request body

dataset_idsinteger[] required

List of dataset IDs to retrieve (up to 1000 datasets)

indicator_idsinteger[]

List of indicators IDs to retrieve

Response

Successful search response with matching datasets

versionstring required
system_modelstring required
totalinteger
offsetinteger required
limitinteger required