Search for Information on a Phone Number

Overview

Servers

https://api.spokeo.com/v5/

Name Search

Endpoint name: https://api.spokeo.com/v5/names

Use Spokeo's Name Search tool to find verified person profiles, contact details, and related data based on a person's name.

Search by first and last name to identify individuals, verify identities, or enrich person records with verified contact and background information.

Overview

Use this endpoint when you have a person's first and last name (optional: middle name, city, or state) and want to locate verified profiles associated with that individual.

This endpoint returns person records that may include verified contact information, addresses, relatives, and aliases, along with unique IDs for further enrichment.

Name Search is commonly used for identity verification, background research, lead qualification, contact enrichment, and fraud prevention workflows.

When to Use

Use Name Search when you:

Want to identify or verify a person's profile, age, or location
Need to enrich CRM or customer records with verified contact and address data
Are performing identity verification, fraud detection, or background screening workflows

Do not use this endpoint to search by phone number, email, username, or street address — use Phone Search, Email Search, Username Search, or Address Search instead.

Required Parameters

first_name (string) - The person's first name. (Required)
last_name (string) - The person's last name. (Required)

Response Includes

A successful Name Search returns an array of verified person profiles and associated metadata. Each result may include:

Name - Verified first, middle, and last name
Age - Current age or age at death
Addresses - Known or current addresses (with street, city, state, ZIP, latitude, and longitude)
Phones - Verified phone numbers associated with the individual
Emails - Verified email addresses
Relatives - Family members or household relationships
Aliases - Known alternative names or name variations
Deceased Status - Indicator if the individual is deceased
Metadata - Result count, match confidence, and pagination details
Person ID - A unique identifier used for follow-up enrichment with Person ID Search
Social Profiles - Linked social media accounts, profile photos, and URLs
Work History - Job titles, company names, start and end dates, and whether the person is currently employed
Education History - Schools attended, attendance dates, and degrees earned

Common Use Cases

People Lookup - Identify verified profiles that match a person's name.
Identity Verification - Confirm that a name corresponds to a real person with verified contact data.
Lead Enrichment - Add verified phone, email, and address data to name-based CRM records.
Fraud and Risk Detection - Verify individuals before transactions or account creation.
Background and Due Diligence - Research individuals for compliance or screening workflows.

Operations

Person ID Search

Endpoint name: https://api.spokeo.com/v5/person_id/{id}

Use Spokeo’s Person ID Search tool to retrieve a complete, verified person profile using a unique Person ID.

Search by Person ID to enrich existing records with verified contact details, social profiles, addresses, and background information.

Overview

Use this endpoint when you already have a valid Person ID (from any other Spokeo search endpoint) and want to retrieve or enrich the full verified profile for that individual.

This endpoint returns detailed person data, including verified contact information, addresses, relatives, social profiles, and work history.

Person ID Search is commonly used for person record enrichment, CRM updates, compliance checks, identity verification, and investigative workflows.

When to Use

Use Person ID Search when you:

Want to retrieve the full verified person profile associated with that ID
Need to enrich CRM or contact records with verified name, phone, email, address, or social data
Are performing identity resolution, risk analysis, or investigative enrichment workflows

Do not use this endpoint to search by name, phone number, email, username, or street address — use Name Search, Phone Search, Email Search, Username Search, or Address Search instead.

Required Parameter

id (string) – The unique Person ID used to retrieve the full verified profile. (Required; no optional parameters)

Response Includes

A successful Person ID Search returns a verified person record and associated metadata. Each result may include:

Name – Full name (first, middle, last) and known aliases
Demographics – Gender, age, marital status, and deceased indicator (with death month/year, if applicable)
Addresses – Current and historical addresses (with city, state, ZIP, latitude, and longitude)
Phones – Verified phone numbers linked to the person
Emails – Verified email addresses
Social Profiles – Linked social media accounts (with platform name, URLs, and profile photos)
Relatives – Verified relatives or household members (each with their own Person ID for enrichment)
Work History – Employment data including company names, job titles, and employment dates
Education History – Schools attended, degrees earned, majors, and attendance dates
Certifications – Professional licenses, credentials, or certifications with issuing organizations and dates
Metadata – Verification confidence, match status, and enrichment source indicators

Common Use Cases

Person ID Lookup – Retrieve the complete verified profile associated with a known Person ID.
Contact Enrichment – Add verified phone, email, address, and social data to existing records.
Identity Verification – Confirm that a previously found ID corresponds to a real, verified individual.
Risk and Compliance Analysis – Support KYC, fraud prevention, or investigative workflows with verified profile data.
CRM Record Enhancement – Use Person IDs as stable references to keep customer profiles accurate and up to date.

Operations

Phone Search

Endpoint name: https://api.spokeo.com/v5/phones

Use Spokeo’s Phone Search tool to find verified people, contact information, and background details associated with a given phone number.

Search by phone number to identify or verify a person and enrich contact records.

Overview

Use this endpoint when you have a valid 10-digit U.S. phone number (mobile, landline, or VOIP) and want to identify or verify the real person associated with it.

This endpoint returns verified person profiles, contact details, and phone intelligence data connected to that number.

Phone Search is commonly used for contact enrichment, lead verification, fraud prevention, customer identification, and risk assessment.

When to Use

Use Phone Search when you:

Want to identify or verify ownership of that number
Need to enrich CRM or contact records with verified name, email, address, or social data
Are performing fraud detection, risk assessment, or lead qualification workflows

Required Parameter

phone (string) – The 10-digit U.S. phone number to search. (Required; no optional parameters)

Response Includes

A successful Phone Search returns an array of current and previous owners and associated metadata. Each result may include:

Name – Verified first and last name
Age – Current age or age at death
Contact Information – Verified phone numbers, email addresses, and current address (with city, state, ZIP, latitude, and longitude)
Social Profiles – Linked social media accounts, profile photos, and URLs
Work History – Job titles, company names, start and end dates, and whether the person is currently employed
Education History – Schools attended, attendance dates, and degrees earned
Phone Intelligence – Carrier name, line type (mobile, landline, VOIP), activity status, time zone, and spam risk level
Metadata – Match counts, verification confidence, and enrichment details
Person ID – A unique identifier used for follow-up enrichment with Profile Search

Common Use Cases

Reverse Phone Lookup – Identify who owns or uses a given phone number.
Contact Verification – Confirm that a number corresponds to a real person or business.
Fraud and Risk Prevention – Detect fake, disconnected, or high-risk phone numbers.
Lead Enrichment – Add verified attributes (name, email, address, and social data) to CRM or customer records.
Customer Identification – Resolve phone numbers to verified person profiles for compliance and personalization.

Operations

Search for Information on a Phone Number

Request

Query

phonestringrequired

The 10-digit US phone number you are using in your search.

curl -i -X GET \
  'https://api.spokeo.com/v5/phones?phone=string' \
  -H 'X-api-key: YOUR_API_KEY_HERE'

Responses

OK - A successful Phone Search returns an array of people associated with a phone number, as well as metadata.

Bodyapplication/json

dataobject

data.ownersArray of objects

data.owners[].is_current_ownerboolean

A value of "true" signifies that the person is the current owner of the phone number, while "false" signifies that the person is either a possible current owner or a previous owner.

data.owners[].agenumber

The person’s current age or age at death.

Example: 62

data.owners[].additional_phonesArray of objects

Additional phone numbers associated with the person.

data.owners[].addressesArray of objects

Addresses associated with the person.

data.owners[].schoolsArray of objects

Schools the person attended.

data.owners[].emailsArray of objects

Email addresses associated with the person.

data.owners[].namesArray of objects

Names associated with the person.

data.owners[].idstring

A unique identifier associated with the person. Input this ID into Person ID Search to retrieve person data, including contact information.

Example: 1234567890

data.owners[].relativesArray of objects

Relatives associated with the person.

data.owners[].social_profilesArray of objects

Social profiles associated with the person.

data.owners[].work_historyArray of objects

Jobs the person held.

data.owners[].confidence_scorenumber

The confidence level of the phone owner.

Example: 34.53

data.owners[].is_companyboolean

Indicates whether the owner is a person or company.

Example: false

data.owners[].is_deceasedboolean

Indicates whether the owner is deceased.

Example: false

data.owners[].death_monthnumber

Owner's death month as a number.

Example: 11

data.owners[].death_yearnumber

Owner's death year as a number.

Example: 2010

data.owners[].dob_monthnumber

The person’s dob month as a number.

Example: 3

data.owners[].dob_yearnumber

The person’s dob year as a number.

Example: 1943

data.owners[].start_datedate

The start date of this phone owner.

Example: "1996-01-12"

data.owners[].end_datedate

The end date of this phone owner.

Example: "2025-01-31"

data.area_code_locationsArray of objects

data.area_code_locations[].citystring

The city associated with the person.

Example: "Anytown"

data.area_code_locations[].latitudenumber

The latitude of the address associated with the person.

Example: 40.689247

data.area_code_locations[].longitudenumber

The longitude of the address associated with the person.

Example: -74.0451471

data.area_code_locations[].statestring

The state associated with the phone number's area code.

Example: "CA"

data.phone_infoobject

data.phone_info.activity_statusstring

Returns whether the phone line is “Active” or “Inactive”.

Example: "Active"

data.phone_info.activity_status_confidencestring

The confidence level of the activity status.

Example: "High"

data.phone_info.line_typestring

Returns whether the phone line is “Landline”, “Wireless”, or “VOIP”.

Example: "Wireless"

data.phone_info.listing_typestring

Returns whether the phone service is "Residential", "Business", or "Special Services".

Example: "Unknown"

data.phone_info.special_service_typestring

The type of special service associated with the phone number (e.g. “Information Provider”).

Example: null

data.phone_info.carrierstring

The company providing the phone service.

Example: "Verizon Wireless"

data.phone_info.carrier_typestring

The type of business for the carrier (e.g. “Wireless”).

Example: "Wireless"

data.phone_info.is_validboolean

A value of "true" signifies that the phone number is properly formed and assigned to a carrier.

data.phone_info.is_portableboolean

A value of "true" signifies that the phone number can switch carriers.

data.phone_info.time_zonestring

The time zone associated with the phone number's area code.

Example: "America/Anytown"

data.reputationobject

data.reputation.risk_levelstring

The risk level of the phone number.

Example: "High"

data.reputation.recent_search_countnumber

The number of recent searches of this phone number.

Example: 5

data.reputation.last_comment_datedate

The date of the last comment reported for this phone number.

Example: "2023-09-04"

data.reputation.is_toll_free_or_ercboolean

Flag to indicate whether the phone number is toll free or ERC.

Example: false

data.reputation.scorenumber

The reputation score of the phone number.

Example: 1

metadataobject

metadata.total_owner_countnumber

The total count in the array of owners returned based on your search inputs.

Example: 1

Response

application/json

{
  "data": {
    "owners": [
      {
        "is_current_owner": true,
        "age": 62,
        "additional_phones": [
          {
            "phone": 5551234567
          }
        ],
        "addresses": [
          {
            "address_id": "123a2bf|October Ln|47||",
            "street_address": "123 Main St",
            "city": "Anytown",
            "country": "United States",
            "latitude": 40.689247,
            "longitude": -74.0451471,
            "state": "MN",
            "zip": 55555,
            "start_date": "1996-01-12",
            "end_date": "2025-01-31"
          }
        ],
        "schools": [
          {
            "name": "Anytown University",
            "type": "University",
            "location": "Anytown, CA",
            "linkedin": "linkedin.com/school/anytown-university",
            "facebook": "facebook.com/anytownuniversity",
            "twitter": "twitter.com/anytownuniversity",
            "website": "anytownuniversity.edu",
            "start_date": 2010,
            "end_date": 2012,
            "degrees": [
              {
                "name": "computer science"
              }
            ]
          }
        ],
        "emails": [
          {
            "email": "username@email.com"
          }
        ],
        "names": [
          {
            "full_name": "John Smith",
            "first_name": "John",
            "last_name": "Smith",
            "name_type": "main"
          }
        ],
        "id": 1234567890,
        "relatives": [
          {
            "full_name": "Jane Smith",
            "first_name": "Jane",
            "last_name": "Smith"
          }
        ],
        "social_profiles": [
          {
            "profile_photo_url": "https://graph.facebook.com/123/picture?type=large&redirect=true",
            "profile_url": "https://www.facebook.com/jsmith"
          }
        ],
        "work_history": [
          {
            "title": "Product Manager",
            "company_name": "Spokeo"
          }
        ],
        "confidence_score": 34.53,
        "is_company": false,
        "is_deceased": false,
        "death_month": 11,
        "death_year": 2010,
        "dob_month": 3,
        "dob_year": 1943,
        "start_date": "1996-01-12",
        "end_date": "2025-01-31"
      }
    ],
    "area_code_locations": [
      {
        "city": "Anytown",
        "latitude": 40.689247,
        "longitude": -74.0451471,
        "state": "CA"
      }
    ],
    "phone_info": {
      "activity_status": "Active",
      "activity_status_confidence": "High",
      "line_type": "Wireless",
      "listing_type": "Unknown",
      "special_service_type": null,
      "carrier": "Verizon Wireless",
      "carrier_type": "Wireless",
      "is_valid": true,
      "is_portable": true,
      "time_zone": "America/Anytown"
    },
    "reputation": {
      "risk_level": "High",
      "recent_search_count": 5,
      "last_comment_date": "2023-09-04",
      "is_toll_free_or_erc": false,
      "score": 1
    }
  },
  "metadata": {
    "total_owner_count": 1
  }
}

Address Search

Endpoint name: https://api.spokeo.com/v5/addresses

Use Spokeo’s Address Search tool to find verified property information, property owners, residents, and related person data connected to a given street address.

Search by address to identify property details, confirm ownership, or enrich person and property records with verified insights.

Overview

Use this endpoint when you have a valid U.S. street address (street, city, and state; optional unit) and want to identify who lives there, who owns the property, or retrieve verified property data.

This endpoint returns a complete property and resident profile, including ownership details, property structure data, valuation insights, and nearby school information.

Address Search is commonly used for real estate research, fraud detection, lead qualification, due diligence, and identity verification.

When to Use

Use Address Search when you:

Want to identify property owners or current residents
Need to verify address details, property characteristics, or estimated valuation
Are performing real estate analysis, risk assessment, or fraud detection workflows

Required Parameters

street (string) – Street and address (e.g., “123 Main St”). (Required)
city (string) – City name. (Required)
state (string) – U.S. state (can be abbreviated). (Required)

Response Includes

A successful Address Search returns property, owner, and resident information along with related metadata. Each result may include:

Address Information – Verified street address, city, ZIP code, county, state, latitude, and longitude
Property Details – Lot size, living area, bedrooms, bathrooms, year built, structure style, stories, and property use
Ownership Information – Current and historical owners (with names, IDs for enrichment via Person ID Search, ownership type, and start dates)
Residents – Verified people currently or previously living at the property (with IDs for follow-up enrichment)
Valuations – Market value range, valuation confidence, and latest valuation date
Financial Insights – Loan-to-value ratio, total loans, ownership tenure, absentee ownership indicators
Nearby Schools – Local school names, ratings, and district details
Metadata – Position token and pagination details for multi-unit or multi-property addresses

Common Use Cases

Reverse Address Lookup – Identify who owns or resides at a given property
Property Verification – Confirm that an address corresponds to a real property and verify its ownership details
Lead Qualification and Enrichment – Add property and owner attributes to CRM or customer records
Risk and Fraud Investigation – Verify address legitimacy and detect potential absentee or high-risk ownerships
Real Estate and Market Research – Retrieve property characteristics, valuation trends, and local school data

Operations

Email Search

Endpoint name: https://api.spokeo.com/v5/emails

Use Spokeo’s Email Search tool to find verified people, contact information, social profiles, and background details associated with that email.

Search by email address to identify or verify a person and enrich contact records.

Overview

Use this endpoint when you have a valid email address (contains “@” and a suffix) and want to identify or verify the real person associated with it.

This endpoint returns verified person profiles, contact information, and social media accounts connected to that address.

Email Search is commonly used for contact enrichment, sales lead generation, candidate outreach, identity verification, fraud prevention, and digital identity resolution.

When to Use

Use Email Search when you:

Want to identify or verify ownership of that email
Need to enrich CRM or contact records with verified name, phone, address, or social data
Are performing fraud detection, risk assessment, or candidate verification workflows

Do not use this endpoint to search by phone number, name, username handle, or street address — use Phone Search, Name Search, Username Search, or Address Search instead.

Required Parameter

email (string) – The email address to search. (Required; no optional parameters)

Response Includes

A successful Email Search returns an array of verified people and associated metadata. Each result may include:

Name – Verified first and last name
Age – Current age or age at death
Contact Information – Phone numbers, secondary emails, and current address (with city, state, ZIP, latitude, and longitude)
Social Profiles – Linked social media accounts, profile photos, and URLs
Work History – Job titles, company names, start and end dates, and whether the person is currently employed
Education History – Schools attended, attendance dates, and degrees earned
Metadata – Match counts and verification confidence
Person ID – A unique identifier used for follow-up enrichment with Person ID Search

Common Use Cases

Reverse Email Lookup – Identify who owns or uses a given email address.
Contact Enrichment – Add verified attributes (name, phone, address) to existing records.
Fraud and Risk Prevention – Confirm that an email corresponds to a legitimate identity.
Recruiting and Candidate Outreach – Validate applicant or prospect contact information.
Marketing Personalization – Connect verified emails to social and demographic insights.

Operations

Username Search

Endpoint name: https://api.spokeo.com/v5/usernames

Use Spokeo’s Username Search tool to find verified people, contact information, and social profiles associated with a specific online handle or username.

Search by username or handle to identify the real person behind an online alias, verify authenticity, or enrich existing identity records.

Overview

Use this endpoint when you have a username or handle (for example, rainfire1967 or @rainfire1967) and want to identify or verify the real person associated with it.

This endpoint returns verified person profiles, contact information, and social accounts connected to that username.

Username Search is commonly used for investigations, fraud prevention, and digital identity enrichment.

When to Use

Use Username Search when you:

Want to identify or verify the person behind that handle or online account
Need to enrich records with verified name, phone, email, or address data connected to the username
Are performing fraud detection, social media investigations, or influencer verification

Do not use this endpoint to search by name, phone number, email address, or street address — use Name Search, Phone Search, Email Search, or Address Search instead.

Required Parameter

username (string) – The username or handle to search. (Required; no optional parameters)

Response Includes

A successful Username Search returns social profiles associated with that username or handle.

Common Use Cases

Reverse Username Lookup – Identify who owns or uses a given handle or alias
Social Media Verification – Confirm that a social media account corresponds to a real person
Fraud and Risk Investigation – Detect fake or duplicate accounts across platforms
Influencer and Brand Safety Checks – Verify authenticity of potential partners or creators

Operations