How to Use GLEIF company search in Codex
Returns LEI records matching a company name, with optional country narrowing. Use it to find candidate legal entities before choosing an exact LEI for identity or parent research.
Prompts to try with GLEIF company search in Codex
Copy an example into Codex, or ask in your own words.
Use GLEIF company search to find Siemens AG in Germany, then add the candidate legal names, LEIs, and registered addresses to my project's company-matching fixture.
Use GLEIF company search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from GLEIF company search and tell me what changed since last week.
Check GLEIF company search and summarize what you find in three bullet points.
Pull the newest data from GLEIF company search and give me the result as a table.
How to set up GLEIF company search in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run GLEIF company search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "gleif-org/entities/search", "input": { "name": "<name>" } }'
Then paste one of the prompts above: Codex finds GLEIF company search on Spiral, shows the price and runs it.
GLEIF company search providers and prices
Spiral runs GLEIF company search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 1000 | 1 | page |
| Limit | 1 to 100 | 20 | limit |
Every API field of GLEIF · Search is on its tool page: open its card above.
What can you do with GLEIF company search in Codex?
Build a company reference table and reported consolidation chart inside your project. A coding agent can join LEI identities to parent and child relationships while keeping reporting exceptions visible.
Maintain corporate account structures
Resolve customer company names, review their LEI records, and connect reported direct and ultimate parents and children. Use relationship files for larger account portfolios and publication checks and deltas to maintain the results.
Review supplier concentration
Match supplier names to legal entities and examine which suppliers share a reported ultimate consolidator. Check the consolidator's reported children, inspect direct links, and maintain a portfolio relationship dataset as new publications appear.
Prepare counterparty research briefs
Identify the contracting legal entity and summarize its reported consolidation structure. Combine individual identity and relationship lookups with a maintained relationship dataset when preparing briefs for many counterparties.
Review reported corporate restructuring
Compare maintained LEI identities and consolidation links with newly published records. Review affected parents and children to identify changes that warrant investigation, while retaining reporting exceptions.
Resolve ambiguous company names
Compare candidate LEIs using registered names, addresses, and country of formation before attaching an identifier to a customer or supplier record.
More on GLEIF company search and Codex
Overview
GLEIF company search in other agents
Questions about GLEIF company search in Codex
Can Codex use GLEIF company search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run GLEIF company search like any built-in tool.
How much does GLEIF company search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use GLEIF company search in Codex?
No. Spiral runs GLEIF company search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up GLEIF company search in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while GLEIF company search runs?
GLEIF company search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
Does GLEIF cover every company?
GLEIF covers entities identifiable with an LEI. The Global LEI Index contains historical and current LEI records, so it should not be treated as a census of every registered business.
How often does GLEIF publish updated files?
Golden Copy files are published three times daily, at 02:00, 10:00, and 18:00 UTC. That publication schedule is different from the annual revalidation of an entity's reference data.
Does a parent link identify the beneficial owner?
GLEIF's direct and ultimate parent links use accounting consolidation. The direct parent is the lowest consolidating entity, while the ultimate parent is the highest consolidating entity.
Why can parent information be missing?
GLEIF records reporting exceptions for situations such as a parent without an LEI or exceptional non-disclosure. Its relationship records cover parents with LEIs, so an absent link does not prove that an entity has no parent.
What period do change files cover?
GLEIF supplies delta windows of eight hours, 24 hours, seven days, and 31 days. The files contain the latest versions of changed records, so they do not preserve every intermediate edit.
Start using GLEIF company search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


