# GLEIF API: Get legal entity

> Looks up the official LEI record for a company name or LEI, optionally narrowing namesakes by registered country. Prefers active records with the closest name.

Unofficial. Not affiliated with or endorsed by GLEIF.

- Page: https://fous.com/methods/gleif.org/get-legal-entity
- Method: `gleif.org/get_legal_entity`, version 1
- Website: gleif.org
- Returns: legal name, LEI, status, addresses, country, legal form, registration authority, registration dates, parents, other names
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Apple Inc."` | Company legal name or 20-character LEI, for example Siemens AG or HWUPKR0MPOU8FGXBT394. |
| `country` | string | no |  | Registered country name or two-letter code, for example Germany or DE. Default "". |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "company": "Apple Inc."
}
```

Its output:

```json
{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "link": "https://search.gleif.org/#/record/HWUPKR0MPOU8FGXBT394",
  "country": "United States of America",
  "legal_form": "For-Profit Corporation General Stock",
  "legal_name": "Apple Inc.",
  "other_names": [
    "Apple Computer, Inc."
  ],
  "direct_parent": null,
  "entity_status": "Active",
  "legal_address": "C/O C T Corporation System, 330 N. Brand Blvd, Suite 700, Glendale, CA, 91203, United States of America",
  "ultimate_parent": null,
  "next_renewal_date": "2027-03-08",
  "headquarters_address": "One Apple Park Way, Cupertino, CA, 95014, United States of America",
  "registration_authority": "Secretary of State — Business Entity Records",
  "lei_registration_status": "Issued",
  "initial_registration_date": "2012-06-06",
  "local_registration_number": "806592"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"gleif.org/get_legal_entity","input":{"company":"Apple Inc."}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find the official LEI record for Siemens AG registered in Germany
- What is the legal entity identifier for Toyota Motor Corporation?
- Look up the LEI 5493001KJTIIGC8Y1R12 and show its registration status and addresses
- Get the registered legal form and registration authority for Nestle SA based in CH
- Which companies named Acme Holdings are registered in the US, and what are their LEI records?

## Input schema

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company legal name or 20-character LEI, for example Siemens AG or HWUPKR0MPOU8FGXBT394."
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Registered country name or two-letter code, for example Germany or DE."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "legal_name",
    "lei",
    "entity_status",
    "lei_registration_status",
    "legal_address",
    "headquarters_address",
    "country",
    "legal_form",
    "registration_authority",
    "local_registration_number",
    "initial_registration_date",
    "next_renewal_date",
    "direct_parent",
    "ultimate_parent",
    "other_names",
    "link"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "Legal Entity Identifier."
    },
    "link": {
      "type": "string",
      "description": "Record on GLEIF public search."
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Registered country name."
    },
    "legal_form": {
      "type": [
        "string",
        "null"
      ],
      "description": "Legal form name."
    },
    "legal_name": {
      "type": "string",
      "description": "Official registered name."
    },
    "other_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other reported names."
    },
    "direct_parent": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "name",
        "lei"
      ],
      "properties": {
        "lei": {
          "type": [
            "string",
            "null"
          ],
          "description": "Parent LEI."
        },
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Parent legal name."
        }
      },
      "description": "Reported direct parent; null if none reported.",
      "additionalProperties": false
    },
    "entity_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Legal entity status in words."
    },
    "legal_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Single-line registered legal address."
    },
    "ultimate_parent": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "name",
        "lei"
      ],
      "properties": {
        "lei": {
          "type": [
            "string",
            "null"
          ],
          "description": "Parent LEI."
        },
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "Parent legal name."
        }
      },
      "description": "Reported ultimate parent; null if none reported.",
      "additionalProperties": false
    },
    "next_renewal_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Next LEI renewal date (YYYY-MM-DD)."
    },
    "headquarters_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Single-line headquarters address."
    },
    "registration_authority": {
      "type": [
        "string",
        "null"
      ],
      "description": "Name of the registering authority."
    },
    "lei_registration_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "LEI registration status in words."
    },
    "initial_registration_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date the LEI was first registered (YYYY-MM-DD)."
    },
    "local_registration_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local business registration number."
    }
  },
  "additionalProperties": false
}
```

## See more

- [GLEIF API: Get corporate parents](https://fous.com/methods/gleif.org/get-corporate-parents.md): Finds a company's reported direct and ultimate accounting-consolidation parents, the reasons parents are not reported, and direct children in the GLEIF LEI system.
- [data.gouv.fr API: Get French company](https://fous.com/methods/annuaire-entreprises.data.gouv.fr/get-company.md): Looks up a French company by name, SIREN or SIRET and returns its registration, directors and latest public financial figures. Financial figures are null when not published; a city or postcode helps pick the right namesake.
- [Companies House API: Get UK company profile](https://fous.com/methods/company-information.service.gov.uk/get-company-profile.md): Looks up a UK company on Companies House by name, company number or Companies House link and returns its public registration details; a name prefers an active exact match.
- [Companies House API: Search companies](https://fous.com/methods/find-and-update.company-information.service.gov.uk/search-companies.md): Searches the UK Companies House register by company name and returns each company's status, type, incorporation date and registered office address, in result order.
- [North Data API: Get company profile](https://fous.com/methods/northdata.com/get-company-profile.md): Looks up a company on North Data by name, optionally narrowed by country or city, and returns its identification, address, people and register events.
- [LinkedIn API: Get company profile](https://fous.com/methods/linkedin.com/get-company-profile.md): Gets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null.
- [SEC EDGAR API: List company SEC filings](https://fous.com/methods/sec.gov/get-company-filings.md): Finds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date.
- [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.
- [All GLEIF methods](https://fous.com/methods/gleif.org.md)