# LEI Lookup Search — Find Legal Entities by Name & LEI (`neuralverge/neuralverge-lei-search`) Actor

Search the global GLEIF LEI database by keyword — country, legal name, LEI code, entity status and LEI status for every matching entity, one row each. No API key. Structured JSON for KYB & entity resolution. A miss costs only the small run fee.

- **URL**: https://apify.com/neuralverge/neuralverge-lei-search.md
- **Developed by:** [NeuralVerge](https://apify.com/neuralverge) (community)
- **Categories:** Automation, Developer tools, Lead generation
- **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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Search — Find Legal Entity Identifiers by Name ✅ No API Key

Search the **LEI (Legal Entity Identifier) database** by keyword and get **one row per
matching entity** — legal name, LEI code, country, entity status and LEI status. Powered
by the Neuralverge API. **No API key or account required.**

Ideal for KYC/KYB, counterparty discovery, compliance and building lists of legal
entities and their LEIs.

### ✨ Why this Actor

- 🌍 **One row per entity** — a keyword search returns every matching legal entity as a
  separate, exportable row.
- 🔎 **Disambiguate fast** — see country, entity status and LEI status side by side to
  pick the right entity, then look up its full record.
- 🔑 **No API key or account** — the search runs on the Neuralverge backend.
- ⚡ **Real-time & structured** — fresh results each run, ready for a spreadsheet, CRM or
  AI pipeline.

### 🔧 How it works

1. **Provide a search keyword** — a company name or fragment (e.g. `revolut`).
2. **Run the Actor.** The search and structuring happen on the Neuralverge backend.
3. **Get one dataset row per matching entity.** Export to CSV, JSON or Excel, or pull it
   over the Apify API.

To get a single entity's full record (addresses, registration authority, parents), feed
its LEI into the LEI Lookup actor.

### Input

| Field | Type | Notes |
|---|---|---|
| `searchQuery` | string | Keyword to search the LEI database (company name or fragment), e.g. `revolut`. |

```json
{
  "searchQuery": "revolut"
}
```

### What you'll receive

**One dataset row per matching entity.** Each row is a search-result object with:
`legal_name`, `lei`, `country`, `entity_status` (e.g. `ACTIVE`, `INACTIVE`) and
`lei_status` (e.g. `ISSUED`, `LAPSED`, `RETIRED`).

#### Example output (real run)

One entity row from a `revolut` keyword search, exactly as it appears in the dataset. A
single search of this kind returned 56 matching entities — this is one of them.

```json
{
  "country": "GB",
  "legal_name": "REVOLUT LTD",
  "lei": "213800MQORWPL582SW82",
  "entity_status": "ACTIVE",
  "lei_status": "ISSUED"
}

```

> Genuine output from a live run — one matching entity with its LEI, country and status.

### Pricing

Pay per event — **$0.005 per run**, plus **$0.005 per entity** ($5 per 1,000) returned to the dataset. **You pay
only for entities returned — an empty search is free.**

| Event | Price |
|---|---|
| Lookup (per run) | **$0.005** |
| Entity returned (per dataset row) | **$0.005** |

Searches that return no entities are **not charged the per-result price** — only the $0.005 lookup fee applies. Pricing is on top of your Apify
platform usage.

#### Free plan limits

Users on any **paid Apify plan** are not affected by anything in this section.

On the **Apify Free plan** all Neuralverge Actors share one budget, per user and per calendar month:
**15 runs in total, at most 5 of them on this Actor, and 35 returned rows.** A run that finds nothing
still counts, because the lookup is performed either way. LinkedIn People Search is metered
differently — one run there uses 25 of the 35 rows, because a full page of 25 profiles is bought
upstream whether or not all of them are returned. When a limit is reached the Actor stops gracefully
with a status message naming it; everything resets on the 1st of every month, and any paid Apify
plan removes all of it.

### 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. The search runs on the Neuralverge backend.

**How do I get a full LEI record?** Take an entity's `lei` from the results and run the
LEI Lookup actor for its addresses, registration authority and parent relationships.

**Am I charged for an empty search?** No. You're billed only for entities returned.

***

**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

## `searchQuery` (type: `string`):

The keyword to search the LEI database for (company name or fragment), e.g. revolut. Apify Free plan: all Neuralverge Actors share one monthly budget per user — 15 runs in total, at most 5 of them on this Actor, and 35 returned rows; a run that finds nothing counts too. Any paid Apify plan removes the limit.

## Actor input object example

```json
{
  "searchQuery": "revolut"
}
```

# Actor output Schema

## `results` (type: `string`):

Structured LEI search results (country, legal name, LEI, entity status, LEI status), one row per entity found.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "revolut"
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuralverge/neuralverge-lei-search").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQuery": "revolut" }

# Run the Actor and wait for it to finish
run = client.actor("neuralverge/neuralverge-lei-search").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 '{
  "searchQuery": "revolut"
}' |
apify call neuralverge/neuralverge-lei-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=neuralverge/neuralverge-lei-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/qw0fNve19WG6motPb/builds/kJAU83LcHvWcnlf0s/openapi.json