---
title: "Poll an export job (presigned download URL when completed)"
method: GET
path: "/business/exports/{jobId}"
tags: ["Exports"]
---

# Poll an export job (presigned download URL when completed)

`GET /business/exports/{jobId}`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/exports/{jobId}`
- Auth: HTTP basic

Polls an export job started by `POST /business/lists/{listId}/export`. While it runs, `rowCount` and `downloadUrl` are null. When `status` is `completed`, `downloadUrl` is a short-lived presigned URL for the CSV (poll again for a fresh link once it expires) and `rowCount` is the number of rows written. When `status` is `failed`, `error` says why: `LIST_EMPTY` (nothing to export), `LIST_NOT_FOUND` (the list went away while the job ran) or `EXPORT_FAILED` (anything else — retry). Unknown or expired jobs answer 404 EXPORT_NOT_FOUND. `GET /business/jobs/{jobId}` reads the same record and maps `error` to the same three values.

Errors:
- `404` `EXPORT_NOT_FOUND` — No export job with that id (it may have expired or belong to another workspace).
- `422` `VALIDATION_FAILED` — jobId is not a 24-hex id.
- `429` `RATE_LIMITED` — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

## Path parameters

- `jobId` string, required: 24-character hex id of an async job, as returned with the 202 that started it (POST /business/lists/{listId}/export).

## Response `200`

Success

- object
  - `exportJob` object, required
    - `jobId` string, required
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required
    - `rowCount` integer, nullable, required
    - `downloadUrl` string, nullable, required
    - `error` 'LIST_NOT_FOUND' | 'LIST_EMPTY' | 'EXPORT_FAILED' | 'null', nullable, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)
