---
title: "Search for datasets in the database"
method: GET
path: "/v0/datasets"
tags: ["api"]
---

# Search for datasets in the database

`GET /v0/datasets`

This endpoint allows searching for datasets using various filters and query parameters. You find a full list of potential filters in the response of your query.

## Query parameters

- `query` string — Free-text search query. You can also provide an activity UUID or product UUID to retrieve the datasets associated with that activity or product.
- `from` integer — Pagination start index
- `limit` integer — Number of results to return
- `sector` string — Industrial Sector i.e. Electricity
- `geography` string — Geography of production for a product/activity
- `isic_section` string — Standard Classification of all Economic activities, level 1 section
- `isic_class` string — Standard Classification of all Economic activities, level 4 class
- `cpc` string — Central product classification, comprehensive classification of all products
- `activity_type` string — Type of activity i.e. market or transforming activity
- `version` string — Version name or 'latest'
- `system_model` string — System model name or 'cutoff'

## Response `200`

Successful search response with matching datasets

- LegacySearchResponse
  - `total` integer
  - `results` 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
  - `filters` Filters
    - `sectors` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `geographies` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `isic_sections` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `isic_classes` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `activity_types` FilterData[], required
      - `name` string, required
      - `count` integer, required
    - `geography_hierarchy` GeographyHierarchyRoot

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