> ## 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. # API credits and pricing > How Forager credits are charged, credits used per API request, which endpoints are free, and where to buy credits. ![API credits: each Forager endpoint draws credits from your account balance](https://mintcdn.com/forager/EGsWCxLOYv1Cb__c/images/illustrations/api-credits-per-request-pricing.svg?fit=max\&auto=format\&n=EGsWCxLOYv1Cb__c\&q=85\&s=136c1cd6d9e6fe4310cff01f32ecc677)## OverviewThis page lists the credit cost of each API endpoint. Paid lookups and searches draw credits from your account balance based on the type of data retrieved. To buy credits, see [Buy credits](#buy-credits).## How credits are charged- Each lookup or search uses the number of credits listed below. - A work email lookup, single or in a batch, costs 5 credits, charged only when an address is found. Polling a lookup or a batch never consumes credits. - A personal email lookup costs 5 credits only when at least one address is returned. A `200` with an empty body is not charged. - A bulk work email batch is rejected, and nothing is charged, if your balance cannot cover the whole batch. - To see what was spent, use [Credit Balance Change Log](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_list.md) and [Credit Consumption Totals](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_totals_retrieve.md).## Credit cost per API requestThe table below lists the credits each paid endpoint uses:| API Request Name | Credits | | - | - | | [Person details lookup](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_lookup_create.md) | 1 | | [Person work email lookup](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_create.md) | 5 | | [Bulk work email lookup](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_bulk_create.md) | 5 per lookup in the batch that finds an address | | [Person personal email lookup](https://www.forager.ai/docs/openapi/personal-emails/datastorage_person_contacts_lookup_personal_emails_create.md) | 5 | | [Person phone number lookup](https://www.forager.ai/docs/openapi/phones/datastorage_person_contacts_lookup_phone_numbers_create.md) | 15 | | [Person reverse email search](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_reverse_lookup_by_email_create.md) | 5 | | [Person reverse phone number search](https://www.forager.ai/docs/openapi/people/datastorage_person_detail_reverse_lookup_by_phone_number_create.md) | 15 | | [Person role search totals](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_totals_create.md) | 1 | | [Person role search API call](https://www.forager.ai/docs/openapi/people/datastorage_person_role_search_create.md) | 1 | | [Job search API call](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_create.md) | 2 | | [Organization search API call](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_create.md) | 1 | | [Organization technologies lookup](https://www.forager.ai/docs/openapi/websites/datastorage_website_detail_lookup_create.md) | 1 |Work email lookups (single and bulk) are charged once per lookup that finds an address, however many addresses it returns, and personal email lookups only when an address is returned.### Estimate a jobEnter how many of each operation a job needs. The calculator uses the figures in the table above and counts email lookups only at the share you expect to find an address. \ \
OperationEachHow manyCredits
Share of email lookups that find an address: % Applies to the work and personal email rows. Set it to the rate you see in your own data; 100% is the upper bound. Autocomplete, feedback and work email polling are free and are not counted. \**credits** > [!NOTE] > > The calculator covers the endpoints priced above. It leaves out the endpoints whose cost is still being confirmed, and it does not convert credits to money: plan prices are on the [Forager pricing page](https://www.forager.ai/pricing).## Free endpointsThese endpoints don't use credits: filter autocomplete, data feedback and work email result polling.| API Request Name | Credits | | - | - | | [Industries lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_industry_lookup.md) | Free | | [Locations lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_location_lookup.md) | Free | | [Organization keywords lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_keyword_lookup.md) | Free | | [Organizations lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_organization_lookup.md) | Free | | [Person skills lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_person_skill_lookup.md) | Free | | [Web technologies lookup](https://www.forager.ai/docs/openapi/autocomplete/v1_web_technology_lookup.md) | Free | | [Personal email feedback](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_personal_emails_create.md) | Free | | [Phone number feedback](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_phone_numbers_create.md) | Free | | [Work email feedback](https://www.forager.ai/docs/openapi/feedback/datastorage_feedback_work_emails_create.md) | Free | | [Single work email lookup result](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_retrieve.md) | Free | | [Bulk work email lookup status and results](https://www.forager.ai/docs/openapi/work-emails/v2_datastorage_person_contacts_lookup_work_emails_bulk_retrieve.md) | Free |## Costs being confirmed| API Request Name | Credits | | - | - | | [Job search totals](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_totals_create.md) | Not yet documented | | [Organization search totals](https://www.forager.ai/docs/openapi/organizations/datastorage_organization_search_totals_create.md) | Not yet documented | | [List API keys](https://www.forager.ai/docs/openapi/users/api_keys_list.md) | Not yet documented | | [Create a new API key](https://www.forager.ai/docs/openapi/users/api_keys_create.md) | Not yet documented | | [View API key details](https://www.forager.ai/docs/openapi/users/api_keys_retrieve.md) | Not yet documented | | [Delete API key](https://www.forager.ai/docs/openapi/users/api_keys_destroy.md) | Not yet documented | | [View user information](https://www.forager.ai/docs/openapi/users/users_current_retrieve.md) | Not yet documented | | [Credit Balance Change Log](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_list.md) | Not yet documented | | [Credit Consumption Totals](https://www.forager.ai/docs/openapi/users/subscriptions_balance_change_logs_totals_retrieve.md) | Not yet documented |## Buy creditsCompare monthly plans and what each includes on the [Forager pricing page](https://www.forager.ai/pricing). To purchase credits, visit:\ [Manage Subscription & Buy Credits](https://app.forager.ai/subscription)Looking to buy credits in bulk or have other pricing questions? [Book a call with our team here](https://calendly.com/d/46p-2vr-83n). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.