---
title: "Get dataset download URLs"
method: GET
path: "/v1/datasets/{datasetId}/downloads"
tags: ["Datasets"]
---

# Get dataset download URLs

`GET /v1/datasets/{datasetId}/downloads`

## Request

- Base URL: `https://api.terranode.co`
- URL: `https://api.terranode.co/v1/datasets/{datasetId}/downloads`
- Auth: API key in header `x-api-key`

Returns presigned download URLs for a dataset version's artifacts: the processed features file, the original upload (if retained), and validation artifacts (rejections, corrections) if applicable.

## Path parameters

- `datasetId` string, uuid, required

## Query parameters

- `version` integer

## Response `200`

Presigned download URLs (valid for 1 hour).

- DownloadsResponse
  - `datasetId` string, uuid, required
  - `version` integer, required
  - `files` object, required
    - `original` string, uri: Original uploaded file (if retained).
    - `features` string, uri, required: Processed features as GeoJSON.
    - `rejections` string, uri: Features rejected during validation.
    - `corrections` string, uri: Features that were repaired during validation.
  - `expiresIn` integer, required: Seconds until download URLs expire (3600).

## Other responses

- `400`: Invalid request parameters or body.
- `401`: Missing or invalid API key.
- `404`: Resource not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/terranode/apis/terranode-geospatial-api.md) · [All operations](https://skmtc.dev/terranode/apis/terranode-geospatial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/terranode/apis/terranode-geospatial-api/revisions/bdd80613bc7a?raw)