---
title: Get Run
description: Poll run status, outcome, buyer-facing charge, and final outputs.
source: https://www.edgaze.ai/docs/api/get-run
section: api
---
# Get Run

> Poll run status, outcome, buyer-facing charge, and final outputs.

```apibar
get-run
```

## Overview

Poll this endpoint after POST /runs to track execution. The response includes `status`, `outcome`, buyer-facing charge (`displayedChargeUsd`), and final `outputs` once the run completes.

Runs are scoped to the API key owner. You only see runs started by keys belonging to the same account: cross-tenant ids return **404**, not 403.

```doccallout
{"variant":"info","text":"Poll every 1-3s until status is completed, failed, cancelled, or timeout. On success, read outputs from the response. On failure, inspect status and outcome; billing may still show displayedChargeUsd as null."}
```

## Authorization

```apiscopes
get-run
```

## Parameters

```apiparams
get-run
```

## Response

Example payloads are in the request/response panel above.

## Edge cases

```apiedges
get-run
```

---

## Endpoint reference
- **Method:** `GET`
- **Path:** `https://api.edgaze.ai/v1/runs/{run_id}`
- **Scopes:** `run:read`
## Parameters
| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | Bearer token with run:read scope. |
| `run_id` | path | string | yes | UUID returned from POST /runs. |
## Example responses

### 200 Success
```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "completed",
  "outcome": "success",
  "suspended": false,
  "workflowId": "550e8400-e29b-41d4-a716-446655440000",
  "workflowVersionId": "ver_abc123",
  "startedAt": "2026-07-08T10:00:00.000Z",
  "completedAt": "2026-07-08T10:00:42.000Z",
  "displayedChargeUsd": 2.5,
  "outputs": [
    {
      "nodeId": "output_1",
      "name": "article",
      "type": "text",
      "value": "# Edge AI in 2026\n\n…"
    }
  ]
}
```

### 404 Not found

Cross-tenant or unknown run IDs return 404 (non-leaky).

```json
{
  "error": {
    "code": "not_found",
    "message": "Run not found."
  }
}
```

## Edge cases

### Cross-tenant isolation (HTTP 404 · `not_found`)

Runs belong to the API key owner. Requesting another user's run ID returns 404, not 403.

### Displayed charge only

displayedChargeUsd is the buyer-facing price. Raw compute cost is never exposed via the API.

### Terminal states

Poll until status is completed, failed, cancelled, or timeout. Check outcome for success vs failure semantics.