# Legal Entity Resolver (SEC/GLEIF/Wikidata)

> Legal Entity Resolver (SEC/GLEIF/Wikidata) is a paid API for AI agents from payai.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 registries, returning a reconciled set of cross-registry IDs, legal name, jurisdiction, status, and optional corporate hierarchy.

## Facts

- Endpoint: GET https://payai.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-c132cd43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ykKMW7GxHV9YsXcqqTDNz

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-c132cd43
```

Example prompt: Can you resolve Apple Inc. across SEC EDGAR, GLEIF, and Wikidata and give me all its known IDs — CIK, LEI, QID, ISIN, and ticker — along with its legal jurisdiction and corporate hierarchy?

## When to prefer this

Use this endpoint when you need to cross-reference a legal entity across SEC, GLEIF, and Wikidata in a single call, especially when you have only one identifier and need the full set. Prefer this over scraping individual registries when you need provenance-tagged, reconciled IDs and optional corporate hierarchy in one request.

## Known failure modes

- Ambiguous name match returns multiple candidates or top fuzzy match that may be wrong company
- Unknown identifier returns 404 or empty result if not found in any registry
- ISIN or LEI not yet indexed in GLEIF returns partial result with missing LEI fields
- Ticker disambiguation fails without a country hint when multiple companies share symbol
- Rate limit or payment failure returns 402 or 429 error

## 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 (CIK, LEI, QID, ISIN, ticker, EIN), the official legal name, jurisdiction, and entity status, with per-identifier provenance indicating which registry sourced each value. If the 'hierarchy' extra is requested, also includes GLEIF parent and child entities.

## 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-c132cd43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)