The 429 "Too Many Requests" error is a signal that you have hit the limit of your allowed requests. This could occur in a variety of circumstances, but is most common when a Pay-As-You-Go customer uses all of their 2,500 allotted free lookups per day and no credit card is present to pay the lookups beyond that threshold. It can also occur when a usage limit has been implemented on their account.
Troubleshooting Options
Add a credit card to your account
If you are a Pay-As-You-Go customer, we provide you with 2,500 free lookups each day, after which the cost is $0.50 for every 1,000 additional lookups. However, if you hit the 2,500 lookup threshold and no credit card is present, an error will be triggered.
If you would like to proceed with your additional lookups, all you need to do is add a credit card in the Billing section of your account dashboard. Keep in mind that the card will not be billed right away. We calculate your total billable lookups at the end of each month and charge you on the first of the following month (i.e. your usage in January would be billed on February 1st).
Check to see if you have a usage limit configured on your account
Geocodio offers Pay-As-You-Go customers the option to set a usage limit on their account to prevent them from exceeding a certain number of lookups. This setting can be configured to limit your account to a certain number of lookups per day or to automatically trigger when you've run out of pre-purchased lookup credits.
To verify if you have usage limits set-up, navigate to the Billing section in your account dashboard and click the Usage Limits tab.
You can toggle usage limits off whenever you would like. However, you could also fix this error by increasing the number of allowed daily lookups. Customers can set a limit of up to 50,000 lookups per day.
If your Usage Limit is configured to trigger when you've run out of pre-purchased credits, you could elect to purchase additional lookup credits here.
Do nothing
The "Too Many Requests" error was put in place as a notification as much as an error. You may have a good reason not to troubleshoot this error at all.
For example, if you've hit your limit of 2,500 free lookups in a day, your limit will reset the following day. You may wish to wait to add a credit card.
Similarly, if you've set a usage limit in the past, that may have been to achieve a specific purpose. You do not need to change the usage limit unless you'd like to. If you've set a daily limit, it will reset on the following day.