> For the complete documentation index, see [llms.txt](https://zumo.fusion.ac/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zumo.fusion.ac/api-reference/http/get-replay-status.md).

# GET /replays/{replayId}/status

Lightweight job status. Poll while a recording is in progress.

**Authentication:** `API-Key` required

## Response

| Status | Description                |
| ------ | -------------------------- |
| `200`  | Job exists (any status)    |
| `400`  | Invalid UUID               |
| `401`  | Missing or invalid API key |
| `404`  | No record                  |

### `200` body

| Field                   | Type    | Description                                         |
| ----------------------- | ------- | --------------------------------------------------- |
| `replayId`              | string  | Lowercase UUID                                      |
| `status`                | string  | `queued` \| `running` \| `completed` \| `failed`    |
| `requestId`             | string? | Job correlation id                                  |
| `botId`                 | string? | Assigned worker                                     |
| `phase`                 | string? | `opening` \| `scraping` \| `playing` \| `finishing` |
| `currentMs` / `totalMs` | number? | Playback position / duration                        |
| `speed`                 | number? | Hypixel speed 1–4                                   |
| `error`                 | object? | `{ code, message }` when failed                     |

## Example

```bash
curl -s -H "API-Key: zk_your_key" \
  "https://zed.fusion.ac/replays/0febde27-aafd-4d8d-bb79-cb3be723aa7a/status"
```