Person
Gets person details by id
Retrieve detailed person information by Whitepages person ID.
Authorization
ApiKeyAuth x-api-key<token>
API key for authentication. Get your key from the Whitepages developer portal.
In: header
Path Parameters
id*string
Person ID: P followed by 10 alphanumeric characters
Example
"PABcd12345e"Example
"P1234567890"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.whitepages.com/v2/person/PABcd12345e"{
"result": {
"id": "string",
"name": "string",
"aliases": [
"string"
],
"is_dead": true,
"owned_properties": [
{
"id": "string",
"address": "string"
}
],
"phones": [
{
"number": "string",
"type": "mobile",
"score": 0
}
],
"date_of_birth": "string",
"linkedin_url": "string",
"company_name": "string",
"job_title": "string",
"relatives": [
{
"id": "string",
"name": "string"
}
],
"current_addresses": [
{
"address_id": "string",
"full_address": "string",
"city": "string",
"state": "string",
"line1": "string",
"zip": "string"
}
],
"historic_addresses": [
{
"address_id": "string",
"full_address": "string",
"city": "string",
"state": "string",
"line1": "string",
"zip": "string"
}
],
"match_score": 0,
"matched_by": [
"string"
],
"emails": [
{
"email": "string",
"score": 0
}
]
}
}{
"error": {
"code": 400,
"message": "Bad Request",
"long_message": "Invalid person ID format: 'sdf'. Person ID must start with 'P' followed by exactly 10 alphanumeric characters. Example: 'PABcd12345e' or 'P1234567890'.",
"meta": null
},
"wp_trace_id": "3b0b537a60d84057817bb40563ca5c99"
}{
"message": "Forbidden"
}{
"error": {
"code": 404,
"message": "Not Found",
"long_message": "Person id not found: PABcd12345e",
"meta": null
},
"wp_trace_id": "0c57473114bd49b3b3c4b585df624f2f"
}{
"error": {
"code": 400,
"message": "Short error message",
"long_message": "The request was malformed",
"meta": {
"field": "email",
"validation_error": "Invalid email format"
}
},
"wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"message": "Too Many Requests"
}{
"error": {
"code": 400,
"message": "Short error message",
"long_message": "The request was malformed",
"meta": {
"field": "email",
"validation_error": "Invalid email format"
}
},
"wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}Search for a person by name, phone number, and address GET
Retrieve person information with match scores and enriched emails.
Create a webhook subscription POST
Register a new webhook subscription for property events. The endpoint URL is validated on creation — it must be reachable and return a 2xx response. Currently supports `deed.*` events scoped to Texas counties.