HTTP Status 429 - Too Many Requests

GET /api/data HTTP/1.1
Host: api.example.com
Authorization: Bearer token123

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1696176000
Content-Type: application/json

{
  "error": "rate_limit_exceeded",
  "message": "API rate limit exceeded",
  "limit": 1000,
  "window": "1 hour",
  "reset_at": "2025-10-01T15:00:00Z"
}

POST /api/reports HTTP/1.1
Host: api.example.com
Authorization: Bearer user_token

HTTP/1.1 429 Too Many Requests
Retry-After: Mon, 02 Oct 2025 00:00:00 GMT
Content-Type: application/json

{
  "error": "daily_quota_exceeded",
  "message": "You have used all 10 report generations for today",
  "quota": 10,
  "used": 10,
  "reset": "2025-10-02T00:00:00Z",
  "upgrade": "https://billing.example.com/upgrade"
}

GET /api/public/search HTTP/1.1
Host: api.example.com

HTTP/1.1 429 Too Many Requests
Retry-After: 120
X-RateLimit-Type: ip-based
Content-Type: application/json

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests from this IP address",
  "limit": "100 requests per 5 minutes",
  "client_ip": "203.0.113.42"
}