---
title: "BETA: queue a background whole-country export pack."
method: POST
path: "/v1/export-packs"
tags: ["jobs"]
---

# BETA: queue a background whole-country export pack.

`POST /v1/export-packs`

## Request

- Base URL: `https://api.jobopportunitiesapi.org`
- URL: `https://api.jobopportunitiesapi.org/v1/export-packs`
- Auth: HTTP bearer

Requires a plan with `bulk_export` (same gate as `GET /v1/export`). Creates a background job that pages the full corpus for one country (optionally narrowed to one `category`/family), writes a gzip CSV file server-side, and meters the rows exactly like `GET /v1/jobs`. One in-flight pack per account. Poll `GET /v1/export-packs/{id}` for status; a completed pack carries a signed, expiring `download_url` valid for 7 days. BETA: row caps per plan are provisional and the file is deleted 7 days after completion.

## Request body

- object
  - `country` string, required: Two-letter country code, e.g. DE.
  - `family` string: Optional job-family filter (the same vocabulary as `category`).

## Response `201`

The pack was queued.

## Other responses

- `401`: Missing, unknown, revoked or expired key. All four are reported identically.
- `403`: This endpoint is not included in your plan. `X-JOA-Required-Feature` names the missing entitlement — `delta_feed` or `bulk_export`. See https://jobopportunitiesapi.org/api for the tiers that include it.
- `409`: An export pack is already queued or running for this account.
- `422`: A parameter we will not guess at: an unknown source_type or provider, an unparseable timestamp, a malformed cursor. Note the deliberate exceptions, which are clamps rather than errors: `limit` is capped at the plan maximum (a non-numeric value falls back to the default), and comma-separated lists are truncated to the per-parameter maximum shown on each. Unknown query parameters are ignored.

---

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