---
title: "Poll an export job"
method: GET
path: "/exports/{job_id}"
tags: ["Exports"]
---

# Poll an export job

`GET /exports/{job_id}`

## Request

- Base URL: `https://yappy.biz/api/v1`
- URL: `https://yappy.biz/api/v1/exports/{job_id}`
- Auth: one of:
  - none
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://yappy.biz/oauth/authorize`, token URL `https://yappy.biz/oauth/token`; client credentials, token URL `https://yappy.biz/oauth/token`, scopes: `export:docs`)

The current state of an export job. Status moves queued, then running, then completed; a completed job carries result.url pointing at the finished artifact. Poll no faster than the Retry-After hint on the previous response.

## Path parameters

- `job_id` string, required

## Response `200`

The job's current state

- Job: An asynchronous export. Poll until status is completed, then read result.url.
  - `object` 'job', required: Type discriminator.
  - `id` string, required: Job identifier.
  - `status` 'queued' | 'running' | 'completed' | 'failed', required: Where the job is now.
  - `resource` string, required: What is being exported.
  - `format` string: The artifact format.
  - `created_at` string, date-time: When it was accepted.
  - `poll_url` string, uri, required: Where to poll this job.
  - `retry_after` integer: Seconds to wait before polling again.
  - `result` object, nullable: Present once status is completed.
    - `url` string, uri: The finished artifact.
    - `content_type` string: Media type of the artifact.
    - `item_count` integer: How many items it contains.
  - `error` object, nullable: Present once status is failed.

## Other responses

- `400`: The request was malformed
- `401`: The supplied credential is missing, expired, or invalid
- `403`: The credential is valid but lacks the required scope
- `404`: No such resource
- `429`: Too many requests
- `500`: Unexpected server error
- `503`: A dependency was unavailable

---

[API](https://skmtc.dev/yappy/apis/yappy-web-api.md) · [All operations](https://skmtc.dev/yappy/apis/yappy-web-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yappy/apis/yappy-web-api/revisions/02b27cd526a7?raw)