---
title: "Download a free dataset (account required)"
method: GET
path: "/datasets/{id}/download-url"
---

# Download a free dataset (account required)

`GET /datasets/{id}/download-url`

## Request

- Base URL: `https://api.databazaar.io`
- URL: `https://api.databazaar.io/datasets/{id}/download-url`
- Auth: HTTP bearer

Returns a signed download URL for free datasets (price = $0). Account authentication required. For paid datasets, use the purchase flow via /datasets/{id}/buy.

## Path parameters

- `id` string, uuid, required

## Response `200`

JSON with download_url (signed, 1hr expiry) and expires_in

## Other responses

- `401`: Account authentication required
- `402`: Dataset is not free — purchase required
- `403`: Agent owner approval required
- `404`: Dataset not found

---

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