> ## 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.

# People

> Look up and search people: role search, and person detail lookup by ID, email or phone number.

Look up people and their records. Use the search endpoints to find people by role, employer, location, or skills, and the detail-lookup endpoints to fetch a full person record by ID, email, or phone number. Contact data has its own sections: Phones, Personal Emails, and Work Emails.

* [POST /api/\{account\_id}/datastorage/person\_detail\_lookup/](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_lookup_create.md): Person detail lookup
* [POST /api/\{account\_id}/datastorage/person\_detail\_reverse\_lookup/by\_email/](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_reverse_lookup_by_email_create.md): Person detail lookup by email
* [POST /api/\{account\_id}/datastorage/person\_detail\_reverse\_lookup/by\_phone\_number/](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_reverse_lookup_by_phone_number_create.md): Person detail lookup by phone
* [POST /api/\{account\_id}/datastorage/person\_role\_search/](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_create.md): Person role search
* [POST /api/\{account\_id}/datastorage/person\_role\_search/totals/](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_totals_create.md): Person role search totals

## Build a request

Choose the lookup or search, set the parameters, and copy the request in cURL, Python or JavaScript. Nothing is sent from this page.

**POST**

Cost: . Nothing is sent from this page.

<pre />

## Explore a person record

The detail lookups return one person record; a role search returns `search_results` whose `person` carries the same identity fields. Click a field to see its type. The values are illustrative.

. Click a field. Values are illustrative.

Types and nullability follow the OpenAPI spec; nested objects show their own fields when you click inside them.

## Credits

Each operation page shows its credit cost. See [API credits and pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md) for the full table.


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