---
title: "Get a job"
method: GET
path: "/jobs/{id}"
tags: ["Jobs"]
---

# Get a job

`GET /jobs/{id}`

## Request

- Base URL: `https://api.rendley.com/v1`
- URL: `https://api.rendley.com/v1/jobs/{id}`
- Auth: API key in header `Authorization`

Get a single API-created job. Completed media and export jobs include output.url and output.url_expires_at when the stored result is available. With wait (0-20 seconds) a queued or processing job is held open until it changes or the wait runs out.

## Path parameters

- `id` string, required

## Query parameters

- `wait` integer

## Response `200`

OK

- object
  - `data` object: Success data
    - `acknowledged` boolean
    - `error` string
    - `error_message` string: ErrorMessage says what Error's code means, when it is a known one.
    - `id` string, uuid
    - `input_data` string
    - `output` TypesJobOutput
      - `duration` number
      - `expires_at` string, date-time
      - `file_hash` string: FileHash is the engine's content hash (XXH3-64, 16 hex chars).
      - `media_id` string, uuid: MediaID is the output file's storage key, a UUID.
      - `mime_type` string
      - `project_id` string, uuid
      - `size` integer
      - `url` string, uri: URL is a fresh signed download URL for the generated or exported file.
      - `url_expires_at` string, date-time: URLExpiresAt tells automation clients when to poll again for a fresh URL.
      - `workspace_id` string, uuid
    - `result_data` string
    - `sentences` TypesTranscriptSentence[]: Sentences is a finished transcription's speech, sentence by sentence with its times in the recording.
      - `end` number
      - `start` number
      - `text` string
    - `source_id` string
    - `source_type` string
    - `status` 'queued' | 'processing' | 'completed' | 'failed' | 'canceled': queued | processing | completed | failed | canceled
    - `type` string
  - `error` HttpResponseAPIError
    - `code` string
    - `fields` HttpResponseFieldError[]
      - `field` string
      - `message` string
    - `message` string
  - `meta` unknown

## Other responses

- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/rendley/apis/rendley-api.md) - [All operations](https://skmtc.dev/rendley/apis/rendley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rendley/apis/rendley-api/revisions/7eb8713bbf78?raw)