Skip to content

Phones

Retrieve phone numbers for a known person. Provide identifying information (such as a LinkedIn handle or Forager ID) and get back the available phone numbers.

Phone numbers lookup

Request

The Person Phone Numbers Lookup endpoint retrieves phone numbers associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available phone numbers. This API is useful for enriching person records, supporting lead generation, and verifying phone contact details within your applications. The optional quality_tier property chooses how much of the verified dataset is searched; see its description for the values and what each costs. Omitting it is equivalent to highest_quality, so existing integrations are unaffected.

Security
Api-Key
Path
account_idintegerrequired
Body
person_idinteger
linkedin_public_identifierstring

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

quality_tier(QualityTierEnum (string or null)) or (NullEnum (any or null))
One of:
  • highest_quality - Default. Returns only numbers that passed our strictest verification: the highest-confidence set, so fewer numbers come back.
  • most_coverage - Returns every verified number we hold, including the highest_quality ones: maximises how many people you can reach without lowering the verification bar. Charged at its own per-lookup rate.
string or null(QualityTierEnum)
Enum:"highest_quality""most_coverage"
curl -i -X POST \
  'https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "person_id": 0,
    "linkedin_public_identifier": "string",
    "quality_tier": "highest_quality"
  }'

Responses

Bodyapplication/json
Array [
phone_numberstringread-onlyrequired
]
Response
[ { "phone_number": "string" } ]