---
title: "Monitor Health"
method: GET
path: "/monitor/{id}/health"
tags: ["Monitoring"]
---

# Monitor Health

`GET /monitor/{id}/health`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/monitor/{id}/health`
- Auth: HTTP bearer

Returns a single monitor's current status, degradation flag, and cursor position, for building your own health dashboard. Cost: Free per call.

## Path parameters

- `id` string, required

## Response `200`

Check one monitor's poll status and last-seen tweet id.

- object
  - `id` string: The monitor's id.
  - `status` string: "active" or "paused".
  - `degraded` boolean: Whether monitoring is currently serving this monitor slower than the published interval.
  - `poll_interval_ms` integer: Current poll interval in milliseconds.
  - `events_possibly_missed` integer: Running count of possibly-missed events.
  - `last_tweet_id` string, nullable: The most recent tweet id this monitor has delivered, or null before its first poll.
  - `last_poll_at` string, nullable: ISO 8601 timestamp of the most recent poll, or null before the first one.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

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