> For the complete documentation index, see [llms.txt](https://docs.api.ecoinvent.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.ecoinvent.org/api-reference/datasets.md).

# Datasets

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

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

```json
{"openapi":"3.1.0","info":{"title":"ecoQuery User API","version":"0.0.1"},"servers":[{"url":"https://api.ecoinvent.org"}],"security":[{"OAuth2ClientCredentials":[]}],"components":{"securitySchemes":{"OAuth2ClientCredentials":{"type":"oauth2","flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://sso.ecoinvent.org/realms/ecoinvent/protocol/openid-connect/token"}}}},"schemas":{"Dataset":{"properties":{"id":{"type":"integer","title":"Id","description":"Id of the dataset"},"activity":{"type":"string","title":"Activity"},"product":{"title":"Product","type":"string"},"geography":{"type":"string","title":"Geography"},"description":{"type":"string","title":"Description","default":""},"included_activity_starts":{"title":"Included Activity Starts","description":"Included activity starts","default":"","type":"string"},"included_activity_ends":{"title":"Included Activity Ends","description":"Included activity ends","default":"","type":"string"},"time_period_comment":{"title":"Time Period Comment","description":"Time period comment","default":"","type":"string"},"technology_comment":{"title":"Technology Comment","description":"Technology comment","default":"","type":"string"},"unit":{"title":"Unit","type":"string"},"time_period":{"title":"Time Period","type":"string"},"activity_type":{"$ref":"#/components/schemas/ActivityType","description":"Type of activity, e.g. `TRANSFORMING_ACTIVITY` or `MARKET_ACTIVITY`."},"isic_section":{"title":"Isic Section","description":"Standard Classification of all Economic activities, level 1 section","type":"string"},"isic_class":{"title":"Isic Class","description":"Standard Classification of all Economic activities, level 4 class","type":"string"},"sectors":{"items":{"type":"string"},"type":"array","title":"Sectors","description":"Industrial Sector i.e. Electricity"},"impact_scores":{"title":"Impact Scores","items":{"$ref":"#/components/schemas/ImpactScore"},"type":"array"},"activity_spold_uuid":{"type":"string","title":"Activity Spold Uuid","description":"UUID of the associated activity in spold"},"product_spold_uuid":{"title":"Product Spold Uuid","description":"UUID of the associated product in spold","type":"string"},"geography_spold_uuid":{"type":"string","title":"Geography Spold Uuid","description":"UUID of the associated geography in spold"},"ecoquery_url":{"title":"Ecoquery Url","readOnly":true,"type":"string"},"ecoquery_history_url":{"title":"Ecoquery History Url","readOnly":true,"type":"string"}},"type":"object","required":["id","activity","geography","time_period","activity_type","sectors","activity_spold_uuid","product_spold_uuid","geography_spold_uuid","ecoquery_url","ecoquery_history_url"],"title":"Dataset"},"ActivityType":{"type":"string","enum":["TRANSFORMING_ACTIVITY","MARKET_ACTIVITY","IO_ACTIVITY","RESIDUAL_ACTIVITY","PRODUCTION_MIX","IMPORT_ACTIVITY","SUPPLY_MIX","EXPORT_ACTIVITY","RE_EXPORT_ACTIVITY","CORRECTION_ACTIVITY","MARKET_GROUP"],"title":"ActivityType"},"ImpactScore":{"properties":{"id":{"type":"integer","title":"Id","description":"Id of the indicator"},"score":{"type":"number","title":"Score","description":"Numerical score value"},"unit":{"type":"string","title":"Unit","description":"Unit of measurement for the score"},"method":{"type":"string","title":"Method","description":"LCIA method name"},"category":{"type":"string","title":"Category","description":"Impact category"},"indicator":{"type":"string","title":"Indicator","description":"Impact indicator"}},"type":"object","required":["id","score","unit","method","category","indicator"],"title":"ImpactScore"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v3/api1/datasets/{id}":{"get":{"tags":["api"],"summary":"Retrieve a specific dataset by its ID, optionally with scores","description":"This endpoint allows retrieving a specific dataset using its ID. Optionally, it can also return impact scores for the specified indicators.","operationId":"get_dataset_v3_v3_api1_datasets__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","description":"Dataset ID to retrieve","title":"Id"},"description":"Dataset ID to retrieve"},{"name":"indicator_ids","in":"query","required":false,"schema":{"description":"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.","title":"Indicator Ids","type":"array","items":{"type":"integer"}},"description":"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."},{"name":"version","in":"query","required":false,"schema":{"type":"string","description":"Version name or 'latest'","default":"latest","title":"Version"},"description":"Version name or 'latest'"},{"name":"system_model","in":"query","required":false,"schema":{"type":"string","description":"System model name or 'cutoff'","default":"cutoff","title":"System Model"},"description":"System model name or 'cutoff'"}],"responses":{"200":{"description":"Successful response with the requested dataset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dataset"}}}},"401":{"description":"Unauthorized","content":{"application/json":{}}},"403":{"description":"Forbidden","content":{"application/json":{}}},"404":{"description":"Requested resource not found","content":{"application/json":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{}}}}}}}}
```