---
title: "Get User Data Export"
method: GET
path: "/users/me/data-export/{job_id}"
tags: ["users"]
---

# Get User Data Export

`GET /users/me/data-export/{job_id}`

Return the current state of ``job_id`` for the authenticated user.

``job_id`` is typed :class:`~uuid.UUID` so FastAPI answers 422 at the
boundary; raw text would instead reach a Postgres ``uuid`` comparison
and surface as a driver conversion error (HTTP 500).

Args:
    job_id: UUID of the export job to poll.
    auth: Authenticated user context.

Returns:
    The job's lifecycle state plus (when ``ready``) a presigned URL
    minted on this poll, so a repeated poll never sees a stale
    signature. Its lifetime is far shorter than the archive's 24h
    retention — see ``DOWNLOAD_URL_TTL_SECONDS``.

Raises:
    HTTPException: 404 when ``job_id`` is unknown or another user's
        (collapsed to avoid leaking existence); 500 on failure.

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Successful Response

- DataExportJobResponse — Response to ``GET /users/me/data-export/{job_id}``. Attributes: job_id: UUID of the export job. status: Lifecycle state of the job. download_url: Presigned S3 URL minted fresh on every poll and valid for 15 minutes; set only while ``status == ready``. expires_at: Archive-retention deadline (24h after completion), not the link's lifetime; ``ready`` jobs only. error: Short failure reason; ``failed`` jobs only. created_at: When the job was requested.
  - `job_id` string, required
  - `status` 'pending' | 'running' | 'ready' | 'expired' | 'failed', required
  - `download_url` string, nullable
  - `expires_at` string, date-time, nullable
  - `error` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/revisions/b92f75fd3b61/schema)