Q: Do unused queries roll over to the next month?

No. Unused queries <strong>do not</strong> roll over. Each month's query allocation resets at the start of your billing cycle.

Question 1

Can I use my existing Whitepages account to purchase an API plan?

Accepted Answer

We recommend using a separate business email address. If you do not have one, you can manually append +api to your email (e.g. john.smith@company.com => john.smith+api@company.com)

Question 2

What counts as a billable query?

Accepted Answer

A billable query is any Person or Property request that returns a 2xx success or 4xx client error response. 429 rate limit and 5xx server error responses are not billable.

Usage is tracked monthly in Pacific Time (PT) and is available via the /v1/account/usage endpoint.

Question 3

What are the API rate limits?

Accepted Answer

The Whitepages Pro API enforces rate limits to ensure reliable performance. If your integration exceeds the allowed rate, the API returns a 429 Too Many Requests response with retry details. 429 responses are not billable.

Rate limits vary by plan, and higher limits can be requested through support.

Question 4

What happens if I exceed my monthly query limit?

Accepted Answer

If you exceed your monthly query limit, additional queries are billed at your plan's standard per-query rate. You can see each plan's rate in the pricing table (for example, the Pro plan bills overages at $0.20 per query, so 1,200 extra queries would cost 1,200 × $0.20 = $240).

If your usage regularly exceeds your included queries, you may want to upgrade to a higher tier or request a custom quote for volumes above 50,000 queries per month.

Question 5

Do unused queries roll over to the next month?

Accepted Answer

No. Unused queries do not roll over. Each month's query allocation resets at the start of your billing cycle.

Question 6

Can I upgrade, downgrade, or cancel my plan at any time?

Accepted Answer

Yes. You can adjust your plan tier at any time. Changes take effect at the start of your next billing cycle.

Question 7

How does billing work?

Accepted Answer

All API plans are billed monthly on autopay. Any overage charges are added to your next month's invoice. For billing purposes, all API usage data is recorded, measured, and calculated in Pacific Time (PT).

Question 8

Where can I find full API documentation?

Accepted Answer

All API reference docs, endpoints, authentication details, and sample responses are available at https://api.whitepages.com/docs.

Flexible Pricing with No Long-Term Contracts or Hidden Fees

What Whitepages Pro API Customers Are Saying

Unmatched Data Accuracy

Easy to Use

Invaluable for Businesses

FAQs about Whitepages Pro API Pricing