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

# Forager API reference

> Forager public API reference: server URL, API key security scheme and the OpenAPI description download.

![Your code calls the Forager REST API and gets JSON back](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/forager-rest-api-json-response.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=61f70d5f14d06bc84bfa0edae492055e)

Forager public API endpoints documentation

Version: 1.0.0

## Servers

```
https://api-v2.forager.ai
```

## Security

### Api-Key

Type: apiKey\

In: header\

Name: X-API-KEY

## Download OpenAPI description

* [Forager public API](https://www.forager.ai/docs/openapi.yaml)

## Job Posts

* [POST /api/\{account\_id}/datastorage/job\_search/](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_create.md): Job post event search
* [POST /api/\{account\_id}/datastorage/job\_search/totals/](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_totals_create.md): Job post event search totals

## Organizations

* [POST /api/\{account\_id}/datastorage/organization\_search/](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_create.md): Organization search
* [POST /api/\{account\_id}/datastorage/organization\_search/totals/](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_totals_create.md): Organization search totals

## People

* [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

## Phones

* [POST /api/\{account\_id}/datastorage/person\_contacts\_lookup/phone\_numbers/](https://www.forager.ai/docs/openapi/phones/datastorage_person_contacts_lookup_phone_numbers_create.md): Phone numbers lookup

## Personal Emails

* [POST /api/\{account\_id}/datastorage/person\_contacts\_lookup/personal\_emails/](https://www.forager.ai/docs/openapi/personal-emails/datastorage_person_contacts_lookup_personal_emails_create.md): Personal emails lookup

## Work Emails

* [POST /api/v2/\{account\_id}/datastorage/person\_contacts\_lookup/work\_emails/](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_create.md): Single work email lookup
* [GET /api/v2/\{account\_id}/datastorage/person\_contacts\_lookup/work\_emails/\{job\_id}/](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_retrieve.md): Single work email lookup result
* [POST /api/v2/\{account\_id}/datastorage/person\_contacts\_lookup/work\_emails/bulk/](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_bulk_create.md): Bulk work email lookup
* [GET /api/v2/\{account\_id}/datastorage/person\_contacts\_lookup/work\_emails/bulk/\{batch\_id}/](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_bulk_retrieve.md): Bulk work email lookup status and results

## Websites

* [POST /api/\{account\_id}/datastorage/website\_detail\_lookup/](https://www.forager.ai/docs/openapi/websites/datastorage_website_detail_lookup_create.md): Website Details Lookup

## Users

* [GET /api/\{account\_id}/subscriptions/balance\_change\_logs/](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_list.md): Credit Balance Change Log
* [GET /api/\{account\_id}/subscriptions/balance\_change\_logs/totals/](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_totals_retrieve.md): Credit Consumption Totals
* [GET /api/api\_keys/](https://www.forager.ai/docs/openapi/users/api_keys_list.md): List API keys
* [POST /api/api\_keys/](https://www.forager.ai/docs/openapi/users/api_keys_create.md): Create a new API key
* [GET /api/api\_keys/\{prefix}/](https://www.forager.ai/docs/openapi/users/api_keys_retrieve.md): View API key details
* [DELETE /api/api\_keys/\{prefix}/](https://www.forager.ai/docs/openapi/users/api_keys_destroy.md): Delete API key
* [GET /api/users/current/](https://www.forager.ai/docs/openapi/users/users_current_retrieve.md): View user information

## Autocomplete

* [GET /api/\{account\_id}/datastorage/autocomplete/industries/](https://www.forager.ai/docs/openapi/autocomplete/v1_industry_lookup.md): Industries lookup
* [GET /api/\{account\_id}/datastorage/autocomplete/organizations/](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_lookup.md): Organizations lookup
* [GET /api/\{account\_id}/datastorage/autocomplete/organization\_keywords/](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_keyword_lookup.md): Organization keywords lookup
* [GET /api/\{account\_id}/datastorage/autocomplete/locations/](https://www.forager.ai/docs/openapi/autocomplete/v1_location_lookup.md): Locations lookup
* [GET /api/\{account\_id}/datastorage/autocomplete/person\_skills/](https://www.forager.ai/docs/openapi/autocomplete/v1_person_skill_lookup.md): Person skills lookup
* [GET /api/\{account\_id}/datastorage/autocomplete/web\_technologies/](https://www.forager.ai/docs/openapi/autocomplete/v1_web_technology_lookup.md): Web technologies lookup

## Feedback

* [POST /api/\{account\_id}/datastorage/feedback/personal\_emails/](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_personal_emails_create.md): Submit personal-email verification feedback
* [POST /api/\{account\_id}/datastorage/feedback/phone\_numbers/](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_phone_numbers_create.md): Submit phone-number verification feedback
* [POST /api/\{account\_id}/datastorage/feedback/work\_emails/](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_work_emails_create.md): Submit work-email verification feedback


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