Conversions

Get the results

Download links for each JPG and the ZIP.

GET/v1/conversions/{id}/result

The links need no API key, so treat them as private. They expire after 15 minutes; call this again for fresh ones.

Authentication

An API key with the conversions:read scope, or the signed-in website.

Path parameters

idstringrequired

The job ID.

Response

200 OK

conversionobject

The job.

pagesarray

Each page: page, filename, width, height, bytes and url.

zip_urlstring or null

The ZIP, if you asked for "zip": true.

links_expire_atstring

When these links stop working.

Errors

Status	Code	What to do
401	`unauthenticated`	The API key is missing, invalid, expired or revoked.
403	`insufficient_scope`	Use a key with the scope shown above.
404	`not_found`	Check the ID. It may belong to another workspace.
409	`job_not_finished`	Wait for the job to end.
410	`result_expired`	The images have been deleted. Convert the PDF again.

Request

PHPPythonNode.jscURL

<?php
$api = getenv('RASTERNIVO_API_URL') ?: 'https://rasternivo-api.swiftinfocorp.com/v1';
$id = getenv('RASTERNIVO_JOB_ID');

$ch = curl_init("$api/conversions/$id/result");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RASTERNIVO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data['pages'] as $page) {
    echo $page['filename'], ' ', $page['url'], "\n";
}

import os
import requests

API = os.environ.get("RASTERNIVO_API_URL", "https://rasternivo-api.swiftinfocorp.com/v1")

data = requests.get(
    f'{API}/conversions/{os.environ["RASTERNIVO_JOB_ID"]}/result',
    headers={"Authorization": "Bearer " + os.environ["RASTERNIVO_API_KEY"]},
).json()

for page in data["pages"]:
    print(page["filename"], page["url"])

const API = process.env.RASTERNIVO_API_URL ?? "https://rasternivo-api.swiftinfocorp.com/v1";

const res = await fetch(`${API}/conversions/${process.env.RASTERNIVO_JOB_ID}/result`, {
  headers: { Authorization: `Bearer ${process.env.RASTERNIVO_API_KEY}` },
});
const data = await res.json();

for (const page of data.pages) {
  console.log(page.filename, page.url);
}

curl "https://rasternivo-api.swiftinfocorp.com/v1/conversions/$RASTERNIVO_JOB_ID/result" \
  -H "Authorization: Bearer $RASTERNIVO_API_KEY"

Response 200

{
  "conversion": { "id": "01a19b62-dd01-7c80-811b-74793f0a32b6", "state": "succeeded", "credits_consumed": 6 },
  "pages": [
    { "page": 1, "filename": "report_page_0001.jpg", "width": 2550, "height": 3300, "bytes": 266957,
      "url": "https://rasternivo-api.swiftinfocorp.com/v1/files/MDFhMTli…" }
  ],
  "zip_url": "https://rasternivo-api.swiftinfocorp.com/v1/files/MDFhMTli…",
  "links_expire_at": "2026-11-02T08:46:51Z"
}