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

Endpoints

EndpointTypeDescription
ProspectorAsyncFind contacts at a target company by title and location filters. Returns emails, phones (optional), and employment history.
Search ContactSyncSearch contacts by company identity, title, department, seniority, or hire date. Returns profile data — contact channels not included.
Search CompanySyncSearch companies by industry, headquarters country, and headcount range.
Contact EnrichmentAsyncEnrich a contact by LinkedIn, email, or name + domain. Returns verified email, phone (optional), title, and employment history.
Phone EnrichmentAsyncFind mobile and direct-dial numbers for a contact.
Company EnrichmentAsyncEnrich a company by domain, LinkedIn, or name. Returns full company profile.
Job Change DetectionSyncCheck if a contact is still at a given company. Returns status and a profile snapshot.
Email VerificationSyncVerify an email address and return deliverability status.
Account ReportingSyncRetrieve usage counters at the account and key level.
API Key ManagementSyncCreate and manage sub-keys under a master key.