Whitepages

Authentication

Learn how to authenticate your requests to the Whitepages API.

All API requests require a valid API key provided in the X-Api-Key header.

API Key

Include your API key in every request using the X-Api-Key header:

curl -X GET "https://api.whitepages.com/v1/person/" \
  -H "X-Api-Key: your-api-key-here"

Keep your API key secure. Do not expose it in client-side code or public repositories.

Obtaining an API Key

Contact our support team at support@whitepages.com for API key provisioning and management.

Error Responses

If authentication fails, you will receive a 403 Forbidden response:

{
  "message": "Forbidden"
}

Common causes for authentication errors:

  • Missing X-Api-Key header
  • Invalid or revoked API key
  • API key not authorized for the requested endpoint

On this page