Usage Limits

The IP Location API has usage limits to ensure fair use and service availability for all users. This page explains the usage limits, how to recognize when you have exceeded them, and what steps to take to resolve these issues.

Understanding Usage Limits

Each API key comes with a specific usage limit, which is the maximum number of API calls you can make within a given period. This limit depends on your subscription plan.

Error Code for Exceeding Usage Limits

When your API calls exceed the allowed limit, the API returns a 429 Too Many Requests error with a specific error message indicating that the usage limit has been exceeded.

Example Response:

{
  "error": true,
  "errorMessage": "API limit exceeded. Please upgrade your plan through the Dashboard."
}

Monitoring Usage

To help you manage your usage, the API tracks the number of calls made with your API key. You can monitor your usage through the Dashboard, where you can see real-time statistics on your API call counts.

Upgrading Your Plan

If you find that you are frequently exceeding your usage limits, consider upgrading your subscription plan to increase your quota. You can upgrade your plan through the Dashboard.

Email Notifications

To keep you informed, we send email notifications when your usage reaches 80% of your monthly API quota. These notifications help you take proactive steps to avoid hitting your limit unexpectedly.

API Usage Count Reset

The API usage count resets at 12 AM UTC on the 1st of every month. This means your usage limits are reset to 0, allowing you to start the new month with your full quota of API calls. To ensure uninterrupted service, it’s important to monitor your usage and select a plan that aligns with your needs.

Steps to Resolve Usage Limit Issues

Monitor your usage: Regularly check the Dashboard to keep track of your API call counts.
Upgrade your plan: If you are close to or exceeding your limit, upgrade your subscription plan to increase your quota.
Optimize your API calls: Review your application to ensure that API calls are made efficiently and only when necessary.