Billing
Understand how API usage is tracked and billed.
API usage is tracked and billed based on successful requests.
Billing Rules
| Response Type | Billable |
|---|---|
| 2xx (Success) | Yes |
| 4xx (Client Error) | Yes |
| 5xx (Server Error) | No |
| 429 (Rate Limit) | No |
Only requests to Person and Property endpoints are charged. Account endpoints are not billable.
Billable Requests
All 2xx (success) and 4xx (client error) responses from Person and Property endpoints are charged to your account.
Non-Billable Requests
The following responses are not charged:
5xx(server error) responses - issues on our end429(rate limit) responses - when you've exceeded rate limits
Billing Period
Usage is calculated from the start of the month in UTC time. Your billing cycle resets on the 1st of each month at 00:00 UTC.
Usage Reports
Detailed usage reports are available through the Account Usage endpoint. You can query:
- Daily request counts
- Usage over custom date ranges (up to 90 days)
- Total requests for a time period
Support
For billing inquiries, quota adjustments, or plan changes, please contact our team at support@whitepages.com.
Rate Limits
Understand the rate limiting policies for the Whitepages API.
Search for a person by name, phone number, and address GET
Retrieve person information based on the provided query parameters. This endpoint accepts a person query request and returns full details for up to the top 15 matching persons from Whitepages data.