# Wiza Individual Contact Reveal

> Wiza Individual Contact Reveal is a paid API for AI agents from wiza.withzero.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/individual-reveals
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 3
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-individual-contact-reveal-0ce20397
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ylNjrG2VXj2WolFibvO4_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wiza-withzero-xyz-wiza-individual-contact-reveal-0ce20397 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "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"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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": {

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wiza-withzero-xyz-wiza-individual-contact-reveal-0ce20397/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wiza.withzero.xyz](https://www.zero.xyz/host/wiza.withzero.xyz/llms.txt)
