---
title: "Get a data export"
method: GET
path: "/api/v1/me/export/{jobId}"
tags: ["Settings"]
---

# Get a data export

`GET /api/v1/me/export/{jobId}`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/me/export/{jobId}`
- Auth: API key in cookie `auth_token`

One export's status. Owner session only; reachable while the account is locked.

## Path parameters

- `jobId` string, required: The export id

## Response `200`

The export

- AccountExportJob: One data export of the account — prepared in the background, downloadable only by the signed-in owner
  - `id` string, required
  - `status` 'preparing' | 'ready' | 'failed', required: `preparing` while the job runs; `ready` once the file can be downloaded; `failed` with `error`
  - `error` 'too_large' | 'internal' | 'null', nullable, required: `too_large` — more than one download can carry (no partial file is ever produced; contact support); `internal` — a failure on our side (start a new export at once, the daily limit was given back)
  - `requested_at` string, date-time, required
  - `ready_at` string, date-time, nullable, required
  - `expires_at` string, date-time, required: The export and its file are deleted at this time — 7 days after the request
  - `downloaded_at` string, date-time, nullable, required: The first download, if any
  - `size_bytes` integer, nullable, required: Size of the compressed file as stored
  - `counts` object, required: Rows per section of the file
  - `download_path` string, nullable, required: Path of the download route while `ready`, else null

## Other responses

- `400`: Malformed export id
- `401`: Unauthorized
- `403`: `owner_session_required` — an API key may not export the account; exporting belongs to the signed-in owner (dashboard, or an MCP login session)
- `404`: No such export on this account (an export is kept for 7 days)

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)