# Gapup KYC Screener Batch

> Gapup KYC Screener Batch is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $1.5/call, status unknown (last checked 2026-09-14).

Screens up to 100 persons or legal entities in a single call against KYC/AML watchlists, sanctions, and compliance databases, returning risk/screening results for each.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/kyc_screener_batch
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-kyc-screener-batch-8a10cb3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nrGQUPngw92LbwQavGRQJ

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 gapup-kyc-screener-batch-8a10cb3e -d '<json body>'
```

Example prompt: Screen these five people for KYC compliance — John Smith (person, born 1975-04-12), Acme Holdings Ltd (company), Maria García (person), Viktor Petrov (person, born 1968-09-30), and Sunrise Capital Group (company) — and let me know if any come up on sanctions or watchlists.

## When to prefer this

Use this endpoint when you need to screen multiple people or companies (up to 100) for KYC/AML compliance in a single API call, especially during batch onboarding workflows. Prefer this over single-entity checks when processing lists of new customers, partners, or counterparties. The async mode is useful when screening large batches to avoid client timeouts.

## Known failure modes

- Empty names array or more than 100 entries returns a validation error
- Malformed birthdate format (not YYYY-MM-DD) may cause parsing failure
- Invalid or missing API key returns 401 Unauthorized
- Async mode returns a job_id that must be polled; result may not be immediately available
- Network timeout or gateway error returns 5xx if upstream screening provider is unavailable
- Ambiguous names without type hint may produce lower-confidence or multiple match results

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A structured JSON result per entity indicating whether the name matched any watchlist, sanctions list, or AML database entry, along with source and match details for each screened entity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "names": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Full name of person or legal entity"
     },
     "type": {
      "enum": [
       "person",
       "company",
       "any"
      ],
      "type": "string",
      "description": "Entity type hint. Defaults to 'any'."
     },
     "birthdate": {
      "type": "string",
      "description": "Optional birthdate (YYYY-MM-DD) for disambiguation"
     }
    }
   },
   "maxItems": 100,
   "minItems": 1,
   "description": "List of entities to screen (1-100). Each entry requires at minimum a name."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "kyc_screener_batch",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-kyc-screener-batch-8a10cb3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)