# Oblique Markets GLEIF Legal Entity Resolver

> Oblique Markets GLEIF Legal Entity Resolver is a paid API for AI agents from api.oblique.markets, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Resolves a legal entity against the public GLEIF registry by LEI, legal name, jurisdiction, registration ID, or country, returning ranked matches with auditable registry evidence

## Facts

- Endpoint: POST https://api.oblique.markets/api/v1/paid/gleif-resolve
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oblique-markets-gleif-legal-entity-resolver-3fa34890
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_juUF10EcG4dAEEHSoQOn6

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 oblique-markets-gleif-legal-entity-resolver-3fa34890 -d '<json body>'
```

Example prompt: Can you look up 'Deutsche Bank AG' in the GLEIF registry by legal name and return ranked candidate matches so I can confirm their LEI and jurisdiction?

## When to prefer this

Choose this endpoint when you need authoritative legal entity identification backed by GLEIF registry data — particularly for KYC/KYB workflows, counterparty verification, compliance checks, or any scenario requiring an auditable LEI resolution trail. It supports multiple lookup modes (LEI, name, registration ID, jurisdiction, country) and can return ranked candidates for ambiguous queries, making it more flexible than a simple LEI-only lookup.

## Known failure modes

- Ambiguous name with no single top match returns error unless candidates=true is set
- Invalid or malformed LEI (not 20 characters) returns validation error
- Unknown registration ID or jurisdiction combination yields no match
- Country code not in ISO 3166-1 alpha-2 format causes input rejection
- GLEIF registry temporarily unavailable causes upstream timeout

## How this service works

Use when an agent needs to identify a company as a legal entity. Returns a resolution against the public legal entity identifier (LEI) registry by LEI, legal name, jurisdiction, registration ID or country, with ranked matches and auditable registry evidence. $0.01.

## Output

Returns ranked legal entity matches from the GLEIF registry, each including the LEI code, legal name, jurisdiction, registration details, entity status, and auditable registry evidence supporting the match.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string",
   "description": "20-character Legal Entity Identifier"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 legal-address country code"
  },
  "candidates": {
   "type": "boolean",
   "description": "Return ranked candidates instead of rejecting an ambiguous match"
  },
  "legal_name": {
   "type": "string",
   "description": "Legal entity name or distinctive name fragment"
  },
  "jurisdiction": {
   "type": "string",
   "description": "ISO 3166-2 jurisdiction code"
  },
  "registration_id": {
   "type": "string",
   "description": "Entity registration identifier"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "match": {
   "lei": "5493001KJTIIGC8Y1R12",
   "parent": {
    "direct": null,
    "ultimate": null,
    "relationship_links": {
     "direct": null,
     "ultimate": null
    }
   },
   "status": "ACTIVE",
   "registry": {
    "creation_date": null,
    "expiration_date": null,
    "last_update_date": "2026-08-20T10:00:00Z",
    "next_renewal_date": "2027-01-02T10:00:00Z",
    "initial_registration_date": "2018-01-02T10:00:00Z"
   },
   "addresses": {
    "legal": {
     "city": "London",
     "region": null,
     "country": "GB",
     "postal_code": "SW1A 1AA",
     "address_lines": [
      "1 Example Street"
     ],
     "address_number": null
    },
    "other": [],
    "headquarters": null
   },
   "legal_form": {
    "id": "8888",
    "other": "Limited company"
   },
   "legal_name": "Example Holdings Ltd",
   "source_url": "https://api.gleif.org/api/v1/lei-records/5493001KJTIIGC8Y1R12",
   "match_score": 101,
   "jurisdiction": "GB",
   "registration": {
    "id": "01234567",
    "status": "ISSUED",
    "authority_id": "RA000585",
    "validated_as": "01234567"
   },
   "match_reasons": [
    "exact_legal_name"
   ]
  },
  "query": {
   "legal_name": "Example Holdings Ltd"
  },
  "source": "GLEIF Golden Copy",
  "candidates": [],
  "retrieved_at": "2026-08-23T12:00:00.000Z",
  "evidence_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oblique-markets-gleif-legal-entity-resolver-3fa34890/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.oblique.markets](https://www.zero.xyz/host/api.oblique.markets/llms.txt)