---
title: "Get a subscriber export job"
method: GET
path: "/v1/jobs/subscriber-exports/{job_id}"
tags: ["Jobs"]
---

# Get a subscriber export job

`GET /v1/jobs/subscriber-exports/{job_id}`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/jobs/subscriber-exports/{job_id}`
- Auth: HTTP bearer

Returns the current state of a previously created export job. Requires `subscribers:export` because completed jobs include a Subscriber CSV download URL.

## Path parameters

- `job_id` string, required

## Response `200`

The export job was returned.

- object
  - `data` SubscriberExportJob, required
    - `self` string, required: Stable relative Public API path for retrieving this resource.
    - `id` string, required
    - `status` 'Queued' | 'Processing' | 'Completed' | 'Failed', required
    - `selection` object, required
      - `query` string, nullable, required
      - `status` 'Active' | 'Unconfirmed' | 'Unsubscribed' | 'Complained' | 'Bounced' | 'Blocked' | 'null', nullable, required
      - `cold_only` boolean, required
    - `exported_count` integer, nullable, required
    - `file_name` string, nullable, required
    - `download_url` string, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `error_message` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `404`: The export job was not found.

---

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