GET /v1/jobs/{jobId}
Get job status — Shorty API
Returns the status of an async job the authenticated account started (a summary, transcription, or subtitle job created via a POST here). The body is the canonical nested job-status shape used across every Shorty surface. A non-existent or foreign job id returns 404.
GET /v1/jobs/{jobId}Returns the status of an async job the authenticated account started (a summary, transcription, or subtitle job created via a POST here). The body is the canonical nested job-status shape used across every Shorty surface. A non-existent or foreign job id returns 404.
Authentication
Requires a Bearer credential — a shk_live_ API key or an OAuth 2.1 access token with the scope for this resource. See Authentication.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
jobId | path | Yes | — |
Example request
curl -X GET https://aishorty.com/v1/v1/jobs/{jobId} \
-H "Authorization: Bearer shk_live_your_key"Response · 200
| Field | Type | Required | Description |
|---|---|---|---|
jobId | string | Yes | The job id. |
status | string | Yes | Un-normalized status string (queued / processing / success / error / cancelled). |
progress | number | No | Completion fraction 0–100, when known. |
step | string or null | No | Human-readable current step, or null. |
error | string or null | No | Error message if the job failed, or null. |
output | object | No | Job-type-specific extras (e.g. jobType, title, outputId, articleId, transcriptionId). |
Errors
On failure this endpoint returns an RFC 9457 problem body. Possible statuses:
400401403404429500
Switch on the problem code, not the status. See the error reference for every code and how to fix it.