# GLEIF Business Registry Fuzzy Name Screen

> GLEIF Business Registry Fuzzy Name Screen is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-10).

Fuzzy-searches a company name against the GLEIF LEI registry, returning ranked candidates with LEI, legal name, jurisdiction, registration status, and corroboration level.

## Facts

- Endpoint: GET https://api.agentstools.dev/kyb/screen?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-business-registry-fuzzy-name-screen-5f6ea3a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E4pkI_I0NXS0ppIjae3CD

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 gleif-business-registry-fuzzy-name-screen-5f6ea3a0
```

Example prompt: Can you screen 'Acme Holdings' against the GLEIF registry and give me the top 3 candidates with their LEI codes, jurisdictions, and registration statuses — filter to US entities only?

## When to prefer this

Use this endpoint as a cheap first step before running full KYB or sanctions checks — it quickly narrows down which legal entity a company name refers to by surfacing their official LEI, jurisdiction, and registration status from the authoritative GLEIF registry. Prefer this over broader company enrichment endpoints when you specifically need an LEI or need to confirm legal entity identity in a regulated context.

## Known failure modes

- No candidates found for the given name (empty results list)
- Country filter excludes all matching entities
- Name is too ambiguous to surface relevant candidates
- GLEIF registry unavailable or timeout
- Malformed query parameter returns 400 error
- Rate limit exceeded returns 402 or 429 error

## How this service works

Screen a company name against the GLEIF business registry: fuzzy name search returning ranked candidates, each with its LEI, legal name, jurisdiction, registration status and corroboration level. Cheap first step before kyb/verify.

## Output

A ranked list of up to 10 candidate legal entities matching the queried name, each containing: LEI code, official legal name, jurisdiction, registration status, and corroboration level — ordered by fuzzy match confidence.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Company name to screen for"
      },
      "limit": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Max candidates to return, default 5"
      },
      "country": {
       "type": "string",
       "description": "Optional country filter, e.g. US"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-business-registry-fuzzy-name-screen-5f6ea3a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)