[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [GLEIF relationship records](https://spiral.ai/integrations/instinct/gleif-relationship-records)

# How to Use GLEIF relationship records in Instinct

Returns the current Golden Copy relationship records across the LEI population. Use it to build a corporate relationship dataset across many entities instead of looking up one parent's reported children.

|  |  |
| --- | --- |
| Model | GLEIF relationship records |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with GLEIF relationship records in Instinct

- Each month, use GLEIF relationship records to refresh the global consolidation dataset and summarize differences from the previous retrieved dataset.
- Every Monday at 9am: use GLEIF relationship records to look this up and give me the result as a table.
- Pull the latest numbers from GLEIF relationship records and tell me what changed since last week.
- Check GLEIF relationship records and summarize what you find in three bullet points.
- Pull the newest data from GLEIF relationship records and give me the result as a table.

## How to set up GLEIF relationship records in Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GLEIF relationship records**: One request; the result comes back by polling or a webhook.

```bash
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/records_list",
    "input": {
      "cursor": "<cursor>"
    }
  }'
```

Then paste one of the prompts above: Instinct finds GLEIF relationship records on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## GLEIF relationship records tools and prices

- [GLEIF · Records list](https://spiral.ai/tools/alexandria/gleif-org/entities/records_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Opaque continuation from the previous page (pins publication, file, ETag and row offset). |
| filetype | rr | rr | Only rr (Level 2) fits; lei2 and repex full copies are hand-offs from source_status. |
| page_size | 1 to 5000 | 200 | page_size |
| publication_id |  | — | Pin an explicit publication (YYYYMMDD-HHMM, e.g. 20261017-1600). Default: latest. Pattern: ^[0-9]{8}-[0-9]{4}$. |

## What can you do with GLEIF relationship records in Instinct?

Keep a corporate reference dataset aligned with new GLEIF publications. A scheduled agent can check publication status, refresh changed records, and review changes to reported consolidation links.

### 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.

### Build a consolidation chart

Draw the reported direct-parent structure and show ultimate-consolidator associations separately. Include the reported children and label gaps caused by reporting exceptions.

### Refresh a relationship database

Start with current relationship records, check for new Golden Copy publications, and apply subsequent deltas. Use the latest changed records to update stored relationships.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## GLEIF relationship records in other agents

- [Amp](https://spiral.ai/integrations/amp/gleif-relationship-records)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gleif-relationship-records)
- [Claude](https://spiral.ai/integrations/claude-desktop/gleif-relationship-records)
- [Claude Code](https://spiral.ai/integrations/claude-code/gleif-relationship-records)
- [Cline](https://spiral.ai/integrations/cline/gleif-relationship-records)
- [Codex](https://spiral.ai/integrations/codex/gleif-relationship-records)
- [Cursor](https://spiral.ai/integrations/cursor/gleif-relationship-records)
- [Devin](https://spiral.ai/integrations/devin/gleif-relationship-records)
- [dots](https://spiral.ai/integrations/dots/gleif-relationship-records)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gleif-relationship-records)
- [Gemini](https://spiral.ai/integrations/gemini/gleif-relationship-records)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/gleif-relationship-records)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gleif-relationship-records)
- [goose](https://spiral.ai/integrations/goose/gleif-relationship-records)
- [Grok](https://spiral.ai/integrations/grok/gleif-relationship-records)
- [Grok Build](https://spiral.ai/integrations/grok-build/gleif-relationship-records)
- [Hermes](https://spiral.ai/integrations/hermes/gleif-relationship-records)
- [Manus](https://spiral.ai/integrations/manus/gleif-relationship-records)
- [Muse](https://spiral.ai/integrations/muse/gleif-relationship-records)
- [Muse Code](https://spiral.ai/integrations/muse-code/gleif-relationship-records)
- [n8n](https://spiral.ai/integrations/n8n/gleif-relationship-records)
- [Notion](https://spiral.ai/integrations/notion/gleif-relationship-records)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gleif-relationship-records)
- [opencode](https://spiral.ai/integrations/opencode/gleif-relationship-records)
- [Perplexity](https://spiral.ai/integrations/perplexity/gleif-relationship-records)
- [Raycast](https://spiral.ai/integrations/raycast/gleif-relationship-records)
- [VS Code](https://spiral.ai/integrations/vscode/gleif-relationship-records)
- [Windsurf](https://spiral.ai/integrations/windsurf/gleif-relationship-records)
- [Zapier](https://spiral.ai/integrations/zapier/gleif-relationship-records)

## More Instinct guides

- [GLEIF legal entity profile](https://spiral.ai/integrations/instinct/gleif-legal-entity-profile)
- [GLEIF ultimate parent](https://spiral.ai/integrations/instinct/gleif-ultimate-parent)
- [GLEIF direct subsidiaries](https://spiral.ai/integrations/instinct/gleif-direct-subsidiaries)
- [GLEIF ultimate subsidiaries](https://spiral.ai/integrations/instinct/gleif-ultimate-subsidiaries)
- [GLEIF direct parent](https://spiral.ai/integrations/instinct/gleif-direct-parent)
- [Georgia business details](https://spiral.ai/integrations/instinct/georgia-business-details)

## Questions about GLEIF relationship records in Instinct

**Can Instinct use GLEIF relationship records?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run GLEIF relationship records like any built-in tool.

**How much does GLEIF relationship records cost in Instinct?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use GLEIF relationship records in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs GLEIF relationship records on its own Alexandria account.

**How long does it take to set up GLEIF relationship records in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while GLEIF relationship records runs?**

GLEIF relationship records runs in the background. Instinct 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.

