{"uid":"cap_sq-YtJYCg7FfpppvQ6mRf","slug":"wiza-withzero-xyz-wiza-prospect-list-builder-search-filters-capped-at-646ee9e9","name":"Wiza Prospect List Builder (Search Filters, Capped at 30)","description":"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.","url":"https://wiza.withzero.xyz/api/v1/prospect-lists","method":"POST","headers":{},"bodySchema":{"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":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"revenue":{"type":"array","items":{"enum":["$0-$1M","$1M-$10M","$10M-$25M","$25M-$50M","$50M-$100M","$100M-$250M","$250M-$500M","$500M-$1B","$1B-$10B","$10B+"],"type":"string"}},"job_role":{"type":"array","items":{"enum":["customer_service","design","education","engineering","finance","health","human_resources","legal","marketing","media","operations","public_relations","real_estate","sales","trades"],"type":"string"},"description":"Functional roles."},"location":{"type":"array","items":{"type":"object","required":["v","b"],"properties":{"b":{"enum":["city","state","country"],"type":"string","description":"Location type."},"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Location name. City format: \"city, state, country\"; state format: \"state, country\"; country format: \"country\"."}},"additionalProperties":false},"description":"Prospect locations to include or exclude."},"job_title":{"type":"array","items":{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},"description":"Job titles to include or exclude. Wrap a title in quotes for exact title matching."},"last_name":{"type":"array","items":{"type":"string"},"description":"Exact last-name matches."},"first_name":{"type":"array","items":{"type":"string"},"description":"Exact first-name matches."},"funding_max":{"type":"string"},"funding_min":{"type":"string"},"job_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Current company names to include or exclude. Strings are accepted and normalized to include filters."},"company_name":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"company_size":{"type":"array","items":{"enum":["1-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10001+"],"type":"string"}},"company_type":{"type":"array","items":{"enum":["private","public","educational","government","nonprofit","public_subsidiary"],"type":"string"}},"funding_date":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string","description":"Match the last funding event or any funding event."},"v":{"type":"string","minLength":1,"description":"Wiza funding value such as 60d, 90d, 1y, seed, series_a, or venture depending on the field."}},"additionalProperties":false},"funding_type":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string"},"v":{"type":"array","items":{"enum":["angel","venture","grant","debt_financing","private_equity","crowdfunding","other"],"type":"string"}}},"additionalProperties":false},"job_sub_role":{"type":"array","items":{"type":"string"},"description":"Wiza job sub-role values such as software, recruiting, customer_success, product, or data."},"past_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Past company names to include or exclude. Strings are accepted and normalized to include filters."},"business_name":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"funding_stage":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string"},"v":{"type":"array","items":{"enum":["pre_seed","seed","series_a","series_b","series_c","series_d","series_e-j","other"],"type":"string"}}},"additionalProperties":false},"linkedin_slug":{"type":"array","items":{"type":"string"},"description":"LinkedIn profile slugs or full LinkedIn profile URLs."},"company_summary":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Words to include or exclude in the company summary. Strings are accepted and normalized to include filters."},"current_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"department_size":{"type":"array","items":{"type":"string"},"description":"Department headcount filters such as \"sales:10-50\", \"engineering:10-\", or \"marketing:-50\"."},"job_title_level":{"type":"array","items":{"enum":["CXO","Director","Entry","Manager","Owner","Partner","Senior","Training","Unpaid","VP"],"type":"string"},"description":"Seniority levels."},"company_industry":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Company industries to include or exclude, using Wiza industry values. Strings are accepted and normalized to include filters."},"company_location":{"type":"array","items":{"type":"object","required":["v","b"],"properties":{"b":{"enum":["city","state","country"],"type":"string","description":"Location type."},"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Location name. City format: \"city, state, country\"; state format: \"state, country\"; country format: \"country\"."}},"additionalProperties":false},"description":"Company locations to include or exclude."},"last_funding_max":{"type":"string"},"last_funding_min":{"type":"string"},"year_founded_end":{"type":"string"},"year_founded_start":{"type":"string"},"company_annual_growth":{"enum":["0-5%","5-10%","10-20%","20-50%","50-100%","100%+"],"type":"string"}},"description":"Wiza prospect search filters. Additional Wiza-documented filter fields are accepted and forwarded.","additionalProperties":{}},"max_wait_ms":{"type":"integer","maximum":60000,"minimum":1,"description":"Maximum time to poll Wiza before returning a timeout if the upstream job is still queued/running. Defaults to 25000."},"wait_for_result":{"type":"boolean","const":true,"description":"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":{"type":"integer","maximum":10000,"minimum":500,"description":"Delay between Wiza status polls. Defaults to 2000."}},"additionalProperties":false},"responseSchema":{"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","required":["apiCredits","pricePerCreditUsdcMicro","settledUsdcMicro"],"properties":{"apiCredits":{"type":"number","description":"Wiza API credits found in the upstream response and used for metered settlement."},"settledUsdcMicro":{"type":"string","description":"Actual metered MPP settlement amount in USDC micro-units."},"pricePerCreditUsdcMicro":{"type":"string","description":"Configured USDC micro-units charged per Wiza API credit."}},"additionalProperties":false}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"2.4","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.71","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"session","summary":"$0.08/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.08","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"2.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FJkdzpssVunL_BkiNIHeY","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.08","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_rweRW12hY8XRV8yE-Ywic","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"2.4","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"wiza.withzero.xyz","brandSlug":"wiza-withzero-xyz-mpp","brandBaseUrl":"https://wiza.withzero.xyz","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":"# Build prospect list from search filters — paid create node; polls Wiza internally.\n\n## Workflow\nScope first to size the spend, then build, then read from free /lists/* routes (there is no /prospect-lists/get):\n- count first (free): POST /api/v1/prospects/search {filters, size:0} → data.total before committing.\n- this route enriches up to max_profiles (≤30) and polls until done. On max_wait_ms timeout (≤60000) the list keeps running — resume by the returned data.id via the free routes; do NOT re-POST (re-charges + duplicate list).\n- check state: POST /api/v1/lists/get {id} → data.finished_at non-null, data.stats.people. Free.\n- fetch results: POST /api/v1/lists/contacts {id, segment}. Free.\n- get more matches: POST /api/v1/prospect-lists/continue {id, max_profiles}. Paid.\n\n## Contract\n- Domain-only company targeting is rejected — target current employers with company_name / job_company.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":8,"lastUsedAt":"2026-07-29T00:21:31.415Z","lastSuccessfullyRanAt":"2026-07-06T23:04:19.203Z","lastHealthCheckAt":"2026-09-14T06:33:46.704Z","isFirstParty":true}