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

Pay-per-call KYB endpoint that screens a business entity against OFAC SDN list and resolves/matches its GLEIF LEI in a single JSON response, paid in USDC via x402.

## Facts

- Endpoint: POST https://x402-kyb-api.vercel.app/kyb?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-2f0a7573
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o8tRce1chCTCEfy3Qj5CG

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-2f0a7573 -d '<json body>'
```

Example prompt: Can you run a KYB diligence check on 'Acme Trading GmbH' — screen them against the OFAC SDN list and match their GLEIF LEI, using a match threshold of 0.6?

## When to prefer this

Choose this endpoint when you need a combined OFAC SDN screen and GLEIF LEI lookup in a single pay-per-call API call without committing to a subscription. It is ideal for agents that handle infrequent or on-demand KYB checks and can pay per call in USDC via x402 on Base or Solana. Prefer alternatives when you need formal clearance letters, certified attestations, full AML reports, or continuous monitoring — this endpoint is explicitly directional and not a substitute for regulated compliance clearance.

## Known failure modes

- Missing required 'name' field returns a validation error
- Threshold outside 0-1 range may cause a bad request error
- Network or upstream OFAC/GLEIF data source unavailability returns a 5xx error
- Payment not completed via x402 protocol results in a 402 Payment Required response
- Invalid LEI format (not 20 chars) may cause GLEIF resolution to fail or return no match
- Empty name string may return zero hits without error

## 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 containing: OFAC SDN screening results (list of hits with match scores, hit count, and whether results are potential matches only), GLEIF LEI match results (list of matched LEIs and hit count) and optionally a resolved LEI record, timestamps indicating how fresh each list is, and a prominent banner clarifying the result is directional only and not a formal 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-2f0a7573/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)
