# WithZero Wiza Prospect List Builder

> WithZero Wiza Prospect List Builder is a paid API for AI agents from agents.withzero.xyz, paid per call via x402 or MPP, $0.5/call (dynamic — varies by input), status down (last checked 2026-10-15).

Creates a prospect list of leads (companies and/or people) using Wiza's data platform, proxied through ZeroClick with pay-per-use billing.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/wiza/prospect-lists?utm_source=zero.xyz
- Price: $0.5/call (dynamic — varies by input)
- Payment: x402, MPP
- Status: down
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-wiza-prospect-list-builder-e043d3b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ufF5J0wMQaYeZ4SSPeA72

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 withzero-wiza-prospect-list-builder-e043d3b8 -d '<json body>'
```

Example prompt: Build me a prospect list of VP of Sales contacts at SaaS companies with 50-500 employees in the United States — I need this for a cold outreach campaign.

## When to prefer this

Choose this endpoint when you need to programmatically generate B2B prospect lists without setting up a Wiza account or API key directly. It is best suited for agents doing autonomous outbound sales research, recruiting, or account-based marketing that require fresh, structured lead data with contact information on demand.

## Known failure modes

- Search filters too narrow returning zero results
- Invalid or unsupported filter parameters returning a 400 error
- Wiza upstream service unavailable causing a 502 or timeout
- Insufficient account credit or payment failure blocking the request
- Rate limit exceeded on the underlying Wiza API

## 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 structured prospect list containing lead records with fields such as full name, job title, company name, company size, industry, location, and where available, verified email addresses and LinkedIn profile URLs.

## 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/withzero-wiza-prospect-list-builder-e043d3b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)