What happens when I hit the Free limit?

On the Free plan, once you’ve used your 100 monthly requests, further validation calls return HTTP 429 (RATE_LIMITED) until your quota resets at the next monthly period. There’s no overage on Free.

What the response looks like

The rejected call returns the standard error envelope:

• HTTP status 429;
• error.code set to RATE_LIMITED, with a message that includes your limit and usage;
• a requestId you can quote if you contact support.

The RateLimit-* headers are still present on that 429, so RateLimit-Reset tells you the exact reset time as Unix epoch seconds. A 429 is not charged against your quota. The error reference has the full response shape.

Seeing it coming

The RateLimit-* response headers tell you exactly where you stand before you hit the wall. From about 80% usage, Free-plan responses also include a Vatnode-Quota-Warning header, which you can log or alert on. Bulk jobs behave the same way: once the Free quota is used up, the remaining positions come back with RATE_LIMITED and the job still finishes.

Your options

• Wait for the reset. Your quota returns to the full limit when the next monthly period starts.
• Upgrade. To keep validating in the same period, upgrade to a paid plan. The upgrade takes effect immediately, and paid plans keep processing past the included quota instead of rejecting calls.
• Cache on your side. Skipping repeat checks of numbers you validated recently stretches a small quota further.