{"uid":"cap_A7G23H6Bh1ffBp8PlrbKO","slug":"wiza-withzero-xyz-wiza-list-contacts-retrieval-e9966582","name":"Wiza List Contacts Retrieval","description":"Get contacts for a completed Wiza list. Supports people, valid, and risky segments. Proof-only route: no payment.","url":"https://wiza.withzero.xyz/api/v1/lists/contacts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"description":"Wiza list ID.","exclusiveMinimum":0},"segment":{"enum":["people","valid","risky"],"type":"string","description":"Contact segment to return. Defaults to people."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"status":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"additionalProperties":{}}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.83","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"wiza.withzero.xyz","brandSlug":"wiza-withzero-xyz-mpp","brandBaseUrl":"https://wiza.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Retrieves all contacts from a completed Wiza enrichment or prospect list, with optional segmentation by validation status (people, valid, or risky).","exampleAgentPrompt":"My Wiza list with ID 48291 is done processing — can you pull all the valid contacts from it?","exampleUseCases":null,"resultDescription":"Returns an array of contact objects from the completed Wiza list, each containing enriched profile data (emails, phone numbers, job titles, company info, etc.), along with a status object including a code and message indicating success or failure.","failureModes":["List ID not found or does not belong to the authenticated account — returns error status","List is not yet completed — may return empty or partial results","Invalid segment value provided — returns validation error","List ID is zero or negative — rejected by schema validation","Network timeout or server error — returns 5xx status"],"whenToPreferThis":"Use this endpoint after a Wiza enrichment or prospect list has finished processing (verified via the list status endpoint) to retrieve the full set of enriched contacts. Choose the segment parameter to filter by validation quality: 'valid' for high-confidence contacts, 'risky' for borderline ones, or 'people' for the full set. This is a read-only, no-cost route ideal for downloading results without incurring additional charges.","instructions":"# Read enriched contacts for a completed list — free results node.\n\n## Workflow\nTerminal read step for lists built via POST /api/v1/lists, POST /api/v1/prospect-lists, or /prospect-lists/continue (all share these /lists/* read routes). Confirm completion first:\n- check state: POST /api/v1/lists/get {id} → data.finished_at non-null before reading here.\n- segment selects people (all), valid, or risky emails.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":13,"lastUsedAt":"2026-07-29T00:21:31.335Z","lastSuccessfullyRanAt":"2026-07-06T23:05:32.045Z","lastHealthCheckAt":"2026-10-11T00:41:56.443Z","isFirstParty":true,"canonicalSlug":"wiza-withzero-xyz-wiza-list-contacts-retrieval-e9966582"}