Too many requests

What it means

The endpoint's budget for this minute is spent. Every response — not just this one — carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset, so a well-behaved client never has to discover the limit by hitting it.

What to do

Wait the number of seconds in Retry-After. Watch RateLimit-Remaining and slow down before it reaches zero. Signing in raises the budget substantially.

The response

{
  "type": "https://casanova.realty/problems/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "A sentence about this particular occurrence.",
  "instance": "/api/v1/properties/some-listing"
}

Content type is application/problem+json. Match on type, not on title — the title is prose and may be rewritten.