Docs
Log inStart free
API referenceProjects

The film timeline

The whole film on ONE clock (film seconds, all chapters end to end): the chapter/scene tree by node path (ch:<id>/sc:<id>/el:<id>) with each scene's window, the tempo map with its sections, and every

timed track — voice, music beds (in/out, loop, conformed bpm), chapter score cues, SFX (seconds and bar:beat), transitions per seam, grooves, captions. A summary by default; detail=1 (or from/to) expands a range with bars, beats, words and elements; chapter_id narrows to one chapter. Free.

GET
/projects/{id}/timeline

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

chapter_id?string
Formatuuid
detail?string
Value in"1" | "true"
from?string
to?string
words?string
Value in"true" | "false"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/timeline"
{
  "data": {}
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

The beat grid GET

The project tempo as plain JSON on the film clock: bars [bar, sec], beats [sec, bar, beat], tempo sections, the music beds with their feature files, and the feature channel names.

Do picture and sound hit together? POST

Every scene's hit-like moves (cuts, instant sets/jumps, sharp-eased scale/opacity/position/rotation/shape moves, read off the mounted composition's timeline and timed where their speed peaks) matched