Skip to main content
POST
Person detail lookup by phone

When to use this endpoint

You have only a phone number, for example from an inbound call, and want the person behind it. The response is the same person record as the person lookup.

Example request

cURL
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

200 (illustrative values)

Credits

Each lookup costs 15 credits. See API credits and pricing for how credits are charged and how to check what you spent.

Authorizations

X-API-KEY
string
header
required

Path Parameters

account_id
integer
required

Body

Person reverse search by phone number request serializer.

phone_number
string
required

Response

Person details serializer.

id
integer
required
read-only
full_name
string
required
Maximum string length: 255
first_name
string
required
Maximum string length: 255
skills
object[]
required
read-only
location
object
required

Serializer for the InnerLocation model.

linkedin_info
object
required

Serializer for the PersonLinkedinInfo model.

roles
object[]
required
educations
object[]
required
certifications
object[]
required
read-only
courses
object[]
required
read-only
honors
object[]
required
read-only
languages
object[]
required
read-only
organizations
object[]
required
read-only
patents
object[]
required
read-only
publications
object[]
required
read-only
test_scores
object[]
required
read-only
projects
object[]
required
read-only
volunteering
object[]
required
read-only
last_name
string | null
Maximum string length: 255
photo
string<uri> | null
Maximum string length: 255
gender
string | null
Maximum string length: 255
headline
string | null
Maximum string length: 255
description
string | null
Last modified on November 1, 2026