> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get monitor state

> Returns the current state of a monitor

Requires `monitors:read` permission. Uses the **Stats** rate limit bucket (30 req/min).

<ParamField path="monitor_id" type="string" required>
  Monitor ID (UUID)
</ParamField>

The state reflects the evaluator's current assessment: `pending` (no data yet), `up`, `down`, or `stale` (no recent check results).

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "state": "up",
      "entered_at": "2025-03-01T12:00:00.000000Z",
      "previous_state": "down"
    }
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 200 No state yet theme={null}
  {
    "data": {
      "state": null,
      "entered_at": null,
      "previous_state": null
    }
  }
  ```
</ResponseExample>