---
title: "Rate Limit Limit"
method: POST
path: "/api/v1.rate-limit.limit"
tags: ["Rate Limiter"]
---

# Rate Limit Limit

`POST /api/v1.rate-limit.limit`

Rate Limiter Check and Consume

## Request body

- RateLimitCheckIn
  - `namespace` string, nullable
  - `key` string, required
  - `tokens` integer — Number of tokens to consume (default: 1)
  - `config` RateLimitConfig, required
    - `capacity` integer, required — Maximum capacity of the bucket
    - `refill_amount` integer, required — Number of tokens to add per refill interval
    - `refill_interval_ms` integer — Interval in milliseconds between refills (minimum 1 millisecond)

## Response `200`

- RateLimitCheckOut
  - `allowed` boolean, required — Whether the request is allowed
  - `remaining` integer, required — Number of tokens remaining
  - `retry_after_ms` integer, nullable — Milliseconds until enough tokens are available (only present when allowed is false)

## Other responses

- `400`
- `401`
- `403`
- `422`

---

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