# x402 KYB Entity Diligence Pack

> x402 KYB Entity Diligence Pack is a paid API for AI agents from x402-kyb-api.vercel.app, paid per call via x402, $1/call, status unknown (last checked 2026-10-16).

Runs a combined OFAC SDN fuzzy screen and GLEIF LEI match/resolve on a legal entity name, returning directional compliance signals in a single JSON response, paid per-call via x402/USDC.

## Facts

- Endpoint: POST https://x402-kyb-api.vercel.app/kyb/pack?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-kyb-entity-diligence-pack-47c48ad8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3t51gGjZgyKhN78oFKrL1

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 x402-kyb-entity-diligence-pack-47c48ad8 -d '<json body>'
```

Example prompt: Can you run a KYB diligence pack on 'Acme Trading GmbH' — screen them against OFAC SDN and check their GLEIF LEI record? Their LEI is 2594007XIACKNMUAW223 and I want up to 20 hits with a match threshold of 0.6.

## When to prefer this

Use this endpoint when you need a fast, cheap, pay-per-call directional KYB signal combining OFAC SDN screening and GLEIF LEI resolution in a single round-trip — especially in agentic workflows where formal clearance is handled downstream and you want a first-pass filter before committing to deeper due diligence. Prefer it over full KYC/AML platforms when cost-per-call and ease of integration matter more than formal regulatory attestation.

## Known failure modes

- Missing required 'name' field returns a validation error
- LEI not found in GLEIF registry returns found:false with empty resolve block
- OFAC list temporarily unavailable may cause degraded or error response
- Threshold set outside 0-1 range likely returns a validation error
- Payment not processed via x402 returns 402 Payment Required before any results
- Very high match thresholds (near 1.0) may produce zero hits even for real entities

## How this service works

Pay-per-call KYB pack: OFAC SDN screen + GLEIF LEI match/resolve (USDC on Base + Solana via x402). Directional only — not clearance.

## Output

Returns a JSON object with an OFAC block (hits array, hit count, potential_matches_only flag), a GLEIF block (matched LEIs and resolved LEI details), list freshness timestamps for both OFAC and GLEIF, a banner warning that results are directional only and not formal clearance or attestation, and flags for not_clearance and not_attestation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string",
   "description": "Optional 20-char LEI — also resolve when present"
  },
  "name": {
   "type": "string",
   "description": "Legal or trade name to screen/match"
  },
  "limit": {
   "type": "integer",
   "description": "Max hits per block (default 10, max 50)"
  },
  "threshold": {
   "type": "number",
   "description": "OFAC match threshold 0-1 (default 0.55)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ofac": {
   "hits": [],
   "hit_count": 0,
   "potential_matches_only": true
  },
  "pack": "kyb-entity-diligence-v0",
  "gleif": {
   "match": {
    "matches": [
     {
      "lei": "HWUPKR0MPOU8FGXBT394"
     }
    ],
    "hit_count": 1
   },
   "resolve": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "found": true
   }
  },
  "banner": "DIRECTIONAL ONLY — not clearance/attestation; not OFAC/GLEIF/LOU; false positives/negatives possible; potential_matches_only.",
  "list_as_of": {
   "ofac": "2026-10-07T13:06:20.742814+00:00",
   "gleif": "2026-09-06T00:00:00Z"
  },
  "not_clearance": true,
  "not_attestation": true,
  "potential_matches_only": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-kyb-entity-diligence-pack-47c48ad8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-kyb-api.vercel.app](https://www.zero.xyz/host/x402-kyb-api.vercel.app/llms.txt)