Skip to main content
Banan0 API Docs

Get Run Status

Check the status of a model run.

Get Run Status

http
GET /api/v1/runs/:runId

Returns the current status and results of a model run.

Example Request

bash
curl -H "Authorization: Bearer bnn_live_xxx" \
  "https://banan0.com/api/v1/runs/run_abc123xyz"

Response (Queued/Running)

json
{
  "data": {
    "run_id": "run_abc123xyz",
    "status": "EXECUTING",
    "model_id": "fal-ai/flux-pro",
    "created_at": "2026-01-13T20:00:00.000Z",
    "started_at": "2026-01-13T20:00:05.000Z"
  }
}

Response (Completed)

json
{
  "data": {
    "run_id": "run_abc123xyz",
    "status": "COMPLETED",
    "model_id": "fal-ai/flux-pro",
    "output": {
      "images": [
        "https://storage.banan0.com/generated-images/user123/abc.png"
      ]
    },
    "tokens_charged": 5,
    "created_at": "2026-01-13T20:00:00.000Z",
    "completed_at": "2026-01-13T20:00:15.000Z",
    "duration_ms": 15000
  }
}

Response (Failed)

json
{
  "data": {
    "run_id": "run_abc123xyz",
    "status": "FAILED",
    "error": {
      "message": "Invalid prompt: content policy violation",
      "code": "CONTENT_POLICY"
    }
  }
}

Run Statuses

StatusDescription
QUEUEDWaiting to start
EXECUTINGCurrently running
COMPLETEDFinished successfully
FAILEDFinished with error
CANCELEDManually canceled

Command Palette

Search for a command to run...