# LEI Lookup — Legal Entity Data, Address & Parents (`neuralverge/neuralverge-lei-company`) Actor Look up any GLEIF Legal Entity Identifier (LEI) — legal name, status, legal & HQ address, jurisdiction, registration authority, renewal dates and parent/child relationships. No API key. Structured JSON for KYB & counterparty checks. Pay only for records found. - **URL**: https://apify.com/neuralverge/neuralverge-lei-company.md - **Developed by:** [NeuralVerge](https://apify.com/neuralverge) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### LEI Lookup — Legal Entity Data, Address & Parents ✅ No API Key Look up any **Legal Entity Identifier (LEI)** record — legal name, legal & headquarters addresses, registration authority, jurisdiction, entity status, registration/renewal dates, managing LOU and parent (consolidation) relationships. Powered by the Neuralverge API. **No API key or account required**, and **you only pay for records we actually find**. Ideal for KYC/KYB, counterparty and beneficial-ownership checks, compliance and feeding entity data to AI agents. ### ✨ Why this Actor - 🌍 **Full LEI record** — identity, addresses, registration authority, dates and parent relationships in one structured object. - 💸 **Pay only for the records you get** — unresolved LEIs are skipped and never billed. Misses are free; no empty, billable rows. - 🔑 **No API key or account** — extraction runs on the Neuralverge backend. - ⚡ **Real-time & structured** — fresh data each run and one predictable JSON schema. ### 🔧 How it works 1. **Provide a 20-character LEI code** (e.g. `213800MQORWPL582SW82`) — or an advanced full lei-lookup.com record URL. 2. **Run the Actor.** Fetching and AI-structuring the record happens on the Neuralverge backend. 3. **Get one dataset row per record** — the source `url`, the extraction `settings` (including the JSON schema) and the structured `machine` object. Export to CSV, JSON or Excel, or pull it over the Apify API. If the LEI can't be resolved, it's logged and **skipped without charge**. ### Input One record per run. | Field | Type | Notes | |---|---|---| | `lei` | string | The 20-character Legal Entity Identifier, e.g. `213800MQORWPL582SW82`. | | `recordUrl` | string | Advanced: a full lei-lookup.com record URL to use instead of the LEI. | ```json { "lei": "213800MQORWPL582SW82" } ```` ### What you'll receive Each dataset row mirrors the Neuralverge system output and has three top-level blocks: - **`url`** — the LEI record URL that was scraped. - **`settings`** — the extraction settings, including the full JSON schema used, at `settings.extract_schema_json`. - **`machine`** — the structured result: `lei`, `legal_name`, `legal_address`, `headquarters_address`, `registration_authority`, `legal_jurisdiction`, `entity_category`, `entity_status`, `initial_registration_date`, `last_update_date`, `next_renewal_date`, `managing_lou` and `relationships` (parent / consolidation links). > **Nulls & empty values are normal.** Only data present on the record is filled — e.g. > `relationships` is empty when no parent is reported, and `entity_category` may be absent. #### Example output (real run) A real dataset row from `https://www.lei-lookup.com/record/213800MQORWPL582SW82`, shown **in full** — including the complete extraction **schema** (`settings.extract_schema_json`) and the full **machine-readable result** (`machine`). The `human` markdown summary is produced by the system but omitted from the dataset. ```json { "url": "https://www.lei-lookup.com/record/213800MQORWPL582SW82", "settings": { "has_schema": true, "country_code": "us", "extract_schema_json": { "type": "object", "properties": { "lei": { "type": "string", "description": "The 20-character Legal Entity Identifier (LEI) code." }, "legal_name": { "type": "string", "description": "The official legal name of the entity as registered." }, "legal_address": { "type": "object", "description": "The address of the legal entity's registered office.", "properties": { "street_lines": { "type": "array", "items": { "type": "string" }, "description": "Street address line(s)." }, "city": { "type": "string", "description": "The city of the address." }, "region": { "type": "string", "description": "The region, state, or province of the address." }, "postal_code": { "type": "string", "description": "The postal or ZIP code." }, "country": { "type": "string", "description": "The two-letter ISO 3166-1 alpha-2 country code (e.g., 'US')." } }, "required": [ "street_lines", "city", "postal_code", "country" ] }, "headquarters_address": { "type": "object", "description": "The address of the entity's headquarters.", "properties": { "street_lines": { "type": "array", "items": { "type": "string" }, "description": "Street address line(s)." }, "city": { "type": "string", "description": "The city of the address." }, "region": { "type": "string", "description": "The region, state, or province of the address." }, "postal_code": { "type": "string", "description": "The postal or ZIP code." }, "country": { "type": "string", "description": "The two-letter ISO 3166-1 alpha-2 country code (e.g., 'US')." } } }, "registration_authority": { "type": "object", "description": "Details of the authority where the entity is registered.", "properties": { "id": { "type": "string", "description": "The identifier for the registration authority (e.g., 'RA000533')." }, "name": { "type": "string", "description": "The name of the registration authority (e.g., 'Delaware Division of Corporations')." } } }, "legal_jurisdiction": { "type": "string", "description": "The legal jurisdiction of the entity (e.g., 'US-DE')." }, "entity_category": { "type": "string", "description": "The category of the entity (e.g., 'GENERAL', 'FUND')." }, "entity_status": { "type": "string", "description": "The current status of the LEI record (e.g., 'ACTIVE', 'LAPSED')." }, "initial_registration_date": { "type": "string", "format": "date", "description": "The date when the LEI was first registered." }, "last_update_date": { "type": "string", "format": "date", "description": "The date when the LEI record was last updated." }, "next_renewal_date": { "type": "string", "format": "date", "description": "The date by which the LEI needs to be renewed to remain active." }, "managing_lou": { "type": "string", "description": "The LEI of the Local Operating Unit (LOU) responsible for managing the record." }, "relationships": { "type": "array", "description": "Parental relationships of the entity.", "items": { "type": "object", "properties": { "relationship_type": { "type": "string", "description": "The type of relationship (e.g., 'IS_DIRECTLY_CONSOLIDATED_BY', 'IS_ULTIMATELY_CONSOLIDATED_BY')." }, "parent_lei": { "type": "string", "description": "The LEI of the parent entity." }, "parent_name": { "type": "string", "description": "The legal name of the parent entity." } }, "required": [ "relationship_type", "parent_lei", "parent_name" ] } } }, "required": [ "lei", "legal_name", "legal_address", "entity_status", "initial_registration_date", "last_update_date", "next_renewal_date" ] } }, "machine": { "lei": "213800MQORWPL582SW82", "legal_name": "REVOLUT LTD", "legal_address": { "street_lines": [ "30 SOUTH COLONNADE" ], "city": "LONDON", "region": "GB-LND", "postal_code": "E14 5HX", "country": "GB" }, "headquarters_address": { "street_lines": [ "30 SOUTH COLONNADE" ], "city": "LONDON", "region": "GB-LND", "postal_code": "E14 5HX", "country": "GB" }, "registration_authority": { "id": "08804411", "name": "Companies Register (Companies House)\n\nUnited Kingdom, England and Wales" }, "legal_jurisdiction": "GB", "entity_category": "GENERAL", "entity_status": "ACTIVE", "initial_registration_date": "2018-01-25", "last_update_date": "2026-04-08", "next_renewal_date": "2027-04-25", "managing_lou": "LONDON STOCK EXCHANGE LEI LIMITED", "relationships": [ { "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY", "parent_lei": "213800UIKMYZWWQS5E02", "parent_name": "REVOLUT GROUP HOLDINGS LTD" }, { "relationship_type": "IS_ULTIMATELY_CONSOLIDATED_BY", "parent_lei": "213800UIKMYZWWQS5E02", "parent_name": "REVOLUT GROUP HOLDINGS LTD" } ] } } ``` > Genuine output from a live run — REVOLUT LTD, an ACTIVE record with legal & HQ > addresses and two parent (consolidation) relationships resolved. ### Pricing Pay per result — **$0.005 per record** ($5 per 1,000) returned to the dataset. **You pay only for rows returned — misses are free.** | Event | Price | |---|---| | Actor start | Free | | Record returned (per dataset row) | **$0.005** | LEIs that can't be resolved are **not billed**. Pricing is on top of your Apify platform usage. ### Integrations & API Results are stored in a standard Apify dataset — export as CSV, JSON, XML or Excel, or fetch on demand through the [Apify API](https://docs.apify.com/api). The Actor also plugs into Apify's integrations (Make, Zapier, n8n, webhooks) and can be called from any [MCP](https://mcp.apify.com/) client. ### FAQ **Do I need an account or API key?** No. Extraction runs on the Neuralverge backend. **What identifier do I use?** The 20-character LEI code, e.g. `213800MQORWPL582SW82`. You can also pass a full lei-lookup.com record URL. **Am I charged if a record isn't found?** No. You're billed only for rows returned to the dataset. *** **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by GLEIF or any LEI issuer. LEI data originates from the public Global LEI System. # Actor input Schema ## `lei` (type: `string`): The 20-character Legal Entity Identifier (LEI) to look up, e.g. 213800MQORWPL582SW82. ## `recordUrl` (type: `string`): Optional. A full lei-lookup.com record URL to use instead of the LEI, e.g. https://www.lei-lookup.com/record/213800MQORWPL582SW82. ## Actor input object example ```json { "lei": "213800MQORWPL582SW82" } ``` # Actor output Schema ## `results` (type: `string`): Structured GLEIF LEI record data (legal name, status, addresses, registration authority, relationships), one row per matched LEI. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "lei": "213800MQORWPL582SW82" }; // Run the Actor and wait for it to finish const run = await client.actor("neuralverge/neuralverge-lei-company").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "lei": "213800MQORWPL582SW82" } # Run the Actor and wait for it to finish run = client.actor("neuralverge/neuralverge-lei-company").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "lei": "213800MQORWPL582SW82" }' | apify call neuralverge/neuralverge-lei-company --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=neuralverge/neuralverge-lei-company", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "LEI Lookup — Legal Entity Data, Address & Parents", "description": "Look up any GLEIF Legal Entity Identifier (LEI) — legal name, status, legal & HQ address, jurisdiction, registration authority, renewal dates and parent/child relationships. No API key. Structured JSON for KYB & counterparty checks. Pay only for records found.", "version": "0.1", "x-build-id": "CnpifkaBRXaRMIU48" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuralverge~neuralverge-lei-company/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuralverge-neuralverge-lei-company", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/neuralverge~neuralverge-lei-company/runs": { "post": { "operationId": "runs-sync-neuralverge-neuralverge-lei-company", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/neuralverge~neuralverge-lei-company/run-sync": { "post": { "operationId": "run-sync-neuralverge-neuralverge-lei-company", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "lei": { "title": "LEI code", "type": "string", "description": "The 20-character Legal Entity Identifier (LEI) to look up, e.g. 213800MQORWPL582SW82." }, "recordUrl": { "title": "Record URL (advanced)", "type": "string", "description": "Optional. A full lei-lookup.com record URL to use instead of the LEI, e.g. https://www.lei-lookup.com/record/213800MQORWPL582SW82." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```