Gets person details by id
Retrieve detailed person information by Whitepages person ID.
Authorization
ApiKeyAuth API key for authentication. Get your key from the Whitepages developer portal.
In: header
Path Parameters
Person ID: P followed by 10 alphanumeric characters
"PABcd12345e""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"
}Related
Search for a person by name, phone number, and address
Retrieve person information with match scores and enriched emails.
Entity Shapes by Context
The same entity comes back in different shapes depending on the endpoint. Do not assume one shape.
Person Search
Look up individuals by name, phone, or address
Authentication
Learn how to authenticate your requests to the Whitepages Pro API.
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.