---
title: "Monitor detail"
method: GET
path: "/api/monitors/{id}"
tags: ["Monitors"]
---

# Monitor detail

`GET /api/monitors/{id}`

## Request

- Base URL: `https://twitr.sh`
- URL: `https://twitr.sh/api/monitors/{id}`
- Auth: API key in header `SIGN-IN-WITH-X`

## Path parameters

- `id` string, required

## Response `200`

Monitor detail + events_url + extend hint.

- object
  - `monitor` object
    - `monitor_id` string, required
    - `type` 'account' | 'keyword', required
    - `target` string, required: Monitored username or search query.
    - `event_types` string[]
    - `status` 'active' | 'expired' | 'deleted', required
    - `created_at` integer: Unix ms.
    - `expires_at` integer, required: Unix ms — end of the prepaid window. The monitor stops here unless extended.
    - `remaining_seconds` integer
    - `hours_purchased` integer
    - `paid_total_usd` string

## Other responses

- `402`: Identity Required — sign SIWX and retry.
- `403`: Signing wallet doesn't own this monitor.
- `404`: Monitor unknown or expired out of retention.

---

[API](https://skmtc.dev/twitr/apis/twitr-sh.md) · [All operations](https://skmtc.dev/twitr/apis/twitr-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/twitr/apis/twitr-sh/revisions/f6390fcee344?raw)