---
title: "Where the \"Download my data\" archive stands, with a fresh download link when it is ready."
method: GET
path: "/account/export"
tags: ["Account"]
---

# Where the "Download my data" archive stands, with a fresh download link when it is ready.

`GET /account/export`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/account/export`
- Auth: HTTP bearer

`state`: `none`, `queued`, `building`, `ready`, `failed` (`error` says why) or `expired`. When `ready`, `download.url` is a signed link that works until `download.expiresAt` (an hour); read again for a new one. The archive itself is deleted at `expiresAt` (7 days after it is built). `contents` counts what it holds by section. Scope: `account:read`. Free.

## Response `200`

The latest export.

- AccountExportStatus
  - `state` 'none' | 'queued' | 'building' | 'ready' | 'failed' | 'expired', required
  - `exportId` string, nullable, required
  - `requestedAt` string, date-time, nullable, required
  - `builtAt` string, date-time, nullable, required
  - `expiresAt` string, date-time, nullable, required: When the archive is deleted.
  - `sizeBytes` integer, nullable, required
  - `download` object, nullable, required
    - `url` string, uri, required: A signed link; it stops working at `expiresAt`. Read the status again for a new one.
    - `expiresAt` string, date-time, required
  - `contents` object, nullable, required
  - `error` string, nullable, required
  - `keepDays` integer, required

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/86e084144cef?raw)