---
title: "Monitor limits"
method: GET
path: "/monitors/limits"
tags: ["Monitors"]
---

# Monitor limits

`GET /monitors/limits`

Returns how many monitors the account has and the maximum it allows.

## Response `200`

Monitor usage and plan limit

- MonitorsLimitsResponse
  - `monitors_used` integer, required — Number of monitors the account currently has.
  - `monitors_limit` integer, required — Maximum number of monitors allowed for the account. Defaults to the plan allowance unless a custom limit is set for the organization.
  - `plan` 'free' | 'starter' | 'pro' | 'scale', required — The plan tier the limit was resolved from.

## Other responses

- `401` — Unauthorized

## Changes

> 26 revisions in range; 16 could not be searched.

- **2026-07-31** `f5c503b03f98` — 4 warning
  - added the new `BATCH_LIMIT_EXCEEDED` enum value to the `error_code` response property for the response status `401`
  - added the new `BATCH_NOT_CANCELLABLE` enum value to the `error_code` response property for the response status `401`
  - added the new `BATCH_NOT_COMPLETED` enum value to the `error_code` response property for the response status `401`
  - added the new `IDEMPOTENCY_KEY_CONFLICT` enum value to the `error_code` response property for the response status `401`
- **2026-07-26** `35f1d8d4ea26` — 2 warning
  - added the new `MONITOR_NO_WEBHOOK` enum value to the `error_code` response property for the response status `401`
  - added the new `PAID_PLAN_REQUIRED` enum value to the `error_code` response property for the response status `401`
- **2026-07-21** `3764d9c86493` — 9 warning
  - added the new `COLLECTION_PAUSED` enum value to the `error_code` response property for the response status `401`
  - added the new `DISPOSABLE_EMAIL_DETECTED` enum value to the `error_code` response property for the response status `401`
  - added the new `FREE_EMAIL_DETECTED` enum value to the `error_code` response property for the response status `401`
  - added the new `MONITOR_LIMIT_EXCEEDED` enum value to the `error_code` response property for the response status `401`
  - …5 more
- **2026-07-09** `de91b92d5fb7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/context/apis/context-dev/changes/monitors/limits/get.md)

---

[API](https://skmtc.dev/context/apis/context-dev.md) · [All operations](https://skmtc.dev/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/context-dev/revisions/1febe5476266/schema)