GLEIF LEI Registration & Renewal Evidence API

Read up to five exact public LEI records from the GLEIF API. Validate20-character LEI syntax and ISO7064 mod97 checksum before contact; check that both returned record ID and attributes.lei equal the requested code. The checksum is only a syntax check, not proof of identity. Select legal name, legal jurisdiction/category, entity status, registration status, initial/last-update/next-renewal declarations and managing-LOU code. Sole-proprietor records are rejected; no individual profiles, addresses, registration numbers, officers, beneficial owners, relationships, events, ISINs or fuzzy/name search are retrieved separately or emitted. Lapsed/active/retired labels remain source declarations: no approve/reject decision, KYB/KYC result, credit rating, sanctions screening or legal/compliance/financial advice. The source can lag changes; a missing/error record does not prove that an entity does not exist. Data from the Global Legal Entity Identifier Foundation; use official GLEIF bulk/delta files for large inventories.

Input example

{
  "leis": [
    "5493001KJTIIGC8Y1R12",
    "HWUPKR0MPOU8FGXBT394"
  ],
  "maxResults": 2
}

Outputs and change comparison

One saved observation is one dataset row with itemKey, sourceUrl, contentHash and observedAt. The SHA256 covers only selected semantic fields; retrieval times, API request URLs, download/popularity counters and people are excluded. Copy SNAPSHOT.previousHashes into the next input to compare the same exact watchlist. Statuses are NO_BASELINE, FIRST_SEEN, UNCHANGED or CHANGED. Unchanged observations are still billable. There is no hidden persistent baseline and no missing-row/deletion inference. OUTPUT records actual requestCount, rowsEmitted, source summaries, errors, status and complete. SNAPSHOT.complete is false after any error or when any requested observation could not be delivered. Reaching the selected result cap is PARTIAL_RESULT_CAP; a monetary budget stop is PARTIAL_BUDGET. Provider restrictions produce PARTIAL_PROVIDER_LIMIT. A saved observation means successful metadata extraction only, not an independent validation, compliance decision or purchase recommendation.

Pricing and bounded work

$0.005 startup plus $0.001 per saved observation, pay per event. Startup quantity follows Apify memory rules with minimum one. Minimum permitted run budget: $0.0055. Default 256 MB, timeout 120 seconds, no restart. Five identifiers and at most five rows; a 55-second fetch deadline and two-MiB decoded-body cap apply. API requests are made only after checking the affordable result capacity. Zero affordable observations causes zero source requests, including no provider request. Before each later request and dataset write the budget is checked again. Responses that do not produce a saved row are not charged as observations; startup can still apply. No browser, paid proxy, paid external API or credentials. No network retries, bypasses, open-ended search or bulk pagination. Shared-IP provider limits still apply across runs: avoid parallel requests that exceed provider policy and use supported bulk data channels for large extraction.

Failure and access behavior

Only constructed official HTTPS API endpoints are contacted. Only fixed official provider endpoints constructed from validated identifiers are used. Private addresses and credential-bearing/cross-provider redirects are rejected. HTTP403/429 or Retry-After stops further provider work; successful current responses can be retained. Unknown/missing identifiers are errors, never guessed missing/safe states. All-source failure exits nonzero after preserving OUTPUT; partial delivery preserves successful rows and explicit errors. Source records and raw declarations can change, and the Actor does not independently verify artifact bytes, publisher identity, signatures or legal rights. Public upstream APIs/data may be free; the fee covers the bounded selection, validation, comparison/output workflow and Apify execution. There is no affiliation, exclusive data access, guaranteed availability, completeness or revenue claim.

Official sources

• https://www.gleif.org/en/lei-data/gleif-api
• https://www.gleif.org/en/lei-data/access-and-use-lei-data