> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Find phone numbers with the API

> Retrieve phone numbers for a known person with the Phone Numbers Lookup API, using a LinkedIn identifier or Forager ID.

![Phone numbers lookup: a LinkedIn public identifier or person ID goes into Forager and phone numbers come back](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/mobile-phone-numbers-lookup-linkedin-identifier.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=c0efc1a13a95932cbbd4cf93106df91c)

Use this when you know a person and need their phone numbers.

## Before you start

* An API key and your Account ID.
* A LinkedIn public identifier or a Forager ID. To find a Forager ID, see [Search people by role](https://www.forager.ai/docs/guides/search-people-by-role.md).

## Look up phone numbers

Send a `POST` to [Phone numbers lookup](https://www.forager.ai/docs/openapi/phones/datastorage_person_contacts_lookup_phone_numbers_create.md).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 '{
           "person_id": 123
         }'
```

You can send `linkedin_public_identifier` instead of `person_id`.

Set `FORAGER_API_KEY` and `FORAGER_ACCOUNT_ID` in your shell first, as in the [quickstart](https://www.forager.ai/docs/api-overview/send-your-first-request.md). See [Authentication](https://www.forager.ai/docs/api-overview/authentication.md).

The [Recipes](https://www.forager.ai/docs/api-overview/recipes.md) page shows this request with a sample response, a list of objects with a `phone_number` field.

## Feedback

If you find out whether a number is connected or disconnected, you can report it with [Submit phone-number verification feedback](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_phone_numbers_create.md). Feedback requests are limited; see [Errors and rate limits](https://www.forager.ai/docs/errors-and-rate-limits.md).

## Costs

See [Credit pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.