{"uid":"cap_ylNjrG2VXj2WolFibvO4_","slug":"wiza-withzero-xyz-wiza-individual-contact-reveal-0ce20397","name":"Wiza Individual Contact Reveal","description":"Start a Wiza individual reveal for one contact and poll until completion. Accepts name + company/domain, email, or LinkedIn profile URL. Advertised unit price starts at $0.01/profile; final metered settlement follows Wiza api_credits.total and can be up to $0.08/profile when Wiza returns contact-field credits.","url":"https://wiza.withzero.xyz/api/v1/individual-reveals","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"enrichment_level":"partial","individual_reveal":{"company":"Analytical Engines","full_name":"Ada Lovelace"}},"required":["individual_reveal","enrichment_level"],"properties":{"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."},"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_personal":{"type":"boolean","description":"Return personal email addresses such as tcook1960@gmail.com."}},"description":"Types of emails Wiza may return for an individual reveal.","additionalProperties":false},"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."},"enrichment_level":{"enum":["none","partial","phone","full"],"type":"string","description":"none = LinkedIn/profile data only; partial = email; phone = phone; full = email and phone."},"poll_interval_ms":{"type":"integer","maximum":10000,"minimum":500,"description":"Delay between Wiza status polls. Defaults to 2000."},"individual_reveal":{"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":"Contact to enrich. Provide full_name plus company or domain, an email, or a LinkedIn profile URL."}},"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"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"emails":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"email_type":{"type":"string"},"email_status":{"anyOf":[{"enum":["valid","risky","invalid","unfound"],"type":"string"},{"type":"string"}]}},"additionalProperties":{}}},"phones":{"type":"array","items":{"type":"object","properties":{"type":{"anyOf":[{"enum":["mobile","other"],"type":"string"},{"type":"string"}]},"number":{"type":"string"},"pretty_number":{"type":"string"}},"additionalProperties":{}}},"status":{"type":"string"},"company":{"type":"string"},"credits":{"anyOf":[{"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":{}},{"type":"null"}]},"location":{"type":"string"},"email_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"fail_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_complete":{"type":"boolean"},"company_size":{"type":"number"},"company_type":{"type":"string"},"email_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"company_domain":{"type":"string"},"company_region":{"type":"string"},"company_street":{"type":"string"},"company_country":{"type":"string"},"company_founded":{"type":"number"},"company_funding":{"type":"number"},"company_revenue":{"type":"number"},"company_industry":{"type":"string"},"company_linkedin":{"type":"string"},"company_locality":{"type":"string"},"company_location":{"type":"string"},"enrichment_level":{"type":"string"},"company_size_range":{"type":"string"},"company_description":{"type":"string"},"company_postal_code":{"type":"string"},"company_subindustry":{"type":"string"},"linkedin_profile_url":{"type":"string"}},"additionalProperties":{}},"type":{"type":"string","const":"individual_reveal"},"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":{"max_wait_ms":30000,"email_options":{"accept_work":true,"accept_personal":false},"wait_for_result":true,"enrichment_level":"full","poll_interval_ms":2000,"individual_reveal":{"company":"Stripe","full_name":"Sarah Chen"}},"response":{"data":{"id":587971576,"name":"Sarah M. Chen","email":"sarahchen@stripe.com","title":"Software Engineer","emails":[{"type":"work","email":"sarahchen@stripe.com","status":"valid"}],"phones":[],"status":"finished","company":"Stripe","credits":{"api_credits":{"total":2,"email_credits":2,"phone_credits":0,"scrape_credits":0}},"location":"Seattle, Washington, United States","email_type":"work","is_complete":true,"callback_url":null,"company_size":15871,"company_type":"private","email_status":"valid","mobile_phone":null,"phone_number":null,"phone_status":"unfound","company_domain":"stripe.com","company_region":"California","company_street":"354 oyster point boulevard","company_ticker":null,"company_country":"United states","company_founded":2010,"company_funding":"10134407503","company_revenue":null,"company_twitter":"https://twitter.com/stripe","company_facebook":"https://www.facebook.com/stripehq","company_industry":"Technology, Information and Internet","company_linkedin":"https://www.linkedin.com/company/stripe","company_locality":"South san francisco","company_location":"South san francisco, california, united states","enrichment_level":"full","company_size_range":"5001-10000","company_description":"Stripe is a financial services platform that helps all types of businesses accept payments, build flexible billing models, and manage money movement.","company_linkedin_id":"2135371","company_postal_code":"94080","company_subindustry":null,"linkedin_profile_url":"https://www.linkedin.com/in/sarahmchen","company_revenue_range":"$1B-$10B","company_last_funding_at":"2026-03-09","company_last_funding_round":"secondary_market","company_last_funding_amount":null},"type":"individual_reveal","status":{"code":200,"message":""},"billing":{"apiCredits":2,"settledUsdcMicro":"20000","pricePerCreditUsdcMicro":"10000"}}},"exampleRequest":{"max_wait_ms":30000,"email_options":{"accept_work":true,"accept_personal":false},"wait_for_result":true,"enrichment_level":"full","poll_interval_ms":2000,"individual_reveal":{"company":"Stripe","full_name":"Sarah Chen"}},"tags":[],"displayCostAmount":"0.16","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.01/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O-7LDeBEmk1i3-T61mFY8","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_l2NWUrGirnEvp9jdLIwjl","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.08","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":"Starts a Wiza individual reveal for a single contact (by name+company, email, or LinkedIn URL) and polls until completion, returning enriched contact data including emails and/or phones.","exampleAgentPrompt":"Can you find the work email and phone number for Sarah Chen, VP of Engineering at Stripe? Use full enrichment level and wait up to 30 seconds for the result.","exampleUseCases":null,"resultDescription":"Returns an enriched contact object with verified email addresses (with status: valid/risky/invalid/unfound), phone numbers (mobile or other), job title, company details (size, industry, domain, funding), location, and credit usage metadata. Includes is_complete flag and any fail_error message.","failureModes":["Timeout if Wiza job is still queued after max_wait_ms (default 25000ms) — returns partial or incomplete result","Contact not found — is_complete true but email/phone fields null or unfound status","Invalid input — missing required full_name or no company/domain/email/LinkedIn provided","Credit exhaustion — Wiza api_credits depleted, billing fails","LinkedIn URL format rejected — must be a valid linkedin.com profile URL","Wiza upstream error — fail_error field populated with error message"],"whenToPreferThis":"Use this endpoint when you need to enrich a single known contact (not a batch) and require the result synchronously before proceeding. Prefer over list-based enrichment when you have one lead and need immediate results. Choose this over the status-polling route when you want a single call that handles polling internally. Best when you have at least a name + company/domain, an email, or a LinkedIn profile URL.","instructions":"# Reveal one contact — paid create node; polls Wiza internally and returns final contact data.\n\n## Workflow\nThis route starts the reveal AND polls until done, settling metered billing from credits used. If it returns before completion (max_wait_ms timeout, ≤60000), the job keeps running upstream — resume by the returned data.id via the FREE read route; do NOT re-POST this paid route (that re-charges and starts a duplicate reveal):\n- check state: POST /api/v1/individual-reveals/get {id} → data.is_complete (true = done), data.fail_error (non-null = failed). Free.\n- The get route also returns the final email/phone data once data.is_complete is true.","reviewSummary":"Wiza individual reveal consistently completes successfully, delivering work email and company/profile enrichment in under 10 seconds with accurate results across LinkedIn URL, name+domain, and email inputs. Metered billing settles against actual Wiza credits used, often well below the $0.08 escrow cap. One edge case returned profile_not_found for a personal Gmail address, suggesting coverage is stronger for professional/work identifiers.","reviewSummaryHighlights":["Fast enrichment — work email and profile fields returned in under 10 seconds","Accurate metered billing settling against real Wiza credits, often below the $0.08 cap","High accuracy across multiple input types: LinkedIn URL, name + domain"],"reviewSummaryConcerns":["Personal email addresses (e.g. Gmail) may return profile_not_found with no enrichment"],"reviewSummaryGeneratedAt":"2026-07-14T16:15:17.670Z","activationCount":3,"lastUsedAt":"2026-07-29T00:21:29.749Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:49.621Z","isFirstParty":true}