Changelog

The API is versioned in the URL (/external/v1). Within v1 we only make additive changes — new endpoints, new optional fields, new error codes — so build clients that ignore fields and codes they don't know. A breaking change would ship as /external/v2, announced here well in advance.

2026-10-06 — v1

The first version of the Funnelfeedr API.

• Account-level API keys, created, rolled and revoked in Settings → API keys, each with a 30-day request log. Every key can call every endpoint, the ones that spend credits included.
• Matching: POST /organizations/match (matched, not_found, invalid per item) and POST /people/match (also ambiguous).
• Organization basics free on every match; the details (size, revenue, website, descriptions, technologies, keywords, tags, address) revealed with reveal: ["details"] on organizations/match, 0.2 credits per organization by default, valid for a year.
• Contacts: POST /organizations/contacts/match, the contacts at up to 25 organizations that match the account's target contact roles (every contact when it has none), each organization paged with its own cursor.
• Switchboards: POST /organizations/switchboards/match, an organization's main phone line, with an optional reveal of its number and email.
• Reveal of email and phone: POST /contacts/reveal and reveal inside people/match and organizations/switchboards/match, with dryRun quotes, a required maxCredits cap and all-or-nothing charging (the organization details reveal works the same way). A contact's LinkedIn URL is never masked and never charged.
• GET /credits for the balance, and Funnelfeedr-Credits-Remaining on it and on every response that can spend.
• Batches of 1–25 items, RFC 9457 errors, Idempotency-Key, per-key rate limits with RateLimit headers.
• Docs for agents: llms.txt, llms-full.txt, a markdown version of every page and an OpenAPI spec.