# Legal Entity Resolver (SEC/GLEIF/Wikidata Cross-Registry)

> Legal Entity Resolver (SEC/GLEIF/Wikidata Cross-Registry) is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-10).

Resolves a single legal entity identifier (name, ticker, CIK, LEI, QID, or ISIN) across SEC EDGAR, GLEIF, and Wikidata, returning a reconciled set of cross-registry IDs, legal name, jurisdiction, status, and optional corporate hierarchy.

## Facts

- Endpoint: GET https://api.agentstools.dev/entity/resolve?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/legal-entity-resolver-sec-gleif-wikidata-cross-registry-738e0358
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eIFnVuq_IPeWxjqrmAh43

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 legal-entity-resolver-sec-gleif-wikidata-cross-registry-738e0358
```

Example prompt: Can you look up all the official regulatory identifiers for Apple — like its SEC CIK, GLEIF LEI, Wikidata QID, and ISIN — using its ticker symbol AAPL, and also include its parent/child corporate hierarchy?

## When to prefer this

Use this endpoint when you need to cross-reference a legal entity across multiple public registries (SEC, GLEIF, Wikidata) from a single known identifier, especially for KYC enrichment, compliance checks, financial research, or building a canonical entity record. Prefer this over scraping individual registries when you need reconciled, multi-source IDs with provenance in a single call.

## Known failure modes

- Ambiguous name match returns multiple candidates or lowest-confidence result — use a more specific identifier like ticker or LEI instead
- Unknown or unregistered entity returns 404 or empty result set
- ISIN or LEI format validation failure if wrong length/format provided
- GLEIF hierarchy not returned unless include=hierarchy is explicitly passed
- Partial results if entity is only present in one or two registries
- Rate limit or payment failure returns 402 or 429

## How this service works

Resolve one legal entity across three public registries from a single identifier. Give exactly one of name, ticker, cik, lei, qid or isin and get back the reconciled set of ids (SEC CIK, GLEIF LEI, Wikidata QID, ISIN, ticker, EIN) plus legal name, jurisdiction and status, with per-id provenance and an optional GLEIF parent/child hierarchy.

## Output

Returns a reconciled object containing all available cross-registry identifiers (SEC CIK, GLEIF LEI, Wikidata QID, ISIN, ticker, EIN), the entity's legal name, jurisdiction, and registration status, with per-identifier provenance indicating which registry supplied each value, and optionally a GLEIF corporate parent/child hierarchy if requested.

## 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": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC EDGAR CIK (any zero-padding accepted)"
      },
      "lei": {
       "type": "string",
       "description": "GLEIF Legal Entity Identifier, 20 characters"
      },
      "qid": {
       "type": "string",
       "description": "Wikidata item id, e.g. Q312"
      },
      "isin": {
       "type": "string",
       "description": "ISIN security identifier, 12 characters"
      },
      "name": {
       "type": "string",
       "description": "Legal or common company name (fuzzy match)"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL"
      },
      "country": {
       "type": "string",
       "description": "Optional country hint for disambiguation, e.g. US"
      },
      "include": {
       "type": "array",
       "items": {
        "enum": [
         "hierarchy"
        ],
        "type": "string"
       },
       "description": "Optional extras. Use hierarchy for GLEIF parents and children"
      }
     }
    }
   },
   "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/legal-entity-resolver-sec-gleif-wikidata-cross-registry-738e0358/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)
