Wave: List Vendors
wave_list_vendorsRead-onlyIdempotent
List vendors from Wave accounting. Filter by exact email, local name substring, or modified date range. Supports pagination and fetching all pages.
Instructions
List vendors -- the suppliers a business buys from. Vendors are read-only in Wave's API: they can be listed and read but not created, changed, or deleted. Wave filters by exact email only; name_contains is applied locally, so pair it with fetch_all=true on a long vendor list.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number for offset pagination. | |
| No | Exact email match, applied by Wave. | ||
| fetch_all | No | Walk every page instead of returning just one. Slower, but complete. | |
| page_size | No | Records per page (1-200). | |
| business_id | No | Business to operate on. Defaults to the session business set by wave_set_default_business. | |
| name_contains | No | Case-insensitive substring match on name, applied locally. | |
| modified_after | No | ISO 8601 timestamp; only vendors changed after it. | |
| modified_before | No | ISO 8601 timestamp; only vendors changed before it. | |
| response_format | No | Output format: "markdown" for a compact human-readable summary, "json" for the complete record. | markdown |