Get a run's status
A run's state. status is queued, running, paused, completed, failed or cancelled. On SynapseOrch Cloud, a paused run also carries the question it is asking, human_input_required, and a run that has ended carries what it made: response (the orchestration's Result key), shared_state, and error when it did not complete. Poll every few seconds; a run has nothing new to say until its next step ends.
A self-hosted install answers the state alone — no human_input_required, response, shared_state or error; read those with /api/v1 — and adds worker_id.
apiKeyAuthorizationBearer <token>An API key, sk-syn- and 32 characters. On SynapseOrch Cloud an owner or admin makes it under Settings → Developer; on a self-hosted install, under Settings → API Keys.
run_id*stringThe run, from the start's answer.
The run.
application/json- response
run_id?stringorchestration_id?stringstatus?stringcurrent_step_id?unknownwaiting_for_human?booleantotal_cost_usd?numbertotal_tokens_used?integerstarted_at?stringended_at?stringresponse?stringshared_state?error?unknowncurl -X GET "https://api.synapseorch.com/api/v2/orchestrations/runs/run_01a10a1553d57036bae3d17421a4ba16/status" \ -H "Authorization: Bearer sk-syn-..."{ "run_id": "run_01a10a1553d57036bae3d17421a4ba16", "orchestration_id": "orch_01a10a0f2d4b6c8e0a1b3c5d7e9f1a2b", "status": "completed", "current_step_id": null, "waiting_for_human": false, "total_cost_usd": 0.0002, "total_tokens_used": 4133, "started_at": "2026-10-04T17:52:12Z", "ended_at": "2026-10-04T17:52:17Z", "response": "Yes. Under the FTC's Mail Order Rule we ship within 30 days when no other time is stated [K1]…", "shared_state": { "user_input": "Do you ship within 30 days?", "answer": "…" }, "error": null}{ "run_id": "run_01a10843ee6d704bbccfb11933a861d1", "orchestration_id": "orch_01a1084a3b5c7d9e1f2a4b6c8d0e2f4a", "status": "paused", "current_step_id": "approve", "waiting_for_human": true, "total_cost_usd": 0.0001, "total_tokens_used": 1840, "started_at": "2026-10-04T17:58:40Z", "ended_at": null, "human_input_required": { "step_id": "approve", "prompt": "Invoice INV-1047 from Saltmarsh Logistics totals $2,310.00 (supplier not on the approved list). Approve payment?", "fields": [ { "name": "approved", "type": "boolean", "label": "Approve payment" }, { "name": "comment", "type": "textarea", "label": "Note for the ledger" } ] }}