GLEIF legal entities (Open Feed)

curl --request GET \
  --url https://gdeltcloud.com/api/v2/gleif/entities \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/gleif/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "lei": "5493001KJTIIGC8Y1R12",
      "legal_name": "Example Holdings plc",
      "jurisdiction": "GB"
    }
  ],
  "pagination": {
    "limit": 25,
    "next_cursor": null
  },
  "applied_filters": {
    "search": "Example Holdings"
  },
  "meta": {
    "attributions": [
      {
        "source": "GLEIF",
        "license": "CC0"
      }
    ]
  }
}

Reference Data

GLEIF legal entities (Open Feed)

The GLEIF Global LEI Index — 3.39M legal entities with their registered name, jurisdiction, entity and registration status, legal form and registration authority, served close to as-published. At least one filter is required: the feed covers 3.39M records, so an unfiltered listing is refused with 400 FILTER_REQUIRED rather than served slowly. name matches the normalized legal name exactly or by prefix (never a substring scan). Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF’s required non-endorsement notice.

GET

api

gleif

entities

GLEIF legal entities (Open Feed)

curl --request GET \
  --url https://gdeltcloud.com/api/v2/gleif/entities \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/gleif/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "lei": "5493001KJTIIGC8Y1R12",
      "legal_name": "Example Holdings plc",
      "jurisdiction": "GB"
    }
  ],
  "pagination": {
    "limit": 25,
    "next_cursor": null
  },
  "applied_filters": {
    "search": "Example Holdings"
  },
  "meta": {
    "attributions": [
      {
        "source": "GLEIF",
        "license": "CC0"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

lei

string

One or more LEIs, comma-separated (max 100). Each must pass the ISO 17442 check digit.

name

string

Legal name — normalized-exact or prefix match. Not a substring search.

country

string

ISO-3 country of the legal address (our house convention). Full value list: https://docs.gdeltcloud.com/reference/enums#country

jurisdiction

string

GLEIF's raw legal jurisdiction — alpha-2 or subdivision (US-CA). Observed vocabulary, measured 2026-08-10 (307 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/gleif/entities?country=<iso3>&limit=1 — readlegal_jurisdiction``. GLEIF's legal jurisdiction as published — ISO 3166-1 alpha-2 plus alpha-2/subdivision forms such as US-CA. Uppercased but NOT validated by the serve layer, unlike the three GLEIF status enums beside it, so an unlisted jurisdiction returns an empty 200. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_jurisdiction

entity_status

enum<string>

Entity status. Validated against the allowed set; a bad value returns 400 INVALID_ENUM with details.accepted_values. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_entity_status

Available options:

ACTIVE,

INACTIVE,

NULL

registration_status

enum<string>

LEI registration status — e.g. ISSUED, LAPSED, RETIRED. A LAPSED registration does NOT mean the company ceased to exist. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_registration_status

Available options:

ISSUED,

LAPSED,

PENDING_TRANSFER,

PENDING_ARCHIVAL,

DUPLICATE,

RETIRED,

ANNULLED,

CANCELLED,

TRANSFERRED,

PENDING_VALIDATION,

PUBLISHED,

MERGED

entity_category

enum<string>

GLEIF entity category — e.g. GENERAL, FUND, BRANCH, SOLE_PROPRIETOR. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_entity_category

Available options:

GENERAL,

BRANCH,

FUND,

SOLE_PROPRIETOR,

RESIDENT_GOVERNMENT_ENTITY,

INTERNATIONAL_ORGANIZATION

limit

integer

default:50

Rows to return.

Required range: 1 <= x <= 500

cursor

integer

Offset cursor; echo pagination.next_cursor to page.

Required range: x >= 0

Response

Matching LEI records with pagination, applied_filters and meta.attributions[].

The response is of type object.

Events

Stories

Situations

Entities

Unified Search

Media Intelligence

Facilities

Monitors

Geography

Government

Political Offices

Filings

Reference Data

Energy

AI Compute

Macro Finance

Screening and Reference

China

Maritime

Atlas Intelligence

Briefs

Meta

GLEIF legal entities (Open Feed)

Authorizations

Query Parameters

Response