# Phone numbers lookup

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.

Endpoint: POST /api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/
Version: 1.0.0
Security: Api-Key

## Security:

  - `Api-Key` (unknown)
    apiKey in header X-API-KEY

## Path parameters:

  - `account_id` (integer, required)

## Request fields (application/json):

  - `person_id` (integer)

  - `linkedin_public_identifier` (string)
    LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

  - `quality_tier` (any)
    Which verified phone numbers to return. `highest_quality` (default) returns only numbers that passed our strictest verification. `most_coverage` returns every verified number we hold, including the `highest_quality` ones; it widens coverage without lowering the quality bar, and is charged at its own per-lookup rate. You are charged only when a number is returned.
* `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.

## Response 200 fields (application/json):

  - `phone_number` (string, required)

