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

# List qualified leads

> Retrieve qualified leads for your Water One organization.

## 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`.

**state** `string`

Agency state or province code, such as `CA`.

**status** `string`

Exact, case-sensitive match for a qualified lead status label configured in your organization.

**minScore** `integer`

Minimum score, from 4 to 10. Defaults to 6.

**createdAtAfter** `string`

Include leads created at or after this UTC ISO 8601 timestamp.

**createdAtBefore** `string`

Include leads created at or before this UTC ISO 8601 timestamp.

**statusChangedAfter** `string`

Include leads with any recorded status change at or after this UTC ISO 8601 timestamp.

**statusChangedBefore** `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.

**limit** `integer`

Maximum results, from 1 to 50. Defaults to 20.

**offset** `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.

**data** `object[]`

Matching qualified leads, ordered by descending score, then newest creation time, then descending ID.

**Lead fields**

**id** `string`

Qualified lead ID.

**summary** `string`

Lead summary.

**score** `integer`

Qualification score.

**feedbackScore** `integer | null`

Feedback score, if recorded.

**report** `string`

Full qualification report in Markdown.

**createdAt** `string`

Creation timestamp.

**status** `string`

Current organization status label.

**statusChangedAt** `string | null`

Timestamp of the latest recorded status change, or null when there is no change on record. This can be later than a change matched by the date filters.

**assignee** `object | null`

Current assignee with `name` and `email`, or null if no assignee could be resolved.

**url** `string`

Link to the qualified lead in Water One.

**meeting** `object`

Source meeting with `meetingDate` and an `agency` object. The agency includes `name`, `stateProvince`, `country`, `city`, and `countyAreaName`. `city` and `countyAreaName` may be null.

## Errors

| Status | Meaning |
| - | - |
| `400` | A query parameter failed validation. The response includes validation details. |
| `401` | Authentication is missing or invalid. |
| `404` | The credential has no organization scope. |
| `429` | The organization exceeded the API rate limit. |
| `500` | The server could not complete the request. |

```bash cURL theme={null}
curl 'https://sales.waterone.ai/api/v1/qualified-leads?limit=3&minScore=7' \
  -H "Authorization: Bearer ${WATER_ONE_API_KEY}"
```

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "summary": "Example opportunity related to a public project.",
      "score": 8,
      "feedbackScore": null,
      "report": "## Summary\nFictional example of a public project identified in a public meeting.",
      "createdAt": "2026-09-20T12:00:00.000Z",
      "status": "Action Needed",
      "statusChangedAt": "2026-09-21T09:00:00.000Z",
      "assignee": {
        "name": "Example Assignee",
        "email": "assignee@example.com"
      },
      "url": "https://sales.waterone.ai/qualified-leads/00000000-0000-4000-8000-000000000001",
      "meeting": {
        "meetingDate": "2026-09-15T00:00:00.000Z",
        "agency": {
          "name": "Example Water Agency",
          "stateProvince": "CA",
          "country": "US",
          "city": null,
          "countyAreaName": null
        }
      }
    }
  ]
}
```

```json 200 No matching leads theme={null}
{
  "data": []
}
```

```json 401 Unauthorized theme={null}
{
  "message": "Unauthorized"
}
```


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