---
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`

## Request

- Base URL: `https://api.swarms.world`
- URL: `https://api.swarms.world/v1/rate/limits`
- Auth: none declared. Required headers: `x-api-key`

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

## Changes

- **2026-10-16** `500c79520e41`: 4 info
  - api tag `Account Management` added
  - api tag `Rate Limiting` added
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/changes/v1/rate/limits/get.md)

---

[API](https://skmtc.dev/the-swarm-corporation/apis/swarms-api.md) - [All operations](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/revisions/fca99f497199?raw)