# Wiza Get List Status and Metadata

> Wiza Get List Status and Metadata is a free API for AI agents from wiza.withzero.xyz, Free, status unknown (last checked 2026-10-12, last successful call 2026-07-06).

Retrieves status, stats, completion timestamp, enrichment level, and credit metadata for a Wiza enrichment or prospect list by its numeric ID.

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/lists/get?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-07-06
- Success rate: 56% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 10
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-get-list-status-and-metadata-ad05edd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4oL-21yu8JIfnjQHscWGq

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-get-list-status-and-metadata-ad05edd7 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get Wiza list status, stats, completion timestamp, enrichment level, and credit metadata by list ID. Proof-only route: no payment.

## Output

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.

## Example request

```json
{
 "id": 12345
}
```

## 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
  }
 },
 "additionalProperties": false
}
```

## 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": {}
  }
 },
 "additionalProperties": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wiza-withzero-xyz-wiza-get-list-status-and-metadata-ad05edd7/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)