> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waterfall.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Complete API reference for Waterfall — find and enrich contacts, prospect by title and company, verify emails, and more.

The Waterfall API is available at `https://api.waterfall.io`. All requests require an API key in the `x-api-key` header.

<Note>
  **Building with a coding agent** — Claude Code, Codex, Cursor, Devin, or similar — **or are one yourself?** Start at [Agent Skills](/v1/skills-overview) and point it at the [Waterfall API Skills repo](https://github.com/Waterfall-io/api-skills), whether you want to call the API directly or generate integration code you own.
</Note>

## Endpoints

| Endpoint | Type | Description |
| - | - | - |
| [Prospector](/v1/prospector-launcher) | Async | Find contacts at a target company by title and location filters. Returns emails, phones (optional), and employment history. |
| [Search Contact](/v1/search-contact-launcher) | Sync | Search contacts by company identity, title, department, seniority, or hire date. Returns profile data — contact channels not included. |
| [Search Company](/v1/search-company-launcher) | Sync | Search companies by industry, headquarters country, and headcount range. |
| [Contact Enrichment](/v1/contact-enrichment-launcher) | Async | Enrich a contact by LinkedIn, email, or name + domain. Returns verified email, phone (optional), title, and employment history. |
| [Phone Enrichment](/v1/phone-enrichment-launcher) | Async | Find mobile and direct-dial numbers for a contact. |
| [Company Enrichment](/v1/company-enrichment-launcher) | Async | Enrich a company by domain, LinkedIn, or name. Returns full company profile. |
| [Company Reveal](/v1/company-reveal-launcher) | Sync | Reveal company information from an IPv4 address. Beta. |
| [Company Titles](/v1/company-titles-launcher) | Sync | Get all active job titles at a company by domain or LinkedIn. Ideal for flexible title targeting and use alongside Search Contact title lists. Beta. |
| [Job Change Detection](/v1/job-change-launcher) | Sync | Check if a contact is still at a given company. Returns status and a profile snapshot. |
| [Email Verification](/v1/email-verifier) | Sync | Verify an email address and return deliverability status. |
| [Webhook JWKS](/v1/webhook-jwks) | Sync | Fetch Ed25519 public keys for verifying signed webhook deliveries. |
| [Account Reporting](/v1/account-reporter-v2) | Sync | Retrieve usage counters at the account and key level. |
| [API Key Management](/v1/api-keys-overview) | Sync | Create and manage sub-keys under a master key. |


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