{"uid":"cap_mfgwqmw7QQAJkwqOKhAee","slug":"wiza-withzero-xyz-wiza-bulk-contact-enrichment-list-f381f653","name":"Wiza Bulk Contact Enrichment List","description":"Create a Wiza enrichment list from explicit contacts, emails, or LinkedIn profile URLs. Supports up to 30 items per call; payment escrow is sized from the submitted item count and final settlement comes from Wiza list api_credits.total.","url":"https://wiza.withzero.xyz/api/v1/lists","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"list":{"name":"Enrichment sample","items":[{"company":"Analytical Engines","full_name":"Ada Lovelace"}],"email_options":{"accept_work":true},"enrichment_level":"partial"}},"required":["list"],"properties":{"list":{"type":"object","required":["name","enrichment_level","email_options","items"],"properties":{"name":{"type":"string","minLength":1,"description":"Name of the Wiza enrichment list."},"items":{"type":"array","items":{"anyOf":[{"type":"object","required":["full_name"],"properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Known email address for this contact."},"domain":{"type":"string","minLength":1,"description":"Company domain. Required with full_name when company is absent."},"company":{"type":"string","minLength":1,"description":"Company name. Required with full_name when domain is absent."},"full_name":{"type":"string","minLength":1,"description":"Full name of the contact, e.g. \"Stephen Hakami\"."},"profile_url":{"type":"string","minLength":1,"description":"LinkedIn profile URL, if already known."}},"additionalProperties":false},{"type":"object","required":["profile_url"],"properties":{"profile_url":{"type":"string","minLength":1,"description":"LinkedIn, Sales Navigator, or Recruiter profile URL."}},"additionalProperties":false},{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Known email address for this contact."}},"additionalProperties":false}],"example":{"company":"Analytical Engines","full_name":"Ada Lovelace"},"description":"One Wiza contact input."},"maxItems":30,"minItems":1,"description":"People to enrich. Wiza supports larger lists, but this public listing caps one call at 30 items to keep max payment bounded."},"callback_url":{"type":"string","format":"uri","description":"Optional Wiza webhook URL for asynchronous completion updates."},"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 to return.","additionalProperties":false},"enrichment_level":{"enum":["none","partial","full"],"type":"string","description":"none = profile data only; partial = emails; full = emails and phone numbers."}},"additionalProperties":false},"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":{"request":{"list":{"name":"QA Test Enrichment List","items":[{"email":"john.smith@acme.com","company":"Acme Corporation","full_name":"John Smith"},{"domain":"techventures.com","company":"TechVentures Inc","full_name":"Jane Doe"},{"email":"bob.lee@startup.io"}],"email_options":{"accept_work":true,"accept_generic":false,"accept_personal":false},"enrichment_level":"partial"},"max_wait_ms":25000,"wait_for_result":true},"response":{"data":{"id":5094057,"name":"QA Test Enrichment List","stats":{"risky":0,"valid":0,"emails":0,"people":2,"phones":0,"credits":{},"unfound":2,"duplicate":0,"progress_total":3,"progress_failed":1,"progress_pending":0,"progress_finished":2,"progress_enriching":0,"magic_field_answers":0},"status":"finished","created_at":"2026-06-12T03:05:46.490Z","finished_at":"2026-06-12T03:06:04.334Z","report_type":"people","email_options":{"accept_work":true,"accept_generic":false,"accept_personal":false},"enrichment_level":"partial"},"type":"list","status":{"code":200,"message":""},"billing":{"apiCredits":0,"settledUsdcMicro":"0","pricePerCreditUsdcMicro":"10000"}}},"exampleRequest":{"list":{"name":"QA Test Enrichment List","items":[{"email":"john.smith@acme.com","company":"Acme Corporation","full_name":"John Smith"},{"domain":"techventures.com","company":"TechVentures Inc","full_name":"Jane Doe"},{"email":"bob.lee@startup.io"}],"email_options":{"accept_work":true,"accept_generic":false,"accept_personal":false},"enrichment_level":"partial"},"max_wait_ms":25000,"wait_for_result":true},"tags":[],"displayCostAmount":"0.24","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_ofCTK0GrorF1eqR-u5lqu","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_TXJaYaVHzcrz5izeuAX29","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 a Wiza enrichment list from up to 300 contacts (by name+company, email, or LinkedIn URL) and returns enriched contact data including emails and phones.","exampleAgentPrompt":"Enrich these 3 contacts in Wiza using work-email-only enrichment: John Smith at Salesforce (john.smith@salesforce.com), Jane Doe with LinkedIn URL linkedin.com/in/janedoe, and Bob Lee at Stripe — name the list 'Q3 Outbound Prospects'.","exampleUseCases":null,"resultDescription":"Returns a completed Wiza list object including list ID, status, enrichment level, email options, per-contact enriched data (emails, phones), stats (people count, API credits consumed), timestamps, and a billing breakdown showing credits used, price per credit, and total USDC micro-units settled.","failureModes":["Items array empty or exceeds 300 — validation error returned","Missing required enrichment_level or email_options fields — 400 bad request","Invalid LinkedIn URL format — item rejected or returns no data","Wiza account has insufficient API credits — enrichment fails or returns partial results","List creation times out before reaching terminal status — polling error","Invalid email format in items array — schema validation failure","Wiza upstream service unavailable — 5xx error propagated"],"whenToPreferThis":"Use this endpoint when you have a known list of up to 300 people you want to enrich with verified contact data (emails, phones) and you already have some identifying information — name+company, email, or LinkedIn URL. Prefer this over the individual reveal endpoint when enriching multiple contacts at once to minimize API calls and cost overhead. Choose this over the prospect search list endpoint when you have explicit contact identities rather than filter-based discovery criteria.","instructions":"# Create enrichment list — paid create node; polls Wiza internally, then read results from free routes.\n\n## Workflow\nSubmits up to 30 explicit contacts and polls until done, settling metered billing from list credits used. If it returns before completion (max_wait_ms timeout, ≤60000), the list keeps enriching upstream — resume by the returned data.id via the FREE routes below; do NOT re-POST this paid route (re-charges + duplicate list):\n- check state: POST /api/v1/lists/get {id} → data.finished_at (non-null = complete), data.stats.people. Free.\n- fetch results: POST /api/v1/lists/contacts {id, segment} — segment is people | valid | risky. Free.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:31.237Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:54.576Z","isFirstParty":true}