# Get agent status

> Whether Revnu is awake or asleep, whether it's working right now, its last activity, and its next scheduled run.

Canonical: https://revnu.com/docs/agent-status
Last updated: 2026-11-07

```bash
curl -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/agent/status
```

## Response

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

The first field says whether Revnu is awake (`alive`) or asleep (`dead` or `paused`). Asleep is normal between pieces of work; the next message or scheduled run starts it again.

`running` says whether Revnu is working right now: a piece of work has started, hasn't finished and has shown activity in the last 20 minutes. It covers the whole account, so work started from chat, Slack, a webhook, a workflow or a scheduled run counts, not just this token's messages. `lastTurnAt` is when the most recent of those finished.

`pendingWakes` counts scheduled runs in the future, up to 100, including each workflow's next run and the daily work session, so a steady count is normal. `nextWakeAt` is the earliest; one well in the past means scheduled runs aren't starting, so tell Revnu or [get help](https://revnu.com/docs/get-help.md).

## Frequently asked questions

### Does this show inbox warm-up or why something failed?

It shows whether Revnu is awake, working right now, and when it next runs. For channel numbers read [`GET /results`](https://revnu.com/docs/results.md). For warm-up progress or the reason something failed, ask Revnu with a [message](https://revnu.com/docs/talk-to-your-agent.md).

### Which scope does this need?

`results:read`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.

### Are responses cached?

No. Every response is `Cache-Control: no-store`, so what you read is current.
