---
title: "Retrieve a specific dataset by its ID, optionally with scores"
method: GET
path: "/v3/api1/datasets/{id}"
tags: ["api"]
---

# Retrieve a specific dataset by its ID, optionally with scores

`GET /v3/api1/datasets/{id}`

This endpoint allows retrieving a specific dataset using its ID. Optionally, it can also return impact scores for the specified indicators.

## Path parameters

- `id` integer, required — Dataset ID to retrieve

## Query parameters

- `indicator_ids` integer[] — List of indicator IDs to retrieve. Provide multiple values via repeated query parameters (?indicator_ids=1&indicator_ids=2). Comma-separated values are not supported.
- `version` string — Version name or 'latest'
- `system_model` string — System model name or 'cutoff'

## Response `200`

Successful response with the requested dataset

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