---
title: "Get Plan Usage"
method: GET
path: "/v1/plans/usage"
tags: ["Plans"]
---

# Get Plan Usage

`GET /v1/plans/usage`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/plans/usage`
- Auth: API key in header `Authorization`

Return your organization's plan, its limits, and how much of it you use.

## Headers

- `X-Organization-Id` string, uuid, nullable

## Response `200`

Successful Response

- PlanUsageResponse: The organization's plan, its limits and its current usage.
  - `plan` 'FREE' | 'PLUS' | 'PRO' | 'MAX' | 'ENTERPRISE', required: Subscription tier of an organization; gates feature/usage limits.
  - `limits` PlanLimitsRead, required: Public view of a single plan's limits.
    - `tier` 'FREE' | 'PLUS' | 'PRO' | 'MAX' | 'ENTERPRISE', required: Subscription tier of an organization; gates feature/usage limits.
    - `max_monitors` integer, nullable, required
    - `min_interval_seconds` integer, required
    - `max_fast_monitors` integer, nullable, required
    - `fast_interval_threshold_seconds` integer, required
    - `max_regions` integer, nullable, required
    - `history_retention_days` integer, required
    - `allowed_channel_types` ChannelType[], required
    - `max_channels` integer, nullable, required
    - `max_heartbeats` integer, nullable, required
    - `max_maintenance_windows` integer, nullable, required
    - `max_status_pages` integer, nullable, required
    - `max_status_page_subscribers` integer, nullable, required
    - `renotify_interval_seconds` integer, required
    - `renotify_max_count` integer, required
    - `max_api_keys` integer, required
    - `api_rate_limit_per_minute` integer, required
    - `allowed_regions` string[], required
  - `usage` PlanUsageRead, required: How much of its plan an organization uses right now.
    - `monitors` integer, required: Monitors, paused ones included.
    - `fast_monitors` integer, required: Monitors with an interval below the fast threshold.
    - `heartbeats` integer, required

## Other responses

- `422`: Validation Error

---

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