---
title: "Get a fresh download URL for an output file"
method: GET
path: "/extractions/{extraction_id}/output"
tags: ["Extractions"]
---

# Get a fresh download URL for an output file

`GET /extractions/{extraction_id}/output`

## Request

- Base URL: `https://api.invoicedataextraction.com/v1`
- URL: `https://api.invoicedataextraction.com/v1/extractions/{extraction_id}/output`
- Auth: HTTP bearer

A signed URL, valid for 5 minutes, for the XLSX, CSV or JSON file of a completed
extraction. A plain `GET` on the URL returns the file; no `Authorization` header is
needed. The completed status response already carries such URLs; use this endpoint when
they have expired. Output files are kept for 90 days from submission.

Rate limit: 30 requests per minute per API key.

## Path parameters

- `extraction_id` string, uuid, required

## Query parameters

- `format` 'xlsx' | 'csv' | 'json', required
- `scope` 'own' | 'team'

## Response `200`

The URL. This response carries no `success` field.

- OutputDownloadUrlResponse
  - `download_url` string, uri, required
  - `format` 'xlsx' | 'csv' | 'json', required
  - `expires_in_seconds` 300, required

## Other responses

- `400`: `INVALID_INPUT`: the request does not match the contract; `details.issues` lists each problem with its `path`.
- `401`: `UNAUTHENTICATED`, `API_KEY_EXPIRED` or `API_KEY_REVOKED`.
- `403`: `FORBIDDEN`: `scope=team` from a caller who is not a team admin.
- `404`: `EXTRACTION_NOT_FOUND`; `OUTPUT_NOT_AVAILABLE` (not completed, or this format was never generated); or `OUTPUT_EXPIRED` (past the 90-day retention).
- `429`: `RATE_LIMITED`: wait `details.retry_after_seconds` (also the `Retry-After` header), then retry.
- `500`: `INTERNAL_ERROR`: retry after a short delay.

---

[API](https://skmtc.dev/invoicedataextraction/apis/invoice-data-extraction-api.md) · [All operations](https://skmtc.dev/invoicedataextraction/apis/invoice-data-extraction-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invoicedataextraction/apis/invoice-data-extraction-api/revisions/16d920350483?raw)