---
type: "firecrawl-provider"
description: "Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children. Preserves reporting exceptions."
use_when: "Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children. Preserves reporting exceptions."
categories: "Public records"
capabilities: 6
credits_per_call: 5
---
# GLEIF on Firecrawl Alexandria

Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children. Preserves reporting exceptions.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `gleif-org`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/gleif-org)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/gleif-org/openapi.json)

## Capabilities

- [Direct children](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/direct_children): Page through reported direct accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- [Direct parent](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/direct_parent): Retrieve the reported direct accounting-consolidating parent, or its reporting-exception record and reason. This is not a complete beneficial-ownership graph.
- [Entity](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/entity): Resolve an exact 20-character LEI to source identity, registration, mapped identifiers and relationship links. Unknown LEIs fail as upstream not-found, not an empty success.
- [Search](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/search): Search global registered entities by name: current legal name, previous legal and other names, and ASCII-transliterated names, with optional legal-address country. Commas in the name are folded into spaces (GLEIF reads them as OR separators). Page through matching LEIs; name matches are candidates, not guaranteed identity equivalence.
- [Ultimate children](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/ultimate_children): Page through reported ultimate accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- [Ultimate parent](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/ultimate_parent): Retrieve the reported ultimate accounting-consolidating parent, or its reporting-exception record and reason. Preserve exceptions rather than claiming there is no parent.

## 1. Choose this provider when

Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children. Preserves reporting exceptions.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "gleif-org",
  "capability": "entities/direct_children",
  "options": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "limit": 2
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`
- `limit` (number): limit Example: `20`
- `page` (number): page Example: `1`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "gleif-org",
    capability: "entities/direct_children",
    options: {
      lei: "HWUPKR0MPOU8FGXBT394",
      limit: 2,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "gleif-org",
  "capability": "entities/direct_children",
  "options": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "limit": 2
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "gleif-org",
    "capability": "entities/direct_children",
    "options": {
      "lei": "HWUPKR0MPOU8FGXBT394",
      "limit": 2
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'gleif-org/entities/direct_children' \
  --options '{"lei":"HWUPKR0MPOU8FGXBT394","limit":2}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "gleif-org",
  "capability": "entities/direct_children",
  "options": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "limit": 2
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "gleif-org",
  "capability": "entities/direct_children",
  "options": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "limit": 2
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children?page%5Bnumber%5D=2&page%5Bsize%5D=2",
  "observed_at_ms": 1789508186710,
  "pagination": {
    "currentPage": 1,
    "from": 1,
    "lastPage": 4,
    "perPage": 2,
    "to": 2,
    "total": 8
  },
  "records": [
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2023-05-10T12:00:00Z",
          "eventGroups": [
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_LEGAL_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            },
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_HQ_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            }
          ],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "jurisdiction": "IN",
          "legalAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "legalForm": {
            "id": "YSP9",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "APPLE OPERATIONS INDIA PRIVATE LIMITED"
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Operations India Pvt. Ltd.",
              "type": "TRADING_OR_OPERATING_NAME"
            }
          ],
          "registeredAs": "U72100KA2023PTC173466",
          "registeredAt": {
            "id": "RA000394",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "2549008YU9EOMHFUA249",
        "mic": null,
        "ocid": null,
        "qcc": "QIN6Y5HW6U",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2023-08-25T14:07:19Z",
          "lastUpdateDate": "2026-05-19T07:01:11Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-05-25T14:07:19Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "U72100KA2023PTC173466",
          "validatedAt": {
            "id": "RA000394",
            "other": null
          }
        },
        "spglobal": [
          "1853971159"
        ]
      },
      "id": "2549008YU9EOMHFUA249",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    },
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2012-03-30T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "Cerro El Plomo 5630",
              "Torre 8 Piso 20",
              "Las Condes"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Santiago",
            "country": "CL",
            "language": "en",
            "mailRouting": null,
            "postalCode": "7560742",
            "region": "CL-RM"
          },
          "jurisdiction": "CL",
          "legalAddress": {
            "addressLines": [
              "Cerro El Plomo 5630",
              "Torre 8 Piso 20",
              "Las Condes"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Santiago",
            "country": "CL",
            "language": "en",
            "mailRouting": null,
            "postalCode": "7560742",
            "region": "CL-RM"
          },
          "legalForm": {
            "id": "CVDP",
            "other": null
          },
          "legalName": {
            "language": "es",
            "name": "APPLE CHILE COMERCIAL LIMITADA"
          },
          "otherAddresses": [],
          "otherNames": [],
          "registeredAs": "76.203.916-8",
          "registeredAt": {
            "id": "RA000091",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "5493004QI6E3PJNCEB09",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2019-12-26T15:31:00Z",
          "lastUpdateDate": "2026-03-03T16:34:34Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:20:49Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "76.203.916-8",
          "validatedAt": {
            "id": "RA000091",
            "other": null
          }
        },
        "spglobal": [
          "649322987"
        ]
      },
      "id": "5493004QI6E3PJNCEB09",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children?page%5Bnumber%5D=1&page%5Bsize%5D=2"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Direct children

- Capability: `entities/direct_children`
- Description: Page through reported direct accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- Instructions: Page through reported direct accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- Cost: 5 credits per call
- Capability file: [Direct children](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/direct_children)

Accepted options:
- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`
- `limit` (number): limit Example: `20`
- `page` (number): page Example: `1`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children?page%5Bnumber%5D=2&page%5Bsize%5D=2",
  "observed_at_ms": 1789508186710,
  "pagination": {
    "currentPage": 1,
    "from": 1,
    "lastPage": 4,
    "perPage": 2,
    "to": 2,
    "total": 8
  },
  "records": [
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2023-05-10T12:00:00Z",
          "eventGroups": [
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_LEGAL_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            },
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_HQ_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            }
          ],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "jurisdiction": "IN",
          "legalAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "legalForm": {
            "id": "YSP9",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "APPLE OPERATIONS INDIA PRIVATE LIMITED"
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Operations India Pvt. Ltd.",
              "type": "TRADING_OR_OPERATING_NAME"
            }
          ],
          "registeredAs": "U72100KA2023PTC173466",
          "registeredAt": {
            "id": "RA000394",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "2549008YU9EOMHFUA249",
        "mic": null,
        "ocid": null,
        "qcc": "QIN6Y5HW6U",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2023-08-25T14:07:19Z",
          "lastUpdateDate": "2026-05-19T07:01:11Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-05-25T14:07:19Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "U72100KA2023PTC173466",
          "validatedAt": {
            "id": "RA000394",
            "other": null
          }
        },
        "spglobal": [
          "1853971159"
        ]
      },
      "id": "2549008YU9EOMHFUA249",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    },
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2012-03-30T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "Cerro El Plomo 5630",
              "Torre 8 Piso 20",
              "Las Condes"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Santiago",
            "country": "CL",
            "language": "en",
            "mailRouting": null,
            "postalCode": "7560742",
            "region": "CL-RM"
          },
          "jurisdiction": "CL",
          "legalAddress": {
            "addressLines": [
              "Cerro El Plomo 5630",
              "Torre 8 Piso 20",
              "Las Condes"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Santiago",
            "country": "CL",
            "language": "en",
            "mailRouting": null,
            "postalCode": "7560742",
            "region": "CL-RM"
          },
          "legalForm": {
            "id": "CVDP",
            "other": null
          },
          "legalName": {
            "language": "es",
            "name": "APPLE CHILE COMERCIAL LIMITADA"
          },
          "otherAddresses": [],
          "otherNames": [],
          "registeredAs": "76.203.916-8",
          "registeredAt": {
            "id": "RA000091",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "5493004QI6E3PJNCEB09",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2019-12-26T15:31:00Z",
          "lastUpdateDate": "2026-03-03T16:34:34Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:20:49Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "76.203.916-8",
          "validatedAt": {
            "id": "RA000091",
            "other": null
          }
        },
        "spglobal": [
          "649322987"
        ]
      },
      "id": "5493004QI6E3PJNCEB09",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/5493004QI6E3PJNCEB09/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children?page%5Bnumber%5D=1&page%5Bsize%5D=2"
}
```

### Direct parent

- Capability: `entities/direct_parent`
- Description: Retrieve the reported direct accounting-consolidating parent, or its reporting-exception record and reason. This is not a complete beneficial-ownership graph.
- Instructions: Retrieve the reported direct accounting-consolidating parent, or its reporting-exception record and reason. This is not a complete beneficial-ownership graph.
- Cost: 5 credits per call
- Capability file: [Direct parent](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/direct_parent)

Accepted options:
- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": null,
  "observed_at_ms": 1789508186710,
  "pagination": null,
  "records": [
    {
      "attributes": {
        "bic": [
          "APLEUS66XXX"
        ],
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "1977-01-03T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "One Apple Park Way"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Cupertino",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "95014",
            "region": "US-CA"
          },
          "jurisdiction": "US-CA",
          "legalAddress": {
            "addressLines": [
              "C/O C T Corporation System",
              "330 N. Brand Blvd",
              "Suite 700"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Glendale",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "91203",
            "region": "US-CA"
          },
          "legalForm": {
            "id": "H1UM",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "Apple Inc."
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Computer, Inc.",
              "type": "PREVIOUS_LEGAL_NAME"
            }
          ],
          "registeredAs": "806592",
          "registeredAt": {
            "id": "RA000598",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "HWUPKR0MPOU8FGXBT394",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2012-06-06T15:53:00Z",
          "lastUpdateDate": "2026-03-03T16:34:33Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:27:20Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "806592",
          "validatedAt": {
            "id": "RA000598",
            "other": null
          }
        },
        "spglobal": [
          "24937"
        ]
      },
      "id": "HWUPKR0MPOU8FGXBT394",
      "relationships": {
        "direct-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-child-relationships"
          }
        },
        "direct-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-parent-reporting-exception"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/field-modifications"
          }
        },
        "isins": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/isins"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/managing-lou"
          }
        },
        "ultimate-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-child-relationships"
          }
        },
        "ultimate-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-parent-reporting-exception"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent"
}
```

### Entity

- Capability: `entities/entity`
- Description: Resolve an exact 20-character LEI to source identity, registration, mapped identifiers and relationship links. Unknown LEIs fail as upstream not-found, not an empty success.
- Instructions: Resolve an exact 20-character LEI to source identity, registration, mapped identifiers and relationship links. Unknown LEIs fail as upstream not-found, not an empty success.
- Cost: 5 credits per call
- Capability file: [Entity](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/entity)

Accepted options:
- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": null,
  "observed_at_ms": 1789508186710,
  "pagination": null,
  "records": [
    {
      "attributes": {
        "bic": [
          "APLEUS66XXX"
        ],
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "1977-01-03T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "One Apple Park Way"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Cupertino",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "95014",
            "region": "US-CA"
          },
          "jurisdiction": "US-CA",
          "legalAddress": {
            "addressLines": [
              "C/O C T Corporation System",
              "330 N. Brand Blvd",
              "Suite 700"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Glendale",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "91203",
            "region": "US-CA"
          },
          "legalForm": {
            "id": "H1UM",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "Apple Inc."
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Computer, Inc.",
              "type": "PREVIOUS_LEGAL_NAME"
            }
          ],
          "registeredAs": "806592",
          "registeredAt": {
            "id": "RA000598",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "HWUPKR0MPOU8FGXBT394",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2012-06-06T15:53:00Z",
          "lastUpdateDate": "2026-03-03T16:34:33Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:27:20Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "806592",
          "validatedAt": {
            "id": "RA000598",
            "other": null
          }
        },
        "spglobal": [
          "24937"
        ]
      },
      "id": "HWUPKR0MPOU8FGXBT394",
      "relationships": {
        "direct-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-child-relationships"
          }
        },
        "direct-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-parent-reporting-exception"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/field-modifications"
          }
        },
        "isins": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/isins"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/managing-lou"
          }
        },
        "ultimate-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-child-relationships"
          }
        },
        "ultimate-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-parent-reporting-exception"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394"
}
```

### Search

- Capability: `entities/search`
- Description: Search global registered entities by name: current legal name, previous legal and other names, and ASCII-transliterated names, with optional legal-address country. Commas in the name are folded into spaces (GLEIF reads them as OR separators). Page through matching LEIs; name matches are candidates, not guaranteed identity equivalence.
- Instructions: Search global registered entities by name: current legal name, previous legal and other names, and ASCII-transliterated names, with optional legal-address country. Commas in the name are folded into spaces (GLEIF reads them as OR separators). Page through matching LEIs; name matches are candidates, not guaranteed identity equivalence.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/search)

Accepted options:
- `country` (string): Pattern: ^[A-Z]{2}$. Example: `<country>`
- `limit` (number): limit Example: `20`
- `name` (string, required): name Example: `<name>`
- `page` (number): page Example: `1`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-26T08:00:00Z",
  "next_url": "https://api.gleif.org/api/v1/lei-records?filter%5Bentity.names%5D=Apple&page%5Bnumber%5D=2&page%5Bsize%5D=2",
  "observed_at_ms": 1790455858130,
  "pagination": {
    "currentPage": 1,
    "from": 1,
    "lastPage": 198,
    "perPage": 2,
    "to": 2,
    "total": 396
  },
  "records": [
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2010-12-08T00:00:00Z",
          "eventGroups": [
            {
              "events": [
                {
                  "effectiveDate": "2010-08-12T00:00:00Z",
                  "recordedDate": "2026-03-02T00:00:00Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_LEGAL_NAME",
                  "validationDocuments": "SUPPORTING_DOCUMENTS"
                }
              ],
              "groupType": "STANDALONE"
            }
          ],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "HOLLYHILL INDUSTRIAL ESTATE",
              "HOLLYHILL"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "CORK",
            "country": "IE",
            "language": "en",
            "mailRouting": null,
            "postalCode": "T23 YK84",
            "region": "IE-CO"
          },
          "jurisdiction": "IE",
          "legalAddress": {
            "addressLines": [
              "HOLLYHILL INDUSTRIAL ESTATE",
              "HOLLYHILL"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "CORK",
            "country": "IE",
            "language": "en",
            "mailRouting": null,
            "postalCode": "T23 YK84",
            "region": "IE-CO"
          },
          "legalForm": {
            "id": "MNQ7",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "APPLE OPERATIONS LIMITED"
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "APPLE OPERATIONS",
              "type": "PREVIOUS_LEGAL_NAME"
            }
          ],
          "registeredAs": "492405",
          "registeredAt": {
            "id": "RA000402",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "549300MGN03W4U2NK749",
        "mic": null,
        "ocid": "ie/492405",
        "qcc": "QIEEWJB42A",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2014-02-07T01:33:00Z",
          "lastUpdateDate": "2026-03-03T16:34:34Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:20:49Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "492405",
          "validatedAt": {
            "id": "RA000402",
            "other": null
          }
        },
        "spglobal": [
          "549863809"
        ]
      },
      "id": "549300MGN03W4U2NK749",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/549300MGN03W4U2NK749/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    },
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "NON_CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2014-09-26T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "11/2, GROUND FIRST FLOOR, K R ROAD",
              "BESIDE BASAVANAGUDI POST OFFICE"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bengaluru",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560004",
            "region": "IN-KA"
          },
          "jurisdiction": "IN",
          "legalAddress": {
            "addressLines": [
              "NO. 615, 100 FEET RING ROAD",
              "BSK 3RD STAGE"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "BANGALORE",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560085",
            "region": "IN-KA"
          },
          "legalForm": {
            "id": "U5S6",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "APPLE SPIRE INDIA LLP"
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "APPLE SPIRE",
              "type": "TRADING_OR_OPERATING_NAME"
            }
          ],
          "registeredAs": "AAC-7595",
          "registeredAt": {
            "id": "RA000394",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "9845007873AC3C138764",
        "mic": null,
        "ocid": null,
        "qcc": "QIN9MSVN4W",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2023-02-27T06:50:21Z",
          "lastUpdateDate": "2024-02-27T07:54:39Z",
          "managingLou": "529900T8BM49AURSDO55",
          "nextRenewalDate": "2024-02-27T06:55:19Z",
          "otherValidationAuthorities": [
            {
              "validatedAs": "29AAYFA6776D1ZR",
              "validatedAt": {
                "id": "RA000754"
              }
            }
          ],
          "status": "LAPSED",
          "validatedAs": "AAC-7595",
          "validatedAt": {
            "id": "RA000394",
            "other": null
          }
        },
        "spglobal": [
          "1827775648"
        ]
      },
      "id": "9845007873AC3C138764",
      "relationships": {
        "direct-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/9845007873AC3C138764/direct-parent-reporting-exception"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/9845007873AC3C138764/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/9845007873AC3C138764/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/9845007873AC3C138764/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/9845007873AC3C138764/ultimate-parent-reporting-exception"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records?filter%5Bentity.names%5D=Apple&page%5Bnumber%5D=1&page%5Bsize%5D=2"
}
```

### Ultimate children

- Capability: `entities/ultimate_children`
- Description: Page through reported ultimate accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- Instructions: Page through reported ultimate accounting-consolidated children for an LEI. This excludes unreported ownership relationships.
- Cost: 5 credits per call
- Capability file: [Ultimate children](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/ultimate_children)

Accepted options:
- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`
- `limit` (number): limit Example: `20`
- `page` (number): page Example: `1`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-children?page%5Bnumber%5D=2&page%5Bsize%5D=2",
  "observed_at_ms": 1789508186710,
  "pagination": {
    "currentPage": 1,
    "from": 1,
    "lastPage": 10,
    "perPage": 2,
    "to": 2,
    "total": 20
  },
  "records": [
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2026-04-10T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "13th Floor, Concorde Tower C",
              "No. 24, Vittal Mallya Road",
              "Mahatma Gandhi Road",
              "Bangalore North"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bengaluru",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560001",
            "region": "IN-KA"
          },
          "jurisdiction": "IN",
          "legalAddress": {
            "addressLines": [
              "13th Floor, Concorde Tower C",
              "No. 24, Vittal Mallya Road",
              "Mahatma Gandhi Road",
              "Bangalore North"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bengaluru",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560001",
            "region": "IN-KA"
          },
          "legalForm": {
            "id": "YSP9",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "Apple Technology Services India Private Limited"
          },
          "otherAddresses": [],
          "otherNames": [],
          "registeredAs": "U62099KA2026FTC219177",
          "registeredAt": {
            "id": "RA000394",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "2549005JJKRFXSM5CC84",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2026-06-04T13:26:57Z",
          "lastUpdateDate": "2026-06-04T13:37:41Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-06-04T13:26:57Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "U62099KA2026FTC219177",
          "validatedAt": {
            "id": "RA000394",
            "other": null
          }
        },
        "spglobal": [
          "2003524511"
        ]
      },
      "id": "2549005JJKRFXSM5CC84",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549005JJKRFXSM5CC84/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    },
    {
      "attributes": {
        "bic": null,
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "2023-05-10T12:00:00Z",
          "eventGroups": [
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_LEGAL_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            },
            {
              "events": [
                {
                  "effectiveDate": "2023-12-15T00:00:00Z",
                  "recordedDate": "2024-07-15T16:44:12Z",
                  "status": "COMPLETED",
                  "type": "CHANGE_HQ_ADDRESS",
                  "validationDocuments": "REGULATORY_FILING"
                }
              ],
              "groupType": "STANDALONE"
            }
          ],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "jurisdiction": "IN",
          "legalAddress": {
            "addressLines": [
              "Ground Floor of Tower B, PrimeCo Union City",
              "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87",
              "Sadarmangala Industrial Area",
              "Krishnarajapuram Hobli, Kadugodi"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Bangalore",
            "country": "IN",
            "language": "en",
            "mailRouting": null,
            "postalCode": "560067",
            "region": "IN-KA"
          },
          "legalForm": {
            "id": "YSP9",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "APPLE OPERATIONS INDIA PRIVATE LIMITED"
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Operations India Pvt. Ltd.",
              "type": "TRADING_OR_OPERATING_NAME"
            }
          ],
          "registeredAs": "U72100KA2023PTC173466",
          "registeredAt": {
            "id": "RA000394",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "2549008YU9EOMHFUA249",
        "mic": null,
        "ocid": null,
        "qcc": "QIN6Y5HW6U",
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2023-08-25T14:07:19Z",
          "lastUpdateDate": "2026-05-19T07:01:11Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-05-25T14:07:19Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "U72100KA2023PTC173466",
          "validatedAt": {
            "id": "RA000394",
            "other": null
          }
        },
        "spglobal": [
          "1853971159"
        ]
      },
      "id": "2549008YU9EOMHFUA249",
      "relationships": {
        "direct-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent-relationship"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/field-modifications"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/managing-lou"
          }
        },
        "ultimate-parent": {
          "links": {
            "lei-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent",
            "relationship-record": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent-relationship"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-children?page%5Bnumber%5D=1&page%5Bsize%5D=2"
}
```

### Ultimate parent

- Capability: `entities/ultimate_parent`
- Description: Retrieve the reported ultimate accounting-consolidating parent, or its reporting-exception record and reason. Preserve exceptions rather than claiming there is no parent.
- Instructions: Retrieve the reported ultimate accounting-consolidating parent, or its reporting-exception record and reason. Preserve exceptions rather than claiming there is no parent.
- Cost: 5 credits per call
- Capability file: [Ultimate parent](https://firecrawl.dev/alexandria/agents/providers/gleif-org/entities/ultimate_parent)

Accepted options:
- `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `<lei>`

Response schema example:
```json
{
  "golden_copy_published_at": "2026-09-15T08:00:00Z",
  "next_url": null,
  "observed_at_ms": 1789508186710,
  "pagination": null,
  "records": [
    {
      "attributes": {
        "bic": [
          "APLEUS66XXX"
        ],
        "conformityFlag": "CONFORMING",
        "entity": {
          "associatedEntity": {
            "lei": null,
            "name": null
          },
          "category": "GENERAL",
          "creationDate": "1977-01-03T00:00:00Z",
          "eventGroups": [],
          "expiration": {
            "date": null,
            "reason": null
          },
          "headquartersAddress": {
            "addressLines": [
              "One Apple Park Way"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Cupertino",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "95014",
            "region": "US-CA"
          },
          "jurisdiction": "US-CA",
          "legalAddress": {
            "addressLines": [
              "C/O C T Corporation System",
              "330 N. Brand Blvd",
              "Suite 700"
            ],
            "addressNumber": null,
            "addressNumberWithinBuilding": null,
            "city": "Glendale",
            "country": "US",
            "language": "en",
            "mailRouting": null,
            "postalCode": "91203",
            "region": "US-CA"
          },
          "legalForm": {
            "id": "H1UM",
            "other": null
          },
          "legalName": {
            "language": "en",
            "name": "Apple Inc."
          },
          "otherAddresses": [],
          "otherNames": [
            {
              "language": "en",
              "name": "Apple Computer, Inc.",
              "type": "PREVIOUS_LEGAL_NAME"
            }
          ],
          "registeredAs": "806592",
          "registeredAt": {
            "id": "RA000598",
            "other": null
          },
          "status": "ACTIVE",
          "subCategory": null,
          "successorEntities": [],
          "successorEntity": {
            "lei": null,
            "name": null
          },
          "transliteratedOtherNames": []
        },
        "gem": null,
        "lei": "HWUPKR0MPOU8FGXBT394",
        "mic": null,
        "ocid": null,
        "qcc": null,
        "registration": {
          "corroborationLevel": "FULLY_CORROBORATED",
          "initialRegistrationDate": "2012-06-06T15:53:00Z",
          "lastUpdateDate": "2026-03-03T16:34:33Z",
          "managingLou": "5493001KJTIIGC8Y1R12",
          "nextRenewalDate": "2027-03-08T17:27:20Z",
          "otherValidationAuthorities": [],
          "status": "ISSUED",
          "validatedAs": "806592",
          "validatedAt": {
            "id": "RA000598",
            "other": null
          }
        },
        "spglobal": [
          "24937"
        ]
      },
      "id": "HWUPKR0MPOU8FGXBT394",
      "relationships": {
        "direct-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-child-relationships"
          }
        },
        "direct-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/direct-parent-reporting-exception"
          }
        },
        "field-modifications": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/field-modifications"
          }
        },
        "isins": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/isins"
          }
        },
        "lei-issuer": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/lei-issuer"
          }
        },
        "managing-lou": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/managing-lou"
          }
        },
        "ultimate-children": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-children",
            "relationship-records": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-child-relationships"
          }
        },
        "ultimate-parent": {
          "links": {
            "reporting-exception": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394/ultimate-parent-reporting-exception"
          }
        }
      },
      "type": "lei-records"
    }
  ],
  "scope": "Global registered LEIs. Parent/child links describe reported accounting consolidation, not every ownership relationship. Reporting exceptions preserve their source reasons.",
  "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent"
}
```
