Get an asynchronous run

GET/v1/run/{id}

Retrieve the current or terminal state of an asynchronous run created by POST /v1/run.

Path parameters

stringidrequired

Opaque run identifier returned by POST /v1/run. Use it exactly as returned; no prefix is guaranteed.

curl https://api.sandbase.ai/v1/run/opaque-run-id \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "opaque-run-id",
  "model": "openai/gpt-image-2",
  "status": "completed",
  "outputs": [
    {
      "url": "https://media.sandbase.ai/files/result.png",
      "content_type": "image/png"
    }
  ]
}

Polling

Poll every 5–10 seconds for long-running media or API tasks. Stop when status is completed, failed, or timeout. A non-terminal response may omit outputs; treat the run ID as opaque and do not construct a different status URL.