Skip to main content
GET

Authentication

In Water One, open the organization switcher in the upper-left corner and select Manage to open your organization profile. Use an API key scoped to that organization. Send the key in the Authorization: Bearer <token> header. Set WATER_ONE_API_KEY in your environment before running the cURL example. The API returns qualified leads for the organization that owns the key.

Query parameters

All parameters are optional. For date filters, use a timestamp such as 2026-11-01T00:00:00Z.
string
Agency state or province code, such as CA.
string
Exact, case-sensitive match for a qualified lead status label configured in your organization.
integer
Minimum score, from 4 to 10. Defaults to 6.
string
Include leads created at or after this UTC ISO 8601 timestamp.
string
Include leads created at or before this UTC ISO 8601 timestamp.
string
Include leads with any recorded status change at or after this UTC ISO 8601 timestamp.
string
Include leads with any recorded status change at or before this UTC ISO 8601 timestamp. When you pass both bounds, a single change must fall within the window.
integer
Maximum results, from 1 to 50. Defaults to 20.
integer
Number of matching results to skip. Defaults to 0.

Pagination

Start with offset=0. Keep the filters and limit the same, and increase offset by limit after each request. Stop when data contains fewer items than limit. For example, with limit=20, request offsets 0, 20, and 40 in order. For a longer export, set createdAtBefore once at the start and reuse it on every page to exclude leads created after that cutoff. Updates to existing leads can still change which records appear on each page.

Response

The 200 OK example shows a fictional record.
object[]
Matching qualified leads, ordered by descending score, then newest creation time, then descending ID.

Errors