---
title: "Get agent status"
method: GET
path: "/api/v1/agent/status"
tags: ["API Reference"]
---

# Get agent status

`GET /api/v1/agent/status`

## Request

- Base URL: `https://revnu.com`
- URL: `https://revnu.com/api/v1/agent/status`
- Auth: HTTP bearer

Whether the agent is up and busy: sandbox state, last activity, and the next scheduled wake.

Requires the `results:read` scope.

**Response.** ```json
{ "status": { "sandbox": "alive", "running": false, "lastActivityAt": 1789832474865, "lastTurnAt": 1789832490530, "pendingWakes": 2, "nextWakeAt": 1790002800000 } }
```

`running` is derived: a turn that started in the last 30 minutes and has not finished. It covers the whole account, so a turn started from chat, Slack, a webhook or a scheduled wake counts, not just this token's messages. A `dead` sandbox is normal between turns; the next message or wake spawns one. `pendingWakes` counts scheduled wakes, up to 100, and `nextWakeAt` is the earliest.

## Response `200`

``json { "status": { "sandbox": "alive", "running": false, "lastActivityAt": 1789832474865, "lastTurnAt": 1789832490530, "pendingWakes": 2, "nextWakeAt": 1790002800000 } } ` running is derived: a turn that started in the last 30 minutes and has not finished. It covers the whole account, so a turn st

- object
  - `status` object, required
    - `sandbox` string, required
    - `lastActivityAt` number, nullable, required
    - `running` boolean, required
    - `lastTurnAt` number, nullable, required
    - `pendingWakes` number, required
    - `nextWakeAt` number, nullable, required

## Other responses

- `401`: Missing, malformed, unknown or revoked token.
- `402`: `setup_pending`: the account hasn't started its trial. Finish setup with `GET /setup`.
- `403`: The token lacks the scope in `requiredScope`.
- `429`: Rate limited.
- `503`: Temporarily unavailable; retry the same call.

---

[API](https://skmtc.dev/revnu/apis/revnu-api.md) · [All operations](https://skmtc.dev/revnu/apis/revnu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revnu/apis/revnu-api/revisions/52e523c2db61?raw)