Get download URLs

Returns a signed URL for every output of a succeeded job. Most conversions have one output; some, such as a multi-page PDF to PNG, have several.

Output names are based on input, not on your file’s name: input.webp, or input.png, input-2.png and so on for pages. Rename them when you save them.

The URLs expire after expires_in seconds, at most 5 minutes. Call this route again for fresh URLs while the job exists. Calling it before the job succeeds fails with not_ready.

GET/v1/jobs/{id}/download

Authorization

AuthorizationBearer token · headerrequired

A cvt_live_ API key from the dashboard, sent as Authorization: Bearer cvt_live_…. Keep it on your server.

Path parameters

idstringrequired

The job id returned when you created the job, such as job_01k6z7v4q8m3x2a9b5c0d1e2f3.

Responses

200

Signed URLs for each output.

outputsobject[]

Show properties

Array of object

namestring

urlstring<uri>

expires_ininteger

400

not_ready: the job has not succeeded.

errorobject

Show properties

codestring

messagestring

401

unauthorized: no Authorization: Bearer header.

errorobject

Show properties

codestring

messagestring

403

unauthorized (key invalid or revoked) or a billing limit.

errorobject

Show properties

codestring

messagestring

404

not_found: the job does not exist, belongs to another account, or has expired.

errorobject

Show properties

codestring

messagestring

429

rate_limited: more than 120 requests in a minute for this key.

errorobject

Show properties

codestring

messagestring

502

storage_unavailable: object storage did not answer. Retry with backoff.

errorobject

Show properties

codestring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

idpath*The job id returned when you created the job, such as `job_01k6z7v4q8m3x2a9b5c0d1e2f3`.

Request

curl -X GET 'https://convt-api-production.up.railway.app/v1/jobs/job_01k6z7v4q8m3x2a9b5c0d1e2f3/download' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

import axios from "axios";

const response = await axios.request({
  method: "GET",
  url: "https://convt-api-production.up.railway.app/v1/jobs/job_01k6z7v4q8m3x2a9b5c0d1e2f3/download",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

const response = await fetch("https://convt-api-production.up.railway.app/v1/jobs/job_01k6z7v4q8m3x2a9b5c0d1e2f3/download", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://convt-api-production.up.railway.app/v1/jobs/job_01k6z7v4q8m3x2a9b5c0d1e2f3/download",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "outputs": [
    {
      "name": "input.webp",
      "url": "https://bucket.example/job_01k6z7v4q8m3x2a9b5c0d1e2f3/attempt-1/input.webp?X-Amz-Signature=…"
    }
  ],
  "expires_in": 300
}

{
  "error": {
    "code": "not_ready",
    "message": "Job has no completed outputs."
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}