Legal

Data source: GLEIF

REST Bridge Endpoint https://context.gnist.ai/rest/gleif/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (6)

search_entities
get_entity
get_ownership_chain
resolve_bic
resolve_isin
report_feedback

search_entities

Search GLEIF for registered legal entities by name, registration number, or jurisdiction.

GLEIF (Global Legal Entity Identifier Foundation) covers 2M+ legal entities in 200+
countries. Each entity is identified by a 20-character LEI (ISO 17442) — the global
standard mandated for financial reporting under EMIR, MiFID II, Dodd-Frank, and DORA.

At least one filter parameter must be provided.

Args:
name: Legal name or partial name to search for (e.g. "Apple Inc", "Deutsche Bank").
registration_number: Company registration number from the national registry.
jurisdiction: ISO 3166-1 alpha-2 country code (e.g. "US", "DE", "NO", "GB").
status: Registration status filter — "ISSUED" (active), "LAPSED" (expired renewal),
"MERGED", "RETIRED", "PENDING_TRANSFER", or "ANNULLED".
limit: Number of results to return (1–50, default 10).

Returns:
Dict with 'count' and 'entities' list. Each entity includes lei, name, other_names,
jurisdiction, registration_number, registered_address, legal_form, status,
next_renewal date, and managing_lou (Local Operating Unit).

Parameter	Type	Required	Description
`name`	`any`	optional	Legal name or partial name to search for (e.g. "Apple Inc", "Deutsche Bank").
`registration_number`	`any`	optional	Company registration number from the national registry.
`jurisdiction`	`any`	optional	ISO 3166-1 alpha-2 country code (e.g. "US", "DE", "NO", "GB").
`status`	`any`	optional	Registration status filter — "ISSUED" (active), "LAPSED" (expired renewal), "MERGED", "RETIRED", "PENDING_TRANSFER", or "ANNULLED".
`limit`	`integer`	optional	Number of results to return (1–50, default 10). (default: 10)

Request Body

{
  "query": "example"
}

get_entity

Fetch the full GLEIF record for a Legal Entity Identifier (LEI).

Returns the authoritative entity record as registered with GLEIF — canonical legal name,
all registered names, jurisdiction, registration number, registered address, legal form,
current registration status, and next renewal date.

Args:
lei: The 20-character LEI code (e.g. "HWUPKR0MPOU8FGXBT394" for Apple Inc).

Returns:
Dict with lei, name, other_names, jurisdiction, registration_number,
registered_address, legal_form, status, next_renewal, and managing_lou.
Returns {"error": "not_found"} if the LEI does not exist.

Parameter	Type	Required	Description
`lei`	`string`	required	The 20-character LEI code (e.g. "HWUPKR0MPOU8FGXBT394" for Apple Inc).

Request Body

{
  "lei": "example"
}

get_ownership_chain

Retrieve ownership chain relationships for a legal entity.

Uses GLEIF's relationship data to traverse the corporate ownership structure.
Covers entities that report their ownership chain as part of LEI registration.

Args:
lei: The 20-character LEI of the entity to look up.
direction: Which relationships to retrieve:
- "direct_parent" — the entity that directly consolidates this one (default)
- "ultimate_parent" — the topmost parent in the ownership chain
- "children" — entities directly consolidated by this one (subsidiaries)

Returns:
Dict with 'lei', 'direction', 'count', and 'relationships' list.
Each relationship includes relationship_type, relationship_status,
start_lei (child), and end_lei (parent).
Returns empty list if no relationships are registered.

Parameter	Type	Required	Description
`lei`	`string`	required	The 20-character LEI of the entity to look up.
`direction`	`string`	optional	Which relationships to retrieve: - "direct_parent" — the entity that directly consolidates this one (default) - "ultimate_parent" — the topmost parent in the ownership chain - "children" — en... (default: "direct_parent")

Request Body

{
  "lei": "example"
}

resolve_bic

Resolve a SWIFT BIC code to its corresponding LEI.

Uses the GLEIF BIC-to-LEI mapping maintained in cooperation with SWIFT.
Essential for financial agents processing SWIFT messages or correspondent banking data.

Args:
bic: The SWIFT Bank Identifier Code (8 or 11 characters, e.g. "DEUTDEDB").

Returns:
Dict with 'bic' and 'lei' if a mapping exists, or {"error": "not_found"} otherwise.
Use get_entity(lei) to retrieve the full entity record for the resolved LEI.

Parameter	Type	Required	Description
`bic`	`string`	required	The SWIFT Bank Identifier Code (8 or 11 characters, e.g. "DEUTDEDB").

Request Body

{
  "bic": "example"
}

resolve_isin

Resolve an ISIN (securities identifier) to the issuing entity's LEI.

Covers equities, bonds, and structured products. Enables agents to identify
the legal entity behind a financial instrument.

Args:
isin: The 12-character International Securities Identification Number
(e.g. "US0378331005" for Apple common stock).

Returns:
Dict with 'isin' and 'lei' if a mapping exists, or {"error": "not_found"} otherwise.
Use get_entity(lei) to retrieve the full entity record for the resolved LEI.

Parameter	Type	Required	Description
`isin`	`string`	required	The 12-character International Securities Identification Number (e.g. "US0378331005" for Apple common stock).

Request Body

{
  "isin": "123456789"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/gleif/get_entity" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"lei": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/gleif/get_entity",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "lei": "example"
},
)
print(resp.json())