---
title: "Download everything as one file"
method: GET
path: "/download/"
tags: ["Data"]
---

# Download everything as one file

`GET /download/`

## Request

- Base URL: `https://onlygoodantibodies.co.uk/api/v1`
- URL: `https://onlygoodantibodies.co.uk/api/v1/download/`
- Auth: API key in header `X-API-Key`

The whole public dataset as a single zip: every published figure, plus `manifest.csv` naming each one.

**This endpoint answers `302`.** The archive lives in object storage, so the redirect points at a CDN URL that supports range requests and resuming - no bytes pass through the application. Any ordinary HTTP client follows it; `curl` needs `-L`.

The archive is rebuilt when the dataset changes, and its URL carries the dataset version, so a URL you have already fetched is safe to cache indefinitely. Ask this endpoint again to learn the current one.

`503` means a figure has been published since the last build and the archive for this version does not exist yet. Nothing is missing - the manifest is complete throughout, and the reply names it.

Add `?gene=` to get a zip of named genes instead, built on request. A key scoped to part of the dataset always gets a zip built this way rather than a redirect, because the shared archive holds every supplier.

## Query parameters

- `gene` string

## Response `200`

A zip of the requested figures.

## Other responses

- `302`: Follow the `Location` header to the prepared archive.
- `401`: No X-API-Key header.
- `403`: Key unknown or inactive, or this endpoint is not available to your account type.
- `404`: Nothing in scope matches.
- `413`: Too many figures to build on request. Use the manifest, or the prepared archive.
- `429`: Over 60/minute or 1000/hour. Carries `Retry-After` in seconds.
- `503`: The archive for this dataset version is not built yet. Use the manifest in the meantime.

---

[API](https://skmtc.dev/onlygoodantibodies/apis/oga-data-api.md) · [All operations](https://skmtc.dev/onlygoodantibodies/apis/oga-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onlygoodantibodies/apis/oga-data-api/revisions/8df16a210acb?raw)