# Wiza List Contacts Retrieval

> Wiza List Contacts Retrieval is a free API for AI agents from wiza.withzero.xyz, Free, status unknown (last checked 2026-10-11, last successful call 2026-07-06).

Retrieves all contacts from a completed Wiza enrichment or prospect list, with optional segmentation by validation status (people, valid, or risky).

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/lists/contacts?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-07-06
- Success rate: 83% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 13
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-list-contacts-retrieval-e9966582
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A7G23H6Bh1ffBp8PlrbKO

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-list-contacts-retrieval-e9966582 -d '<json body>'
```

Example prompt: My Wiza list with ID 48291 is done processing — can you pull all the valid contacts from it?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get contacts for a completed Wiza list. Supports people, valid, and risky segments. Proof-only route: no payment.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

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