Checking Your Quota Status
Monthly Quota
Your billing month begins on the day you pay for your subscription plan. For example, if you subscribed on April 5, your subscription covers the time span where May 4 is the last date. If you pay for a renewal on June 2, the last date of the next billing month will be June 4.
Your subscription plan gives you a significant, yet limited, number of requests to the Dateno API per billing month. This number is known as a monthly quota. When choosing a subscription plan, you can find the monthly quota in each plan's description.
Each time you send a request, your monthly quota decreases by one. The Dateno server returns an error code 429 if your monthly quota is exhausted, even if the current billing month is not yet over. The monthly quota resets to the full monthly limit at the beginning of each billing month or when you upgrade your subscription plan.
IMPORTANT
If you have not fully used your monthly quota, the remaining requests will not carry over into the next billing month.
Daily Quota
Most subscription plans limit the number of requests you can send to the Dateno server within any continuous 24-hour period. This number is known as a daily quota. Each time you send a request, your daily quota decreases by one. The Dateno server returns an error code 429 if your daily quota is exhausted. You can resume using the Dateno API once the number of requests sent less than 24 hours ago drops below your daily quota.
Monitoring Quota Usage
When debugging an application or intensively consuming our data assets, it may be critical to know how much of your quota remains to avoid unexpected service interruptions or cost increases.
Dateno includes billing data about your quota and its current status in the response to every request—whether successful or not. This billing data is provided in the response HTTP headers, as described in the table below.
| Response HTTP Header | Data |
|---|---|
X-RateLimit-Limit-Day | Your daily request limit |
X-RateLimit-Limit-Month | Your monthly request limit |
X-RateLimit-Remaining-Month | Number of requests remaining for the current month |
X-RateLimit-Remaining-Day | Number of requests remaining for the current day |
RateLimit-Reset | Number of seconds remaining before your current daily limit resets |