Mager API

Get job status

GET/api/v1/jobs/{jobId}

Polls any clip, highlight or transcription job. Public statuses are queued, running, finished and failed. The structured payload — captions for a transcription, the clip list for a clip job, video URLs for a highlight — arrives on output once the job is finished.

Authorization

MagerApiKey
x-mager-api-key<token>

Mager API key

In: header

Path Parameters

jobId*string

Header Parameters

x-mager-api-key*string

Mager API key

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/jobs/string" \  -H "x-mager-api-key: YOUR_API_KEY"
{  "status": 200,  "message": "Success",  "data": {    "task_id": "cmclip01hxyz123",    "status": "finished",    "model": null,    "template_id": null,    "callback_url": "https://client.example.com/webhooks/mager",    "created_at": "2026-08-14T06:00:00.000Z",    "updated_at": "2026-08-14T06:00:00.000Z",    "completed_at": "2026-08-14T06:04:00.000Z",    "error": null,    "billing": {      "base_moods": 1,      "charged_moods": 2,      "extra_moods_charged": 2    },    "output": {      "segments": 128,      "captions": [        {          "text": "the first thing we got wrong was pricing",          "start": 12.4,          "end": 15.1,          "words": [            {              "word": "the",              "start": 12.4,              "end": 12.55,              "score": 0.99            }          ]        }      ]    },    "result": [],    "webhooks": []  }}