# TokenGuard Entity Brief Resolver

> TokenGuard Entity Brief Resolver is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Resolves a company name to its canonical legal entity identity, returning LEI, official name, match score, jurisdiction, and active status via GLEIF.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/brief/entity
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-entity-brief-resolver-1e80638c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hBiSu3mjN56S4xWR1q4nf

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 tokenguard-entity-brief-resolver-1e80638c -d '<json body>'
```

Example prompt: Can you look up the official legal entity record for 'Stripe Inc' and give me its LEI code, canonical name, and whether it's currently active?

## When to prefer this

Use this endpoint when you need to resolve an informal or partial company name to a verified, globally-recognized legal entity identifier (LEI) backed by the GLEIF registry. It is ideal for KYC/AML workflows, counterparty verification, compliance enrichment, or any situation where you need to disambiguate between similarly named entities and get an authoritative canonical name with a confidence score. Prefer this over general web search when you need structured, auditable legal identity data rather than informal descriptions.

## Known failure modes

- Company name too ambiguous — low match score with no clear best match
- Company not found in GLEIF registry — resolved: false with empty candidates
- Limit parameter exceeds max of 25 — may return validation error
- Non-existent or misspelled company name returns no candidates
- Network or upstream GLEIF API unavailability causes 5xx error

## How this service works

Resolve a company name to canonical public identifiers in one call: GLEIF LEI (with registered country, city and status), SEC CIK and ticker, and Wikidata QID, returned as ranked candidates with a name-similarity score. Company disambiguation and KYB from public registries, freely redistributable.

## Output

Returns a JSON object with a resolved flag, the best-matching legal entity including its LEI code, canonical legal name, confidence score, data source (e.g. GLEIF), active/inactive status, and country, plus the total count of candidates considered.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Company name to resolve"
  },
  "limit": {
   "type": "integer",
   "description": "Max candidates (default 8, max 25)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Stripe Inc",
  "resolved": true,
  "best_match": {
   "lei": "549300CLHGIPTCYHQ143",
   "name": "STRIPE, LLC",
   "score": 0.91,
   "source": "GLEIF",
   "status": "ACTIVE",
   "country": "US"
  },
  "candidate_count": 6
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-entity-brief-resolver-1e80638c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)
