Skip to main content
GET
Retrieve an export job

Authorizations

Authorization
string
header
required

Bearer tokens created in the ABConvert admin under Settings → MCP & API Access. Scopes: read_experiments and write_experiments (write implies read; the default is read). See Authentication for which scope each request needs.

Path Parameters

id
string
required

Export job ID (opaque string).

Response

The job.

object
string
required
Allowed value: "export"
id
string
required

Treat as opaque. Never parse it.

Example:

"export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718"

status
enum<string>
required
Available options:
pending,
processing,
completed,
failed
Example:

"completed"

experiment_id
string
Example:

"3021"

url
string<uri> | null

The signed download link, ready to fetch as given. Set while the job is completed and expires_at is still in the future; null before the job finishes, and null again once the link expires, while status stays completed. Branch on this field rather than on status.

The link is signed, so fetching it needs no bearer token. You can hand the whole URL to a browser or a download tool. Anyone who has the URL can download the file until expires_at.

Example:

"https://app.abconvert.io/v1/exports/export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718/download?expires=1787000000&signature=3f8c1d0b6a94e27d5c1b8e40f7a2d9c6b3e15f8a0d47c92e6b1a3f5d8c07e246"

expires_at
string<date-time> | null
failure_reason
string | null

Why the job failed. Set only when status is failed.

created_at
string<date-time>