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 Requestsresponse
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-Afterheaders 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.