{"uid":"cap_4oL-21yu8JIfnjQHscWGq","slug":"wiza-withzero-xyz-wiza-get-list-status-and-metadata-ad05edd7","name":"Wiza Get List Status and Metadata","description":"Get Wiza list status, stats, completion timestamp, enrichment level, and credit metadata by list ID. Proof-only route: no payment.","url":"https://wiza.withzero.xyz/api/v1/lists/get?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}},"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":{}}},"additionalProperties":{}},"example":{"request":{"id":12345},"response":{"status":404,"message":"List not found."}},"exampleRequest":{"id":12345},"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"0.56","reviews":1,"stars":"4.7","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 status, stats, completion timestamp, enrichment level, and credit metadata for a Wiza enrichment or prospect list by its numeric ID.","exampleAgentPrompt":"Can you check the status and stats for my Wiza list with ID 48291 — I want to know if it's finished, how many people are in it, and how many credits it consumed?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the list's numeric ID, name, processing status (e.g. completed/pending), people count, credit breakdown (email, phone, scrape, company, API credits), created_at and finished_at timestamps, report type, enrichment level, and email options (work, generic, personal) configured for the list.","failureModes":["Invalid or non-existent list ID returns an error status code and message","List ID of 0 or negative number rejected by schema validation","List still processing returns status indicating incomplete state with null finished_at","Authorization failure if the list belongs to a different account","Network timeout if the Wiza API is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to poll or check the current state of a Wiza bulk enrichment or prospect list — for example, to determine whether processing is complete before fetching contacts, or to audit credit consumption and enrichment configuration for a specific list.","instructions":"# Read list status + stats by id — free state-read node.\n\n## Workflow\nPoll/resume step for lists from POST /api/v1/lists, POST /api/v1/prospect-lists, and /prospect-lists/continue (a prospect list is read through these generic /lists/* routes — there is no /prospect-lists/get). Read data.finished_at (non-null = complete) and data.stats.people to decide when to fetch.\n- fetch results: POST /api/v1/lists/contacts {id, segment} once complete. Free.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":10,"lastUsedAt":"2026-07-29T00:21:31.183Z","lastSuccessfullyRanAt":"2026-07-06T23:05:29.098Z","lastHealthCheckAt":"2026-10-12T18:31:42.379Z","isFirstParty":true,"canonicalSlug":"wiza-withzero-xyz-wiza-get-list-status-and-metadata-ad05edd7"}