---
title: "Queue or download a zero-credit server-side ZIP archive"
method: GET
path: "/v1/jobs/{jobId}/archive"
tags: ["Bulk jobs"]
---

# Queue or download a zero-credit server-side ZIP archive

`GET /v1/jobs/{jobId}/archive`

## Request

- Base URL: `https://api.scripthaul.com`
- URL: `https://api.scripthaul.com/v1/jobs/{jobId}/archive`
- Auth: HTTP bearer

Available only to a Bearer API key after the owned job is terminal. With no format parameter, the job's single format is used. Multi-format requests are split into ZIP parts before any part can exceed 80 MiB; the index response identifies numbered parts. Archives expire after seven days.

## Query parameters

- `format` string[]
- `formats` string[]
- `part` integer
- `rebuild` 1

## Response `200`

A single ZIP, one requested ZIP part, or a JSON index for a split archive

- ArchiveState
  - `ok` unknown, required
  - `archive` object, required
    - `id` string, required
    - `job_id` string, required
    - `status` 'queued' | 'building' | 'ready' | 'failed', required
    - `formats` string[], required
    - `part_count` integer
    - `total_bytes` integer
    - `expires_at` string, date-time, nullable
    - `poll_url` string, required
    - `parts` object[], required
      - `part` integer, required
      - `filename` string, required
      - `bytes` integer, required
      - `url` string, required
    - `error` object
      - `errorClass` string, required
      - `message` string, required
      - `retryable` boolean, required

## Other responses

- `202`: Archive generation is queued or building
- `400`: Typed API error
- `401`: Typed API error
- `403`: Typed API error
- `404`: Typed API error
- `409`: archive_job_not_ready (retryable: the job is not terminal yet) or archive_failed (the build exhausted its bounded attempts; Retry-After is the cool-down and rebuild_url starts a new generation now)
- `503`: Typed API error

---

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