Rate Limiting
To ensure stable and fair usage of the UK DNS Privacy Project API, we enforce a rolling rate limit based on a 5-minute window.
Current Rate Limit
- 300 requests per 5 minutes per client
- This averages to 1 request per second
- Exceeding this limit will result in a
429 Too Many Requests
response
Response Headers
When the limit is exceeded, the response may include:
Header Name | Description |
---|---|
Retry-After |
Number of seconds to wait before retrying |
Example Error Response
HTTP/1.1 429 Too Many Requests
Retry-After: 15
Content-Type: application/json
Best Practices
- Implement client-side throttling to stay under 300 requests per 5 minutes
- Batch actions when possible (e.g., creating multiple records in one request)
- Respect
Retry-After
headers when received - Use caching and avoid unnecessary polling
Need a Higher Limit?
If your application needs a higher limit due to legitimate high-volume use cases, please contact us.