Get Rate Limit Rule

GET /v1/firewall/rate-limits/{uuid}

Read full configuration of one rate-limit rule. Same shape as a single entry from /firewall/rate-limits.

Path parameters

uuid string (uuid) Req
The rule's uuid from /firewall/rate-limits.

Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.

Response (200 OK)

Same fields as list entries (uuid, endpoint_uuid, user_uuid, account_uuid, name, requests_per_window, window_size_seconds, action, status, priority, created_at, updated_at), with its conditions (omitted when it has none). description and the legacy source_ip are omitted when unset. Its match statistics are the ones its list row shows, over the same 7-day window: hit_count, and last_matched / hits_daily (both omitted when the rule hasn't matched in the window). Best-effort, as on the list: 0 and omitted when the stats can't be read.

Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.

Errors

400 Bad Request
An integer id after the sunset (integer_id_unsupported).
401 Unauthorized
Missing auth.
404 Not Found
Rule doesn't exist or belongs to another account (both read Rate limit rule not found).
Request
curl "https://api.ngris.com/v1/firewall/rate-limits/019b344f-6477-7b07-8dac-7d370474eab1" \ -H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") rl = client.firewall.get_rate_limit("019b344f-6477-7b07-8dac-7d370474eab1") src = rl.get("source_ip") or "any" print(f"{rl['name']}: {rl['requests_per_window']}/{rl['window_size_seconds']}s from {src}")
Response — 200 OK
{ "uuid": "019b344f-6477-7b07-8dac-7d370474eab1", "endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e", "user_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "account_uuid": "019a68b9-1a79-7820-a884-41f554aba6bd", "name": "anti-abuse", "requests_per_window": 1000, "window_size_seconds": 60, "action": "block", "status": "active", "priority": 100, "created_at": "2026-04-01T00:00:00Z", "updated_at": "2026-04-01T00:00:00Z", "hit_count": 12, "last_matched": "2026-04-29T12:58:10Z", "hits_daily": [0, 2, 1, 0, 4, 3, 2] }
Was this helpful?
On this page
Get Rate Limit Rule
Was this helpful?
Homepage Docs Dashboard Docs API Docs nvelox Dashboard