curl --request POST \
--url https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"person_id": 123
}
'
[
{
"phone_number": "<string>"
}
]{
"detail": "Authentication credentials were not provided."
}Phone number lookup API
Retrieve phone numbers for a person identified by LinkedIn handle or Forager ID.
POST
https://api-v2.forager.ai
/
api
/
{account_id}
/
datastorage
/
person_contacts_lookup
/
phone_numbers
/
curl --request POST \
--url https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"person_id": 123
}
'
[
{
"phone_number": "<string>"
}
]{
"detail": "Authentication credentials were not provided."
}When to use this endpoint
You have a known person (LinkedIn public identifier orperson_id) and need their phone numbers, for example before a call. Each lookup costs 15 credits, so search and qualify first, then look up only the people you keep.
Example request
cURL
curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_contacts_lookup/phone_numbers/" \
-H "X-API-KEY: $FORAGER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"linkedin_public_identifier": "jane-doe-example"
}'
FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.
Example response
200 (illustrative values)
[
{
"phone_number": "+12025550142"
},
{
"phone_number": "+12025550187"
}
]
Credits
Each lookup costs 15 credits. See API credits and pricing for how credits are charged and how to check what you spent.Authorizations
Path Parameters
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Response
Last modified on November 1, 2026