Read a chain

Per-step status, compact results and credits (quoted, charged from the ledger, cap); failed_step and error when it stopped.

wait (≤ 55 s) holds until it finishes. Reading a stalled chain restarts it. Free.

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

wait?number

Rangevalue <= 55

Response Body

`application/json`

curl -X GET "https://example.com/chains/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "status": "queued",
    "recipe": "string",
    "failed_step": "string",
    "error": "string",
    "credits": {
      "quoted": 0,
      "charged": 0,
      "cap": 0
    },
    "calls": {
      "ops": 0,
      "quotes": 0,
      "waits": 0,
      "receipts": 0,
      "total": 0
    },
    "steps": [
      {
        "id": "string",
        "op": "string",
        "status": "pending",
        "items": {
          "total": 0,
          "completed": 0,
          "failed": 0,
          "running": 0,
          "errors": [
            {
              "index": 0,
              "error": "string"
            }
          ]
        },
        "quoted": 0,
        "credits": 0,
        "credits_source": "ledger",
        "generation_id": "string",
        "error": "string",
        "result": null
      }
    ],
    "created_at": "string",
    "finished_at": "string",
    "elapsed_s": 0
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

401application/json

404application/json

`application/json`

`application/json`

`application/json`