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

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/prospect-lists
- Price: $0.08/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-06
- Success rate: 71% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 8
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-prospect-list-builder-search-filters-capped-at-646ee9e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sq-YtJYCg7FfpppvQ6mRf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wiza-withzero-xyz-wiza-prospect-list-builder-search-filters-capped-at-646ee9e9 -d '<json body>'
```

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.

## When to prefer this

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.

## Known failure modes

- 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

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

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "list": {
   "name": "US founders sample",
   "max_profiles": 3
  },
  "filters": {
   "job_title": [
    {
     "v": "founder"
    }
   ]
  }
 },
 "required": [
  "list",
  "filters"
 ],
 "properties": {
  "list": {
   "type": "object",
   "required": [
    "name",
    "max_profiles"
   ],
   "properties": {
    "name": {
     "type": "string",
     "minLength": 1,
     "description": "Name of the prospect list."
    },
    "callback_url": {
     "type": "string",
     "format": "uri",
     "description": "Optional Wiza webhook URL for asynchronous completion updates."
    },
    "max_profiles": {
     "type": "integer",
     "maximum": 30,
     "minimum": 1,
     "description": "Number of prospects to enrich. Capped at 30 for bounded metered pricing."
    },
    "email_options": {
     "type": "object",
     "properties": {
      "accept_work": {
       "type": "boolean",
       "description": "Return professional email addresses such as tim.cook@apple.com."
      },
      "accept_generic": {
       "type": "boolean",
       "description": "Return generic role addresses such as hello@apple.com."
      },
      "accept_personal": {
       "type": "boolean",
       "description": "Return personal email addresses such as tcook1960@gmail.com."
      }
     },
     "description": "Types of emails Wiza may return for list-style enrichment.",
     "additionalProperties": false
    },
    "skip_duplicates": {
     "type": "boolean",
     "description": "Skip contacts previously found in other API lists."
    },
    "enrichment_level": {
     "enum": [
      "none",
      "partial",
      "full"
     ],
     "type": "string",
     "description": "none = profile data only; partial = emails; full = emails and phone numbers. Defaults to partial."
    }
   },
   "additionalProperties": false
  },
  "filters": {
   "type": "object",
   "properties": {
    "major": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Majors to match."
    },
    "skill": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Skills to match."
    },
    "school": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Exact school names."
    },
    "company": {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "object",
        "required": [
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "id": {
     "type": "number"
    },
    "name": {
     "type": "string"
    },
    "stats": {
     "type": "object",
     "properties": {
      "people": {
       "type": "number"
      },
      "credits": {
       "type": "object",
       "properties": {
        "api_credits": {
         "anyOf": [
          {
           "type": "object",
           "properties": {
            "total": {
             "type": "number"
            },
            "email_credits": {
             "type": "number"
            },
            "phone_credits": {
             "type": "number"
            },
            "scrape_credits": {
             "type": "number"
            },
            "company_credits": {
             "type": "number"
            }
           },
           "additionalProperties": {}
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": {}
      }
     },
     "additionalProperties": {}
    },
    "status": {
     "type": "string"
    },
    "created_at": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "finished_at": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "report_type": {
     "type": "string"
    },
    "email_options": {
     "type": "object",
     "properties": {
      "accept_work": {
       "type": "boolean",
       "description": "Return professional email addresses such as tim.cook@apple.com."
      },
      "accept_generic": {
       "type": "boolean",
       "description": "Return generic role addresses such as hello@apple.com."
      },
      "accept_personal": {
       "type": "boolean",
       "description": "Return personal email addresses such as tcook1960@gmail.com."
      }
     },
     "description": "Types of emails Wiza may return for list-style enrichment.",
     "additionalProperties": false
    },
    "enrichment_level": {
     "type": "string"
    }
   },
   "additionalProperties": {}
  },
  "type": {
   "type": "string",
   "const": "list"
  },
  "status": {
   "type": "object",
   "properties": {
    "code": {
     "type": "number"
    },
    "message": {
     "type": "string"
    }
   },
   "additionalProperties": {}
  },
  "billing": {
   "type": "object",
   "require
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wiza-withzero-xyz-wiza-prospect-list-builder-search-filters-capped-at-646ee9e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wiza.withzero.xyz](https://www.zero.xyz/host/wiza.withzero.xyz/llms.txt)