API referenceProjects

Get resolution status

What's resolved vs unresolved in a project, and the estimated credits to resolve the rest.

A scene is resolved once it has renderable content; voice-over is tracked per chapter. Read-only counterpart to POST /projects/{id}/resolve — the counts match the editor's readiness UI exactly (shared logic).

GET
/projects/{id}/resolution

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

Response Body

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/resolution"
{
  "data": {
    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
    "editor_url": "http://example.com",
    "ready": true,
    "phase": "string",
    "scenes": {
      "total": 0,
      "resolved": 0,
      "generating": 0,
      "unresolved": 0,
      "unresolvable": 0
    },
    "voiceover": {
      "chapters_total": 0,
      "chapters_spoken": 0,
      "chapters_missing_audio": 0
    },
    "cost_estimate": {
      "scenes": 0,
      "voiceover": 0,
      "total": 0
    },
    "actionable": 0
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}