# Waterfall

> Waterfall is a unified B2B contact and company data API — one integration
> consolidating 30+ data vendors, for finding, enriching, and verifying
> contacts and companies.

Waterfall gives go-to-market, sales, and RevOps teams a single API for
prospecting, contact and company enrichment, phone number lookup,
job-change monitoring, and email verification. Clients use Waterfall to
build pipeline, keep CRM contact data current, and trigger downstream
workflows via signed webhooks — all under one contract and integration
with usage-based pricing and no minimum commitments. Data is cleaned,
structured, and verified in real time, coverage spans contacts and
companies globally, and support comes directly from Waterfall's founders
and engineers over Slack instead of a ticket queue.

## Documentation

- [API Introduction](https://docs.waterfall.io/v1/introduction.md): Complete API reference for Waterfall — find and enrich contacts, prospect by title and company, verify emails, and more.
- [Authentication](https://docs.waterfall.io/v1/authentication.md): How to authenticate requests to the Waterfall API.
- [Rate Limits](https://docs.waterfall.io/v1/rate-limit.md): Rate limit behavior and response headers.
- [Errors](https://docs.waterfall.io/v1/errors.md): Common HTTP status codes and troubleshooting guidance.
- [Usage Tracking](https://docs.waterfall.io/v1/inline-usage.md): How every API response reports real-time cost and balance via `output.usage`.
- [Webhook Verification](https://docs.waterfall.io/v1/webhook-verification.md): How to verify Waterfall webhook deliveries using Ed25519 JWT signatures.
- [Webhook JWKS](https://docs.waterfall.io/v1/webhook-jwks.md): Waterfall's public Ed25519 signing keys, for verifying webhook signatures.
- [Account Reporting](https://docs.waterfall.io/v1/account-reporter-v2.md): Key- and account-level usage metrics for the current or any past billing month.
- [API Key Management](https://docs.waterfall.io/v1/api-keys-overview.md): Create, list, and modify API sub-keys programmatically with a master key.
- [Complete Documentation Index](https://docs.waterfall.io/llms.txt): Every Waterfall docs page, endpoint by endpoint, for exhaustive lookups beyond this curated list.

## API Endpoints

- [Prospector](https://docs.waterfall.io/v1/prospector-launcher.md): Find contacts by company website, job title, and location.
- [Search Contact](https://docs.waterfall.io/v1/search-contact-launcher.md): Search for contacts by LinkedIn, company identity, or persona filters.
- [Search Company](https://docs.waterfall.io/v1/search-company-launcher.md): Search for companies by industry, location, and size.
- [Contact Enrichment](https://docs.waterfall.io/v1/contact-enrichment-launcher.md): Match an email, LinkedIn profile, or name plus domain to a verified business contact.
- [Phone Enrichment](https://docs.waterfall.io/v1/phone-enrichment-launcher.md): Get direct and mobile phone numbers by LinkedIn, email, or name plus domain.
- [Company Enrichment](https://docs.waterfall.io/v1/company-enrichment-launcher.md): Enrich a company by domain, LinkedIn, or name.
- [Company Reveal](https://docs.waterfall.io/v1/company-reveal-launcher.md): Identify the company behind a website visitor's IPv4 address.
- [Company Titles](https://docs.waterfall.io/v1/company-titles-launcher.md): Get all active job titles at a company.
- [Job Change Detection](https://docs.waterfall.io/v1/job-change-launcher.md): Detect when a contact has moved to a new company or role.
- [Email Verifier](https://docs.waterfall.io/v1/email-verifier.md): Verify an email address and get deliverability status in a single synchronous call.

## Specification & Code

- [OpenAPI Specification](https://waterfall-io-public.s3.amazonaws.com/api_specs.yaml): The complete, machine-readable Waterfall API contract (OpenAPI 3), published from this repository.
- [LinkedIn Industries List](https://waterfall-io-public.s3.us-east-1.amazonaws.com/industries.txt): The full list of supported LinkedIn industry values for `industries` filters.
- [Agent Skills](https://github.com/Waterfall-io/api-skills): Drop-in coding-agent skills (`waterfall-direct-api`, `waterfall-integration`) for calling the Waterfall API directly or generating a client-owned integration.
- [Webhook Verification Kit](https://github.com/Waterfall-io/webhook-verification-kit): A quick-start demo and reusable Python module for verifying Waterfall's Ed25519-signed webhook deliveries locally.

## Support

- [Book API & Sales Support](https://docs.waterfall.io/v1/book-demo.md): Book a call with the Waterfall team.