---
title: "Get Rate Limits"
method: GET
path: "/v1/limits/"
tags: ["limits"]
---

# Get Rate Limits

`GET /v1/limits/`

Show how much of your rate limits is left.

Reading this does not use up any of the limits it reports, so it is safe to call before
a batch of work or after a 429 to see when you can continue. `automation-runs` only
applies to `POST /automations/{trigger_id}/run`, the rest apply to every endpoint.

## Response `200`

Successful Response

- RateLimitStatus
  - `tier` 'free' | 'premium', required — Plan your limits are taken from.
  - `guild_id` integer, required — Server the API key belongs to, and that these limits are counted for.
  - `limits` BucketState[], required — Every limit that can apply to your requests.
    - `name` string, required — Name of the limit, matching the `X-RateLimit-Bucket` header.
    - `window_seconds` integer, required — Length of the window the limit is counted over.
    - `limit` integer, required — Requests allowed in that window on your plan.
    - `remaining` integer, required — Requests you have left in the current window.
    - `reset_at` integer, required — Unix timestamp in seconds of when the window resets.
    - `description` string, required — What this limit covers.

---

[API](https://skmtc.dev/monni/apis/fastapi.md) · [All operations](https://skmtc.dev/monni/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monni/fastapi/revisions/0321cc5200a6/schema)