# Potarix Enricher - Enrichment endpoints (modular reference)

> Section-level reference for the billable enrichment primitives. Parent: https://enricher.potarix.com/llms.txt . Full reference: https://enricher.potarix.com/llms-full.txt . Machine contract: https://enricher.potarix.com/openapi.yaml

Base URL: `https://api.potarix.com/enricher`
Auth: `Authorization: Bearer ptk_live_...` (mint via POST /auth/signup)

## Endpoints

- `POST /find-website` (2 credits): `{ "company_name", "context?" }` -> `{ website_url, source, confidence, cached, credits_remaining }`.
- `POST /find-email/person` (25 credits): `{ "full_name" or "first_name"+"last_name", "domain" or "company_name" }` -> `{ email, email_status, source, cached, credits_remaining }`.
- `POST /find-email/decision-maker` (25 credits): `{ "domain", "decision_maker_category" }` where category is ceo, sales, operations, buyer, finance, hr, or marketing -> `{ name, email, linkedin_url, job_title, email_status, ... }`.
- `POST /find-email/linkedin` (10 credits): `{ "linkedin_url" }` -> `{ email, name, job_title, email_status, ... }`.
- `POST /find-email/company` (25 credits, flat): `{ "domain" }` -> `{ emails[], count, source, ... }` (up to 500).
- `POST /find-all`: `{ "company_name", "dm_categories?", "skip_company_emails?" }` -> website + decision_makers[] + company_emails[]. Cost is the sum of the sub-calls that hit.

## Notes

- Email verification runs a four-provider waterfall: Findymail, AnyMailFinder, Hunter, BetterContact.
- Every response includes `cached` and `credits_remaining`. Whiffed and repeat lookups (same input, same account) are free.
- Optional `Idempotency-Key` header lets automated clients safely retry.

## Links

- [OpenAPI spec](https://enricher.potarix.com/openapi.yaml)
- [Agent guide (AGENTS.md)](https://enricher.potarix.com/AGENTS.md)
- [Hosted MCP server](https://api.potarix.com/mcp)
- [Auth reference](https://enricher.potarix.com/llms/auth.txt)