Get a run

GET/runs/{run_id}

Returns one run's status, progress and summary, and can hold until it finishes. It is how you wait for a run.

Scope	Heavy call	Long poll	CLI
`scripts:read`	No	`wait`, up to 30 s	`chartnaut runs get`

Guidance

Poll with wait=30 in a loop until status is succeeded, failed or cancelled. Each call returns as soon as the run finishes, so there is no need to sleep between calls.
Past your plan's long polls at once, the call answers straight away with the run as it is. If an unfinished run comes back in under a second or two, wait 2 seconds before the next poll, as the CLI does.
A 200 means the run has finished and a 202 means it has not. Read status to tell success from failure.
On failed, read failure: retryable: true means running it again can help, and failure.diagnostics names what stopped a script before it produced anything. Errors and exit codes explains each kind.
On succeeded, summary has the counts. Call Get run results for the points, events or result blocks.
console holds the first 50 lines an indicator or definition printed, once the run has finished. Read it when a run succeeds but the numbers look wrong.

Path parameters

Name	Type	Description
`run_id`	string	A run id, `run_…` or `srun_…`

Query parameters

Name	Type	Required	Default	Description
`wait`	integer	No	0	Seconds to hold until the run finishes, 0 to 30. Values outside the range are clamped

Response

Returns a Run: 200 when it has finished, 202 while it is still queued or running.

Status codes

Status	Code	Meaning
`200`	-	The run has finished: `succeeded`, `failed` or `cancelled`
`202`	-	The run is still `queued` or `running`. Poll again
`404`	`not_found`	You have no run with that id

Example request

curl "https://api.chartnaut.com/v1/runs/run_7k2m9q4xw1ht0bza?wait=30" \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

202 Accepted

{
  "id": "run_7k2m9q4xw1ht0bza",
  "kind": "indicator",
  "script": "my-ema@3",
  "instrument": "HYPERLIQUID:BTC",
  "timeframe": "5m",
  "window": {
    "from": "2026-08-27T09:25:00Z",
    "to": "2026-09-26T09:25:00Z"
  },
  "settings": { "length": 50 },
  "label": "length sweep",
  "status": "running",
  "progress": { "pct": 0, "phase": "running" },
  "failure": null,
  "summary": null,
  "usage": { "bars": 0, "compute_units": 0 },
  "app_url": null,
  "created_at": "2026-09-26T09:26:03.117204Z",
  "started_at": "2026-09-26T09:26:03.240118Z",
  "finished_at": null,
  "results_expire_at": "2026-10-03T09:26:03.117204Z"
}

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No run run_7k2m9q4xw1ht0bzz."
  }
}

From the CLI

chartnaut runs get run_7k2m9q4xw1ht0bza --watch

runs get prints the run as run does, and --watch polls with wait=30 until it finishes. Command reference