REST Rate Limiting
Introduction
HM Land Registry may need to restrict the usage of an API to protect it from excessive use. These rate limits are subject to change based on expected loads and uptake of the service.
If the rate limit is exceeded you’ll get a HTTP 429 response (Too Many Requests). HTTP headers will be provided in the response to inform you when the next request may be made.
We currently promote a sliding window rate limiting policy, this ensures an initial burst of requests can be sent and slowly replenished over time. Where possible spreading requests out over time is highly advised.
If you are concerned with a rate limit, you may contact us and we can discuss whether increasing the rate limit is appropriate. Please contact us at channelpartners@landregistry.gov.uk (clicking this link will open a new window).
Rate Limit Scopes
Depending on the service, rate limits may be applied at different levels.
| Scope | Description |
|---|---|
| Account | Each user login account is subjected to their own rate limit. |
| Business Unit | Each business unit and all it's users cannot exceed a given rate limit. |
Response Headers
All REST/JSON APIs now have consistant rate limiting headers.
| Key | Value | Description |
|---|---|---|
RateLimit-Limit |
70 | The total number of requests that may be accrued. |
RateLimit-Remaining |
68 | The current number of requests that can be made before receiving a 429. |
RateLimit-Reset |
5 | The numbers of seconds to wait before the quota completely resets. |
Retry-After |
0 | The numbers of seconds to wait before sending another request. |
Expected Limits
The expected rate limit policies apply by default.
| Service | Scope | Limit |
|---|---|---|
| Estimate Completion Date | Business Unit | 150 per minute |
| Official Copies Document Availability | Business Unit | 150 per minute |
| Registered Proprietor Names | Account | 6 per minute |
Deprecated Response Headers
These headers have been used in the past and will be removed no earlier than June 1st 2025. We recommend no longer using these and migrating over to the newer headers when possible.
Official Copies Document Availability
| Deprecated Header | New Header |
|---|---|
x-rate-limit-burst-capacity |
RateLimit-Limit |
x-rate-limit-remaining |
RateLimit-Remaining |
x-rate-limit-replenish |
Removed |
x-rate-limit-requested-tokens |
Removed |
Registered Proprietor Names
| Deprecated Header | New Header |
|---|---|
x-rate-limit-remaining |
RateLimit-Remaining |
x-rate-limit-retry-after |
Retry-After |
Estimate Completion Date
| Deprecated Header | New Header |
|---|---|
x-rate-limit-burst-capacity |
RateLimit-Limit |
x-rate-limit-remaining |
RateLimit-Remaining |
x-rate-limit-replenish |
Removed |
x-rate-limit-requested-tokens |
Removed |