Skip to content
Documentation · 429 Rate limit exceeded

Conventions

429 Rate limit exceeded

Problem type https://www.getproperly.com/developers/errors/rate-limited

HTTP status 429
type https://www.getproperly.com/developers/errors/rate-limited
title Rate limit exceeded
Content-Type application/problem+json

When it occurs

The API key exceeded the rolling 2-second window (100 requests) or the rolling 24-hour quota (30,000 requests).

Example

429 Rate limit exceeded
{
  "type": "https://www.getproperly.com/developers/errors/rate-limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit exceeded (rate)",
  "instance": "/v1/bookings",
  "code": "rate_limited",
  "requestId": "aQ3fT8xW1m"
}

Handling

  • The response carries Retry-After (seconds). Pause until it elapses, then resume.
  • detail is "Rate limit exceeded (rate)" for the 2-second window and "Rate limit exceeded (quota)" for the daily quota.
  • A request blocked by the 2-second window does not consume daily quota.

All problem types are listed on the Errors page.

Type to search the Platform API docs.