# Rate Limits

We implemented several types of rate limits.

# Per-Day Rate Limits (hard, free tier only)

If you are not subscribed to our paid plan, you can only make 1000 request against our address autocomplete API per day. This limit is strictly enforced. All following request will respond with a 402 status code.

Per-Day rate limits are reset at 00:00 UTC.

# Per-Minute Rate Limits (hard)

In order to protect our infrastructure from unexpected spikes, we implemented a per secong rate limit.

  • Users not subscribed to our paid plan have a per minute rate limit of 60.
  • Users subscribed to our paid plan have a per minute rate limit of 3000. (Feel free to get in touch with us in case you need a higher per minute rate limit)

When reachig your Per-Minute rate limit, our API responses with a 429 status code.

# Retrieve your Per-Minute Rate Limits

Every response from our API includes the following headers:

  • X-RateLimit-Limit The maximum number of requests you're permitted to make per minute.
  • X-RateLimit-Remaining The number of requests remaining in the current rate limit window.
  • X-RateLimit-Reset Timestamp at which the current rate limit window resets. This header is only present when your requests are rate limited.
  • Retry-After Number of seconds after which you can try your request again. This header is only present when your requests are rate limited.