---
title: "Get a source's processing status"
method: GET
path: "/v1/sources/{sourceId}"
tags: ["Sources"]
---

# Get a source's processing status

`GET /v1/sources/{sourceId}`

Returns whether a source from `POST /v1/sources` is ready to use, however it was placed (clip, b-roll, overlay, background, background music or sound effect). Poll it after placing a newly uploaded source: while it is `processing`, frames and previews of videos that use it answer not-ready instead of rendering.

## Path parameters

- `sourceId` string, required — Source ID

## Response `200`

OK

- GetSourceResponse — A source's processing status
  - `id` string, required — Source ID
  - `status` 'pending' | 'processing' | 'ready' | 'failed', required — `pending`: not placed yet; conversion starts once a clip, layout, overlay, background, background music or sound effect references the source. `processing`: still uploading or converting; frames and previews of videos using it answer not-ready until it is `ready`, so poll this every few seconds. `ready`: usable everywhere. `failed`: conversion failed or the recording was cancelled; upload the file again as a new source.

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `409` — The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.
- `503` — A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-09-29** `704d6fc3bc60` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/sources/:sourceId/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/d3eafbc27bf9?raw)