# Wiza Bulk Contact Enrichment List

> Wiza Bulk Contact Enrichment List is a paid API for AI agents from wiza.withzero.xyz, paid per call via MPP, $0.08/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/lists
- Price: $0.08/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 3
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-bulk-contact-enrichment-list-f381f653
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mfgwqmw7QQAJkwqOKhAee

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-bulk-contact-enrichment-list-f381f653 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

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

## Request schema (JSON Schema)

```json
{
 "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]
… (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"
    },
    "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",
   "require
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wiza-withzero-xyz-wiza-bulk-contact-enrichment-list-f381f653/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)