Search for a person by name, phone number, and address

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.

Query Parameters

phone?Phone Number|Phone Number

Phone number to search for a person by

Example"(216) 676-6366"

Example"216-676-6366"

Example"2166766366"

Example"+1-800-676-6366"

name?Name|Name

Full name, first name, last name, or partial name match for the person

Example"Marsha Mellow"

Example"Marsha"

Example"Mellow"

Example"Smith"

first_name?First Name|First Name

First name of the person. Cannot be used with 'name' parameter.

Example"Marsha"

Example"John"

middle_name?Middle Name|Middle Name

Middle name of the person. Cannot be used with 'name' parameter.

Example"Ann"

Example"Michael"

last_name?Last Name|Last Name

Last name of the person. Cannot be used with 'name' parameter.

Example"Mellow"

Example"Smith"

street?Street|Street

Full or partial street address including street number, name

Example"123 Main St"

Example"Main Street"

city?City|City

Full city name

Example"Anytown"

Example"Seattle"

Example"Los Angeles"

state_code?StateCodeEnum|State Code

2-Letter code representing a state name

Example"CA"

Example"NY"

Example"WA"

zipcode?5-Digit ZIP Code|5-Digit ZIP Code

Full 5-digit ZIP code

Example"94102"

Example"98101"

include_historical_locations?Include Historical Locations|Include Historical Locations

Include historical addresses in search. When false (default), only current addresses are included.

Examplefalse

Exampletrue

min_age?Minimum Age|Minimum Age

Minimum age of the person to search for, must be between 18 and 65

Example18

Example25

Example30

max_age?Maximum Age|Maximum Age

Maximum age of the person to search for, must be between 18 and 65

Example65

Example80

Example100

radius?Search Radius|Search Radius

Search radius in miles for distance-based filtering

Example2.5

Example5

Example10

Header Parameters

X-Api-Key*string

API Key for Authentication

Example""

Response Body

`application/json`

curl -X GET "https://loading/v1/person/" \
  -H "X-Api-Key: "

curl -X GET "https://loading/v1/person/" \  -H "X-Api-Key: "

[
  {
    "id": "string",
    "name": "string",
    "aliases": [
      "string"
    ],
    "is_dead": true,
    "current_addresses": [
      {
        "id": "string",
        "address": "string",
        "latlong": {
          "lat": 0,
          "lng": 0
        }
      }
    ],
    "historic_addresses": [
      {
        "id": "string",
        "address": "string",
        "latlong": {
          "lat": 0,
          "lng": 0
        }
      }
    ],
    "owned_properties": [
      {
        "id": "string",
        "address": "string"
      }
    ],
    "phones": [
      {
        "number": "string",
        "type": "mobile",
        "score": 0
      }
    ],
    "emails": [
      "string"
    ],
    "date_of_birth": "string",
    "linkedin_url": "string",
    "company_name": "string",
    "job_title": "string",
    "relatives": [
      {
        "id": "string",
        "name": "string"
      }
    ]
  }
]

{
  "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": 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

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`