---
title: "Retrieve multiple datasets in a batch, optionally with scores"
method: POST
path: "/v0/datasets/batch"
tags: ["api"]
---

# Retrieve multiple datasets in a batch, optionally with scores

`POST /v0/datasets/batch`

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

## Query parameters

- `from` integer — Pagination start index
- `limit` integer — Number of results to return
- `version` string — Version name or 'latest'
- `system_model` string — System model name or 'cutoff'

## Headers

- `X-User-Id` string
- `X-Organization-Id` string

## Request body

- DatasetBatchRequest
  - `dataset_ids` integer[], required — List of dataset IDs to retrieve (up to 1000 datasets)
  - `indicator_ids` integer[] — List of indicators IDs to retrieve

## Response `200`

Successful search response with matching datasets

- LegacyBatchResponse
  - `total` integer
  - `datasets` LegacyDataset[]
    - `id` integer, required — Id of the dataset
    - `activity` string, required
    - `product` string
    - `geography` string, required
    - `description` string
    - `included_activity_starts` string — Included activity starts
    - `included_activity_ends` string — Included activity ends
    - `time_period_comment` string — Time period comment
    - `technology_comment` string — Technology comment
    - `unit` string
    - `time_period` string, required
    - `activity_type` 'TRANSFORMING_ACTIVITY' | 'MARKET_ACTIVITY' | 'IO_ACTIVITY' | 'RESIDUAL_ACTIVITY' | 'PRODUCTION_MIX' | 'IMPORT_ACTIVITY' | 'SUPPLY_MIX' | 'EXPORT_ACTIVITY' | 'RE_EXPORT_ACTIVITY' | 'CORRECTION_ACTIVITY' | 'MARKET_GROUP', required
    - `isic_section` string — Standard Classification of all Economic activities, level 1 section
    - `isic_class` string — Standard Classification of all Economic activities, level 4 class
    - `sectors` string[], required — Industrial Sector i.e. Electricity
    - `impact_scores` ImpactScore[]
      - `id` integer, required — Id of the indicator
      - `score` number, required — Numerical score value
      - `unit` string, required — Unit of measurement for the score
      - `method` string, required — LCIA method name
      - `category` string, required — Impact category
      - `indicator` string, required — Impact indicator
    - `activity_spold_uuid` string, required — UUID of the associated activity in spold
    - `product_spold_uuid` string, required — UUID of the associated product in spold
    - `geography_spold_uuid` string, required — UUID of the associated geography in spold
    - `url` string, required
    - `url_history` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Requested resource not found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ecoinvent/apis/ecoquery-user-api.md) · [All operations](https://skmtc.dev/ecoinvent/apis/ecoquery-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ecoinvent/ecoquery-user-api/revisions/8a4aea6b7285/schema)