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

# Retrieve multiple datasets in a batch, optionally with scores

`POST /v3/api1/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.

`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.

## Query parameters

- `offset` 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'

## 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

- BatchResponse
  - `version` string, required
  - `system_model` string, required
  - `total` integer
  - `offset` integer, required
  - `limit` integer, required
  - `datasets` Dataset[]
    - `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
    - `ecoquery_url` string, required
    - `ecoquery_history_url` 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)