---
title: "Read the cut's delivery class."
method: GET
path: "/trailers/{jobId}/resolution"
tags: ["Trailer"]
---

# Read the cut's delivery class.

`GET /trailers/{jobId}/resolution`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/resolution`
- Auth: HTTP bearer

Returns the class the finish delivers the cut at: `deliveryResolution` (720p unless the writer asked for 1080p), `isDefault` (true when nobody has chosen — say so rather than reporting the default as a decision), `renderResolution` (every take renders at 480p first, whatever the class), `options`, `editable` (false while a render or finish pass is running), and `finishCredits` (what finishing this cut costs at each class, in Studio Credits — 0 for a cut of app captures and title cards). Raising the class upscales the approved takes at finish: it quotes a finish, never a render. Scope: `story:read`.

## Response `200`

The cut's delivery class.

- object
  - `resolution` TrailerDeliveryResolution, required: The class the finish delivers the cut at. Raising it upscales the approved takes at finish — it quotes a finish, never a render.
    - `jobId` string, required
    - `deliveryResolution` '720p' | '1080p', required: The writer's choice, else 720p.
    - `isDefault` boolean, required: True when nobody has chosen, so the default applies.
    - `renderResolution` '480p', required: Every take renders at this class first, whatever the delivery class.
    - `options` string[], required
    - `editable` boolean, required: False while a render or finish pass is running.
    - `finishCredits` object, required: What finishing THIS cut costs at each class, in Studio Credits — the finish quote's own lines (the selected takes upscaled at their kept length, and the text layers): 0 for a cut of app captures and title cards. Null for a class it cannot price yet (a shot with no take to play). Say this number when the writer weighs the class; the finish quote stays the one that reserves.
      - `720p` integer, nullable, required
      - `1080p` integer, nullable, required

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `404`: The named project or source does not exist or is owned by another account.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/4534f5d25540?raw)
