List jobs

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "665f1d00b8d4e91a2c3d4e60",
        "type": "audio",
        "status": "completed",
        "name": "episode.mp3",
        "metrics": {
          "inputSize": 52428800,
          "outputSize": 6291456,
          "compressionRatio": 8.33,
          "operationsApplied": ["trim-silence", "normalize", "compress", "encode"]
        },
        "createdAt": "2026-07-11T14:02:11.000Z",
        "completedAt": "2026-07-11T14:03:40.000Z"
      },
      {
        "id": "665f1b90b8d4e91a2c3d4e51",
        "type": "audio",
        "status": "completed",
        "name": "interview.wav",
        "metrics": { "compressionRatio": 12.1 },
        "createdAt": "2026-07-11T13:40:02.000Z",
        "completedAt": "2026-07-11T13:41:15.000Z"
      }
    ],
    "nextCursor": "665f1b90b8d4e91a2c3d4e51"
  }
}

List your jobs, newest first, with cursor pagination.

Request

Authorization

string

required

Bearer sk_live_...

type

string

Filter by pipeline: audio, text, image, video. (video is reserved for an upcoming pipeline.)

status

string

Filter by status: created, pending, processing, completed, failed.

limit

number

Page size, 1–100. Default 20.

cursor

string

The nextCursor value from the previous page.

Response

items

array

Job summaries: id, type, status, name (original filename, audio and image jobs), error (failed jobs), metrics (completed jobs), createdAt, completedAt.

nextCursor

string | null

Pass back as cursor to fetch the next page. null when there are no more results.

Example

curl -s "https://api.robinzip.app/v1/jobs?type=audio&status=completed&limit=2" \
  -H "Authorization: Bearer $ROBIN_KEY"

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "665f1d00b8d4e91a2c3d4e60",
        "type": "audio",
        "status": "completed",
        "name": "episode.mp3",
        "metrics": {
          "inputSize": 52428800,
          "outputSize": 6291456,
          "compressionRatio": 8.33,
          "operationsApplied": ["trim-silence", "normalize", "compress", "encode"]
        },
        "createdAt": "2026-07-11T14:02:11.000Z",
        "completedAt": "2026-07-11T14:03:40.000Z"
      },
      {
        "id": "665f1b90b8d4e91a2c3d4e51",
        "type": "audio",
        "status": "completed",
        "name": "interview.wav",
        "metrics": { "compressionRatio": 12.1 },
        "createdAt": "2026-07-11T13:40:02.000Z",
        "completedAt": "2026-07-11T13:41:15.000Z"
      }
    ],
    "nextCursor": "665f1b90b8d4e91a2c3d4e51"
  }
}

List items don’t include download URLs; fetch GET /v1/jobs/:id for a job’s outputUrl or outputText.

Create upload Get a job

⌘I

Getting Started

Core Concepts

API Reference

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example