# Waterfall.io API Documentation

> API reference for Waterfall.io — find, enrich, and verify contacts and companies.

## Docs

- [Account Reporter v2](https://docs.waterfall.io/v1/account-reporter-v2.md): Get key-level and account-level usage metrics for the current or any past month.
- [API Keys - Create](https://docs.waterfall.io/v1/api-keys-create.md): Create a new sub-key for your account.
- [API Keys - List](https://docs.waterfall.io/v1/api-keys-list.md): Get a list of all API keys under your account.
- [API Keys - Modify](https://docs.waterfall.io/v1/api-keys-modify.md): Update notes, active status, or rate limit for an existing sub-key.
- [API Keys Management](https://docs.waterfall.io/v1/api-keys-overview.md): Manage your Waterfall API keys programmatically using a master key.
- [Authentication](https://docs.waterfall.io/v1/authentication.md): How to authenticate requests to Waterfall API.
- [Get API & Sales Support](https://docs.waterfall.io/v1/book-demo.md): Book a call with the Waterfall team.
- [Company Enrichment Finder](https://docs.waterfall.io/v1/company-enrichment-finder.md): Retrieve company enrichment job state and output by job_id.
- [Company Enrichment Launcher](https://docs.waterfall.io/v1/company-enrichment-launcher.md): Enrich a company by domain, LinkedIn, or name. Returns a job_id to retrieve results.
- [Company Reveal Finder](https://docs.waterfall.io/v1/company-reveal-finder.md): Retrieve a persisted company reveal job by job_id.
- [Company Reveal Launcher](https://docs.waterfall.io/v1/company-reveal-launcher.md): Reveal company information from an IPv4 address.
- [Contact Enrichment Finder](https://docs.waterfall.io/v1/contact-enrichment-finder.md): Retrieve contact enrichment job status and output by job_id.
- [Contact Enrichment Launcher](https://docs.waterfall.io/v1/contact-enrichment-launcher.md): Enrich a contact by email, LinkedIn, or name + domain. Returns a job_id to retrieve results.
- [Email Verifier](https://docs.waterfall.io/v1/email-verifier.md): Verify an email address and get deliverability status in a single synchronous call.
- [Errors](https://docs.waterfall.io/v1/errors.md): Common HTTP status codes and troubleshooting guidance.
- [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.
- [Job Change Finder](https://docs.waterfall.io/v1/job-change-finder.md): Re-fetch a previous Job Change result by job_id.
- [Job Change Launcher](https://docs.waterfall.io/v1/job-change-launcher.md): Detect whether a contact has changed jobs using company and contact identifiers.
- [Open API Specification](https://docs.waterfall.io/v1/openapi-spec.md): Download the Waterfall API OpenAPI specification.
- [Phone Enrichment Finder](https://docs.waterfall.io/v1/phone-enrichment-finder.md): Retrieve phone enrichment job state and output by job_id.
- [Phone Enrichment Launcher](https://docs.waterfall.io/v1/phone-enrichment-launcher.md): Get mobile and direct line phone numbers by LinkedIn, email, or name plus domain.
- [Prospector Finder](https://docs.waterfall.io/v1/prospector-finder.md): Retrieve Prospector job status, company data, and contacts by job_id.
- [Prospector Launcher](https://docs.waterfall.io/v1/prospector-launcher.md): Launch a contact search using domain, LinkedIn URL/ID, or company name.
- [Prospector location filter](https://docs.waterfall.io/v1/prospector-location-filter.md): How location_country, location_countries, and location_name work.
- [Prospector multiple title filters](https://docs.waterfall.io/v1/prospector-multiple-title-filters.md): Use ordered `title_filters` arrays for fallback targeting.
- [Prospector title filter](https://docs.waterfall.io/v1/prospector-title-filter.md): How to build boolean expressions for `title_filter`.
- [Rate limit](https://docs.waterfall.io/v1/rate-limit.md): Rate limit behavior and response headers.
- [Search Company Finder](https://docs.waterfall.io/v1/search-company-finder.md): Re-fetch a previous Search Company job by job_id.
- [Search Company Launcher](https://docs.waterfall.io/v1/search-company-launcher.md): Search for companies by industry, location, and size.
- [Search Contact filters](https://docs.waterfall.io/v1/search-contact-filters.md): How title filters, departments, seniorities, and location work.
- [Search Contact Finder](https://docs.waterfall.io/v1/search-contact-finder.md): Re-fetch a previous Search Contact job by job_id.
- [Search Contact Launcher](https://docs.waterfall.io/v1/search-contact-launcher.md): Search for contacts by LinkedIn, company identity, or persona filters.

## OpenAPI Specs

- [api_specs](https://docs.waterfall.io/api_specs.yaml)
- [openapi](https://docs.waterfall.io/api-reference/openapi.json)