---
title: "Get Rate Limits and Usage"
method: GET
path: "/v1/rate/limits"
tags: ["Rate Limiting", "Account Management"]
---

# Get Rate Limits and Usage

`GET /v1/rate/limits`

Retrieve current rate limit status and usage statistics for the authenticated user across multiple time windows.

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- RateLimitsOutput
  - `success` boolean, nullable — Indicates whether the rate limits request was successful.
  - `rate_limits` RateLimitsInfo, required
    - `minute` RateLimitWindow, required
      - `count` integer, required — The number of requests made in this time window.
      - `limit` integer, required — The maximum number of requests allowed in this time window.
      - `exceeded` boolean, required — Whether the rate limit has been exceeded for this time window.
      - `remaining` integer, required — The number of requests remaining before hitting the limit.
      - `reset_time` string, required — ISO timestamp when the rate limit will reset.
    - `hour` RateLimitWindow, required
      - `count` integer, required — The number of requests made in this time window.
      - `limit` integer, required — The maximum number of requests allowed in this time window.
      - `exceeded` boolean, required — Whether the rate limit has been exceeded for this time window.
      - `remaining` integer, required — The number of requests remaining before hitting the limit.
      - `reset_time` string, required — ISO timestamp when the rate limit will reset.
    - `day` RateLimitWindow, required
      - `count` integer, required — The number of requests made in this time window.
      - `limit` integer, required — The maximum number of requests allowed in this time window.
      - `exceeded` boolean, required — Whether the rate limit has been exceeded for this time window.
      - `remaining` integer, required — The number of requests remaining before hitting the limit.
      - `reset_time` string, required — ISO timestamp when the rate limit will reset.
  - `limits` RateLimitLimits, required
    - `maximum_requests_per_minute` integer, required — The maximum number of requests allowed per minute.
    - `maximum_requests_per_hour` integer, required — The maximum number of requests allowed per hour.
    - `maximum_requests_per_day` integer, required — The maximum number of requests allowed per day.
    - `tokens_per_agent` integer, required — The maximum number of tokens allowed per agent.
  - `tier` string, nullable, required — The user's current subscription tier (free or premium).
  - `timestamp` string, nullable, required — ISO timestamp when the rate limits information was retrieved.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/swarms/apis/swarms-api.md) · [All operations](https://skmtc.net/swarms/apis/swarms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swarms/swarms-api/versions/2575bd7539ca/schema)