Conversions

List conversions

Your workspace's conversions, newest first.

GET/v1/conversions

Authentication

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

Query parameters

limitintegeroptional

How many to return.

cursorstringoptional

next_cursor from the previous page.

Response

200 OK

conversionsarray

The jobs, in the same form as Get a conversion.

next_cursorstring or null

Pass it as cursor for the next page. null on the last page.

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.

Request

PHPPythonNode.jscURL

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

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

foreach ($data['conversions'] as $job) {
    echo $job['id'], ' ', $job['state'], ' ', $job['input_filename'], "\n";
}

import os
import requests

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

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

for job in data["conversions"]:
    print(job["id"], job["state"], job["input_filename"])

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

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

for (const job of data.conversions) {
  console.log(job.id, job.state, job.input_filename);
}

curl "https://rasternivo-api.swiftinfocorp.com/v1/conversions?limit=20" \
  -H "Authorization: Bearer $RASTERNIVO_API_KEY"

Response 200

{
  "conversions": [
    { "id": "01a19b62-dd01-7c80-811b-74793f0a32b6", "state": "succeeded", "channel": "api", "input_filename": "report.pdf", "credits_consumed": 9 }
  ],
  "next_cursor": null
}