Back to Browse
Wiza Prospect List Builder (Search Filters, Capped at 30)
Wiza Prospect List Builder (Search Filters, Capped at 30) is a paid API for AI agents from wiza.withzero.xyz, paid per call via MPP, $0.08/call, status unknown (last checked 2026-09-14, last successful call 2026-07-06).
Creates an enriched Wiza prospect list from search filters (title, role, location, company, etc.), polls until complete, and settles payment based on actual API credits used — capped at 30 profiles per call.
Price / call$0.08
Success71%
StatusUnknown
How this service works
Create an enriched Wiza prospect list from search filters, including company-name aliases normalized to Wiza job_company. Capped at 30 profiles per call; payment escrow is sized from list.max_profiles and final settlement comes from Wiza list api_credits.total.
Output
Returns a completed Wiza prospect list object including: list ID and name, final status, count of enriched people, API credits consumed, USDC settlement amount charged per credit, creation and completion timestamps, enrichment level, and email option settings. The billing object details the metered payment settled based on actual Wiza API credits used.
Example use cases
Example prompt
“Build me a Wiza prospect list called 'Q3 SaaS Outreach' with up to 20 VP of Sales profiles at software companies with $10M-$100M revenue in the United States, full enrichment including emails and phone numbers.”
Technical details
Endpoint
POSThttps://wiza.withzero.xyz/api/v1/prospect-listsWhen to prefer
Use this endpoint when you need to bulk-discover and enrich up to 30 new prospects matching specific criteria (title, seniority, company size, industry, location, revenue, etc.) in a single bounded call. Prefer this over the individual reveal endpoint when building targeted lists rather than enriching known contacts. Prefer this over the continuation endpoint when starting a fresh search rather than paginating an existing one. The metered pricing based on actual Wiza API credits makes this cost-efficient for smaller batches.
Side effects
- Invalid or missing required fields (list name, max_profiles, filters) — HTTP 400 with validation error message
- max_profiles exceeds 30 — rejected at schema level
- No prospects match the given filters — list completes with 0 people and minimal credit usage
- Wiza upstream API failure — propagated error with non-200 status code
- Polling timeout before list reaches terminal status — may return intermediate status
- Insufficient Wiza account API credits — list creation may fail or return partial results
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| listrequired | object | |
| filtersrequired | object | Wiza prospect search filters. Additional Wiza-documented filter fields are accepted and forwarded. |
| max_wait_ms | integer | Maximum time to poll Wiza before returning a timeout if the upstream job is still queued/running. Defaults to 25000. |
| wait_for_result | boolean | Poll Wiza status endpoints before returning. Metered Wiza routes require this to stay true so billing can settle from final credit usage. |
| poll_interval_ms | integer | Delay between Wiza status polls. Defaults to 2000. |
Output
Schema · Response
| Field | Type | Description |
|---|---|---|
| data | object | |
| type | string | |
| status | object | |
| billing | object |
Reviews
5★
0
4★
0
3★
0
2★
0
1★
0
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"