# 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-18).

Screens a legal entity name and optional LEI against OFAC SDN with fuzzy matching and resolves GLEIF LEI data in a single combined JSON response.

## Facts

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

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-411bc6cb -d '<json body>'
```

Example prompt: Can you run a KYB diligence pack on 'Acme Trading GmbH' — screen them against OFAC SDN with a match threshold of 0.6 and also resolve their LEI '7LTWFZYICNSX8D621K86'?

## When to prefer this

Choose this endpoint when you need a combined OFAC SDN fuzzy screen plus GLEIF LEI lookup in a single API call, especially for lightweight KYB pre-screening in an agentic workflow. Prefer this over separate OFAC or GLEIF APIs when you want a fast, unified diligence signal at low cost ($1 USDC per call). Not suitable as a replacement for formal compliance clearance, certified OFAC screening, or legal attestation.

## Known failure modes

- Missing required 'name' field returns validation error
- LEI format invalid (not 20 characters) may cause GLEIF resolution failure
- Threshold outside 0-1 range returns error
- Limit exceeding 50 rejected
- Network or upstream OFAC/GLEIF data source unavailable returns 5xx
- Payment not provided or insufficient returns 402 Payment Required
- False positives and false negatives possible by design — flagged in response banner

## How this service works

KYB entity diligence pack — OFAC SDN fuzzy screen + GLEIF LEI match/resolve in one agent JSON. Directional only; not clearance.

## Output

Returns a JSON object with an 'ofac' block containing fuzzy-matched SDN hits and hit count, a 'gleif' block with LEI match results and resolved entity record, list freshness timestamps for both OFAC and GLEIF, and prominent disclaimers that results are directional only and not clearance or 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-411bc6cb/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)
