--- type: "firecrawl-provider" description: "Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children, plus the GLEIF Golden Copy collection contract: publication status, Level 1/Level 2/reporting-exception delta files, the paginated Level 2 (rr) full copy pinned to one publication, and one LEI mapped onto CDF field names." use_when: "Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children, plus the GLEIF Golden Copy collection contract: publication status, Level 1/Level 2/reporting-exception delta files, the paginated Level 2 (rr) full copy pinned to one publication, and one LEI mapped onto CDF field names." categories: "Public records" capabilities: 10 credits_per_call: 5 --- # GLEIF on Firecrawl Alexandria Global LEI search, identity and reported direct/ultimate accounting-consolidation parents and children, plus the GLEIF Golden Copy collection contract: publication status, Level 1/Level 2/reporting-exception delta files, the paginated Level 2 (rr) full copy pinned to one publication, and one LEI mapped onto CDF field names. - Categories: Public records - Category index: [Public records category](https://alexandria.firecrawl.dev/agents/categories/public-records) - Provider key: `gleif-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/gleif-org) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/gleif-org/openapi.json) ## Capabilities - [Direct children](https://alexandria.firecrawl.dev/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://alexandria.firecrawl.dev/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://alexandria.firecrawl.dev/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. - [Records changes](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_changes): Rows of one Golden Copy delta file (IntraDay, LastDay, LastWeek or LastMonth) for lei2, rr or repex, streamed from the CSV zip by byte range and paginated with an opaque cursor pinned to one publication and file. Each record carries source_record_id, source_url, publication_id, retrieved_at, deleted_at (rr/repex DeletedAt) and every non-empty CDF column under fields. Files above the 32 MiB fetch cap (lei2 LastMonth) fail with exceeds_fetch_cap: download the URL from source_status. - [Records get](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_get): One LEI from api.gleif.org mapped onto Golden Copy CDF field names (LEI, Entity.LegalName, Entity.LegalJurisdiction, Entity.LegalForm.EntityLegalFormCode, Entity.EntityStatus, Registration.RegistrationStatus, Entity.LegalAddress, Entity.HeadquartersAddress, RegistrationAuthority, SuccessorEntity, LegalEntityEvents) plus its Level 2 parent side: the direct and ultimate parent relationship records (StartNode = this LEI) or the reporting exception that replaces them. publication_id is api.gleif.org's goldenCopy.publishDate, which can lag the files by one publication. Unknown LEIs fail not_found. - [Records list](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_list): The full current Level 2 (rr, 'who owns whom') relationship list from the Golden Copy rr CSV zip, paginated with a cursor pinned to one publication. Every page re-reads publishes/rr/latest and fails with publication_changed when the source moved on (unless publication_id was pinned explicitly: old publications stay downloadable). Each page streams the zip from byte 0 up to the requested rows, so later pages cost more. lei2 (482 MB) and repex (59 MB) full copies are hand-offs from source_status. - [Search](https://alexandria.firecrawl.dev/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. - [Source status](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/source_status): Cheap version check of the GLEIF Golden Copy: the latest publication (publication_id, published_at), and for lei2 (Level 1), rr (Level 2) and repex (reporting exceptions) the full and delta (IntraDay, LastDay, LastWeek, LastMonth) zip URLs, sizes and record counts. The publisher posts no checksum (content_hash is null). lei2 and repex full copies are hand-offs (URL, size, record count) because they exceed the fetch cap; rr is served by records_list. - [Ultimate children](https://alexandria.firecrawl.dev/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://alexandria.firecrawl.dev/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, plus the GLEIF Golden Copy collection contract: publication status, Level 1/Level 2/reporting-exception delta files, the paginated Level 2 (rr) full copy pinned to one publication, and one LEI mapped onto CDF field names. ## 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: `` - `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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/direct_children) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` - `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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/direct_parent) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` 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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/entity) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` 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" } ``` ### Records changes - Capability: `entities/records_changes` - Description: Rows of one Golden Copy delta file (IntraDay, LastDay, LastWeek or LastMonth) for lei2, rr or repex, streamed from the CSV zip by byte range and paginated with an opaque cursor pinned to one publication and file. Each record carries source_record_id, source_url, publication_id, retrieved_at, deleted_at (rr/repex DeletedAt) and every non-empty CDF column under fields. Files above the 32 MiB fetch cap (lei2 LastMonth) fail with exceeds_fetch_cap: download the URL from source_status. - Instructions: Rows of one Golden Copy delta file (IntraDay, LastDay, LastWeek or LastMonth) for lei2, rr or repex, streamed from the CSV zip by byte range and paginated with an opaque cursor pinned to one publication and file. Each record carries source_record_id, source_url, publication_id, retrieved_at, deleted_at (rr/repex DeletedAt) and every non-empty CDF column under fields. Files above the 32 MiB fetch cap (lei2 LastMonth) fail with exceeds_fetch_cap: download the URL from source_status. - Cost: 5 credits per call - Capability file: [Records changes](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_changes) Accepted options: - `cursor` (string): Opaque continuation from the previous page (pins publication, file, ETag and row offset). Example: `` - `delta` (string, required): delta Example: `IntraDay` - `filetype` (string, required): filetype Example: `lei2` - `page_size` (number): page_size Example: `200` - `publication_id` (string): Pin an explicit publication (YYYYMMDD-HHMM, e.g. 20261017-1600). Default: latest. Pattern: ^[0-9]{8}-[0-9]{4}$. Example: `` Response schema example: ```json { "api_url": "https://goldencopy.gleif.org/api/v2/golden-copies/publishes/rr/latest", "columns": [ "Relationship.StartNode.NodeID", "Relationship.StartNode.NodeIDType", "Relationship.EndNode.NodeID", "Relationship.EndNode.NodeIDType", "Relationship.RelationshipType", "Relationship.RelationshipStatus", "Relationship.Period.1.startDate", "Relationship.Period.1.endDate", "Relationship.Period.1.periodType", "Relationship.Period.2.startDate", "Relationship.Period.2.endDate", "Relationship.Period.2.periodType", "Relationship.Period.3.startDate", "Relationship.Period.3.endDate", "Relationship.Period.3.periodType", "Relationship.Period.4.startDate", "Relationship.Period.4.endDate", "Relationship.Period.4.periodType", "Relationship.Period.5.startDate", "Relationship.Period.5.endDate", "Relationship.Period.5.periodType", "Relationship.Qualifiers.1.QualifierDimension", "Relationship.Qualifiers.1.QualifierCategory", "Relationship.Qualifiers.2.QualifierDimension", "Relationship.Qualifiers.2.QualifierCategory", "Relationship.Qualifiers.3.QualifierDimension", "Relationship.Qualifiers.3.QualifierCategory", "Relationship.Qualifiers.4.QualifierDimension", "Relationship.Qualifiers.4.QualifierCategory", "Relationship.Qualifiers.5.QualifierDimension", "Relationship.Qualifiers.5.QualifierCategory", "Relationship.Quantifiers.1.MeasurementMethod", "Relationship.Quantifiers.1.QuantifierAmount", "Relationship.Quantifiers.1.QuantifierUnits", "Relationship.Quantifiers.2.MeasurementMethod", "Relationship.Quantifiers.2.QuantifierAmount", "Relationship.Quantifiers.2.QuantifierUnits", "Relationship.Quantifiers.3.MeasurementMethod", "Relationship.Quantifiers.3.QuantifierAmount", "Relationship.Quantifiers.3.QuantifierUnits", "Relationship.Quantifiers.4.MeasurementMethod", "Relationship.Quantifiers.4.QuantifierAmount", "Relationship.Quantifiers.4.QuantifierUnits", "Relationship.Quantifiers.5.MeasurementMethod", "Relationship.Quantifiers.5.QuantifierAmount", "Relationship.Quantifiers.5.QuantifierUnits", "Registration.InitialRegistrationDate", "Registration.LastUpdateDate", "Registration.RegistrationStatus", "Registration.NextRenewalDate", "Registration.ManagingLOU", "Registration.ValidationSources", "Registration.ValidationDocuments", "Registration.ValidationReference", "DeletedAt" ], "delta": "LastDay", "file": { "etag": "\"19f22-65e0ce301c0fa\"", "record_count": 2474, "size_bytes": 106274, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289795/20261017-1600-gleif-goldencopy-rr-last-day.csv.zip" }, "filetype": "rr", "next_row_offset": 1, "observed_at_ms": 1792278971114, "publication_id": "20261017-1600", "published_at": "2026-10-17T16:00:00Z", "records": [ { "deleted_at": null, "fields": { "Registration.InitialRegistrationDate": "2017-11-30T16:35:59.285Z", "Registration.LastUpdateDate": "2025-10-03T17:03:13.485Z", "Registration.ManagingLOU": "5493001KJTIIGC8Y1R12", "Registration.NextRenewalDate": "2027-11-01T17:12:02.687Z", "Registration.RegistrationStatus": "PUBLISHED", "Registration.ValidationDocuments": "OTHER_OFFICIAL_DOCUMENTS", "Registration.ValidationSources": "ENTITY_SUPPLIED_ONLY", "Relationship.EndNode.NodeID": "5493000HPQ4D2RZ79739", "Relationship.EndNode.NodeIDType": "LEI", "Relationship.Period.1.periodType": "RELATIONSHIP_PERIOD", "Relationship.Period.1.startDate": "2012-06-06T00:00:00.000Z", "Relationship.Period.2.endDate": "2018-01-01T00:00:00.000Z", "Relationship.Period.2.periodType": "ACCOUNTING_PERIOD", "Relationship.Period.2.startDate": "2017-01-02T00:00:00.000Z", "Relationship.Quantifiers.1.MeasurementMethod": "ACCOUNTING_CONSOLIDATION", "Relationship.Quantifiers.1.QuantifierAmount": "100.00", "Relationship.RelationshipStatus": "ACTIVE", "Relationship.RelationshipType": "IS_DIRECTLY_CONSOLIDATED_BY", "Relationship.StartNode.NodeID": "01J4SO3XTWZF4PP38209", "Relationship.StartNode.NodeIDType": "LEI" }, "publication_id": "20261017-1600", "retrieved_at": "2026-10-17T23:16:08Z", "source_record_id": "01J4SO3XTWZF4PP38209|IS_DIRECTLY_CONSOLIDATED_BY|5493000HPQ4D2RZ79739", "source_url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289795/20261017-1600-gleif-goldencopy-rr-last-day.csv.zip" } ], "retrieved_at": "2026-10-17T23:16:08Z", "row_offset": 0, "source_url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289795/20261017-1600-gleif-goldencopy-rr-last-day.csv.zip" } ``` ### Records get - Capability: `entities/records_get` - Description: One LEI from api.gleif.org mapped onto Golden Copy CDF field names (LEI, Entity.LegalName, Entity.LegalJurisdiction, Entity.LegalForm.EntityLegalFormCode, Entity.EntityStatus, Registration.RegistrationStatus, Entity.LegalAddress, Entity.HeadquartersAddress, RegistrationAuthority, SuccessorEntity, LegalEntityEvents) plus its Level 2 parent side: the direct and ultimate parent relationship records (StartNode = this LEI) or the reporting exception that replaces them. publication_id is api.gleif.org's goldenCopy.publishDate, which can lag the files by one publication. Unknown LEIs fail not_found. - Instructions: One LEI from api.gleif.org mapped onto Golden Copy CDF field names (LEI, Entity.LegalName, Entity.LegalJurisdiction, Entity.LegalForm.EntityLegalFormCode, Entity.EntityStatus, Registration.RegistrationStatus, Entity.LegalAddress, Entity.HeadquartersAddress, RegistrationAuthority, SuccessorEntity, LegalEntityEvents) plus its Level 2 parent side: the direct and ultimate parent relationship records (StartNode = this LEI) or the reporting exception that replaces them. publication_id is api.gleif.org's goldenCopy.publishDate, which can lag the files by one publication. Unknown LEIs fail not_found. - Cost: 5 credits per call - Capability file: [Records get](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_get) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` Response schema example: ```json { "observed_at_ms": 1792279032428, "publication_id": "20261017-0800", "published_at": "2026-10-17T08:00:00Z", "record": { "ConformityFlag": "CONFORMING", "Entity.AssociatedEntity.AssociatedLEI": null, "Entity.EntityCategory": "GENERAL", "Entity.EntityCreationDate": "2023-05-10T12:00:00Z", "Entity.EntityExpirationDate": null, "Entity.EntityExpirationReason": null, "Entity.EntityStatus": "ACTIVE", "Entity.EntitySubCategory": null, "Entity.HeadquartersAddress": { "address_lines": [ "Ground Floor of Tower B, PrimeCo Union City", "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87", "Sadarmangala Industrial Area", "Krishnarajapuram Hobli, Kadugodi" ], "address_number": null, "address_number_within_building": null, "city": "Bangalore", "country": "IN", "language": "en", "mail_routing": null, "postal_code": "560067", "region": "IN-KA" }, "Entity.LegalAddress": { "address_lines": [ "Ground Floor of Tower B, PrimeCo Union City", "Plot Nos. 18, 19A And 19B, Sy No. 76 & 87", "Sadarmangala Industrial Area", "Krishnarajapuram Hobli, Kadugodi" ], "address_number": null, "address_number_within_building": null, "city": "Bangalore", "country": "IN", "language": "en", "mail_routing": null, "postal_code": "560067", "region": "IN-KA" }, "Entity.LegalEntityEvents": [ { "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" } ], "Entity.LegalForm.EntityLegalFormCode": "YSP9", "Entity.LegalForm.OtherLegalForm": null, "Entity.LegalJurisdiction": "IN", "Entity.LegalName": "APPLE OPERATIONS INDIA PRIVATE LIMITED", "Entity.LegalName.xmllang": "en", "Entity.OtherEntityNames": [ { "language": "en", "name": "Apple Operations India Pvt. Ltd.", "type": "TRADING_OR_OPERATING_NAME" } ], "Entity.RegistrationAuthority.OtherRegistrationAuthorityID": null, "Entity.RegistrationAuthority.RegistrationAuthorityEntityID": "U72100KA2023PTC173466", "Entity.RegistrationAuthority.RegistrationAuthorityID": "RA000394", "Entity.SuccessorEntities": [], "Entity.SuccessorEntity.1.SuccessorLEI": null, "Entity.TransliteratedOtherEntityNames": [], "LEI": "2549008YU9EOMHFUA249", "Registration.InitialRegistrationDate": "2023-08-25T14:07:19Z", "Registration.LastUpdateDate": "2026-05-19T07:01:11Z", "Registration.ManagingLOU": "5493001KJTIIGC8Y1R12", "Registration.NextRenewalDate": "2027-05-25T14:07:19Z", "Registration.RegistrationStatus": "ISSUED", "Registration.ValidationAuthority.ValidationAuthorityEntityID": "U72100KA2023PTC173466", "Registration.ValidationAuthority.ValidationAuthorityID": "RA000394", "Registration.ValidationSources": "FULLY_CORROBORATED", "bic": null, "deleted_at": null, "level": 1, "mic": null, "publication_id": "20261017-0800", "published_at": "2026-10-17T08:00:00Z", "retrieved_at": "2026-10-17T23:17:10Z", "source_record_id": "2549008YU9EOMHFUA249", "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249" }, "relationships": { "direct_parent": { "exception": null, "kind": "relationship", "record": { "EndNode.NodeID": "HWUPKR0MPOU8FGXBT394", "Period": [ { "end_date": null, "start_date": "2023-05-17T00:00:00Z", "type": "RELATIONSHIP_PERIOD" }, { "end_date": "2023-09-30T00:00:00Z", "start_date": "2023-05-17T00:00:00Z", "type": "ACCOUNTING_PERIOD" } ], "Qualifiers": [], "Quantifiers": [], "Registration.InitialRegistrationDate": "2023-08-25T14:07:19Z", "Registration.LastUpdateDate": "2025-06-17T16:01:33Z", "Registration.ManagingLOU": "5493001KJTIIGC8Y1R12", "Registration.NextRenewalDate": "2027-05-25T14:07:19Z", "Registration.RegistrationStatus": "PUBLISHED", "Registration.ValidationDocuments": "OTHER_OFFICIAL_DOCUMENTS", "Registration.ValidationReference": null, "Registration.ValidationSources": "ENTITY_SUPPLIED_ONLY", "RelationshipStatus": "ACTIVE", "RelationshipType": "IS_DIRECTLY_CONSOLIDATED_BY", "StartNode.NodeID": "2549008YU9EOMHFUA249", "api_record_id": "2549008YU9EOMHFUA249|LEI|IS_DIRECTLY_CONSOLIDATED_BY|3|a28a2df38dee8739b228b3b2c7ffa7c3ad3abc46e39f6974435e90e463edf280|", "deleted_at": null, "level": 2, "publication_id": "20261017-0800", "retrieved_at": "2026-10-17T23:17:10Z", "source_record_id": "2549008YU9EOMHFUA249|IS_DIRECTLY_CONSOLIDATED_BY|HWUPKR0MPOU8FGXBT394", "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/direct-parent-relationship" } }, "ultimate_parent": { "exception": null, "kind": "relationship", "record": { "EndNode.NodeID": "HWUPKR0MPOU8FGXBT394", "Period": [ { "end_date": null, "start_date": "2023-05-17T00:00:00Z", "type": "RELATIONSHIP_PERIOD" }, { "end_date": "2023-09-30T00:00:00Z", "start_date": "2023-05-17T00:00:00Z", "type": "ACCOUNTING_PERIOD" } ], "Qualifiers": [], "Quantifiers": [], "Registration.InitialRegistrationDate": "2023-08-25T14:07:19Z", "Registration.LastUpdateDate": "2025-06-17T16:01:33Z", "Registration.ManagingLOU": "5493001KJTIIGC8Y1R12", "Registration.NextRenewalDate": "2027-05-25T14:07:19Z", "Registration.RegistrationStatus": "PUBLISHED", "Registration.ValidationDocuments": "OTHER_OFFICIAL_DOCUMENTS", "Registration.ValidationReference": null, "Registration.ValidationSources": "ENTITY_SUPPLIED_ONLY", "RelationshipStatus": "ACTIVE", "RelationshipType": "IS_ULTIMATELY_CONSOLIDATED_BY", "StartNode.NodeID": "2549008YU9EOMHFUA249", "api_record_id": "2549008YU9EOMHFUA249|LEI|IS_ULTIMATELY_CONSOLIDATED_BY|3|59906e2a6c3a3e3adbf1dbfad161a5450d2f9cf6cf5ff803b0bb658c9889ce1d|", "deleted_at": null, "level": 2, "publication_id": "20261017-0800", "retrieved_at": "2026-10-17T23:17:10Z", "source_record_id": "2549008YU9EOMHFUA249|IS_ULTIMATELY_CONSOLIDATED_BY|HWUPKR0MPOU8FGXBT394", "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249/ultimate-parent-relationship" } } }, "retrieved_at": "2026-10-17T23:17:10Z", "source_url": "https://api.gleif.org/api/v1/lei-records/2549008YU9EOMHFUA249" } ``` ### Records list - Capability: `entities/records_list` - Description: The full current Level 2 (rr, 'who owns whom') relationship list from the Golden Copy rr CSV zip, paginated with a cursor pinned to one publication. Every page re-reads publishes/rr/latest and fails with publication_changed when the source moved on (unless publication_id was pinned explicitly: old publications stay downloadable). Each page streams the zip from byte 0 up to the requested rows, so later pages cost more. lei2 (482 MB) and repex (59 MB) full copies are hand-offs from source_status. - Instructions: The full current Level 2 (rr, 'who owns whom') relationship list from the Golden Copy rr CSV zip, paginated with a cursor pinned to one publication. Every page re-reads publishes/rr/latest and fails with publication_changed when the source moved on (unless publication_id was pinned explicitly: old publications stay downloadable). Each page streams the zip from byte 0 up to the requested rows, so later pages cost more. lei2 (482 MB) and repex (59 MB) full copies are hand-offs from source_status. - Cost: 5 credits per call - Capability file: [Records list](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/records_list) Accepted options: - `cursor` (string): Opaque continuation from the previous page (pins publication, file, ETag and row offset). Example: `` - `filetype` (string): Only rr (Level 2) fits; lei2 and repex full copies are hand-offs from source_status. Example: `rr` - `page_size` (number): page_size Example: `200` - `publication_id` (string): Pin an explicit publication (YYYYMMDD-HHMM, e.g. 20261017-1600). Default: latest. Pattern: ^[0-9]{8}-[0-9]{4}$. Example: `` Response schema example: ```json { "api_url": "https://goldencopy.gleif.org/api/v2/golden-copies/publishes/rr/latest", "columns": [ "Relationship.StartNode.NodeID", "Relationship.StartNode.NodeIDType", "Relationship.EndNode.NodeID", "Relationship.EndNode.NodeIDType", "Relationship.RelationshipType", "Relationship.RelationshipStatus", "Relationship.Period.1.startDate", "Relationship.Period.1.endDate", "Relationship.Period.1.periodType", "Relationship.Period.2.startDate", "Relationship.Period.2.endDate", "Relationship.Period.2.periodType", "Relationship.Period.3.startDate", "Relationship.Period.3.endDate", "Relationship.Period.3.periodType", "Relationship.Period.4.startDate", "Relationship.Period.4.endDate", "Relationship.Period.4.periodType", "Relationship.Period.5.startDate", "Relationship.Period.5.endDate", "Relationship.Period.5.periodType", "Relationship.Qualifiers.1.QualifierDimension", "Relationship.Qualifiers.1.QualifierCategory", "Relationship.Qualifiers.2.QualifierDimension", "Relationship.Qualifiers.2.QualifierCategory", "Relationship.Qualifiers.3.QualifierDimension", "Relationship.Qualifiers.3.QualifierCategory", "Relationship.Qualifiers.4.QualifierDimension", "Relationship.Qualifiers.4.QualifierCategory", "Relationship.Qualifiers.5.QualifierDimension", "Relationship.Qualifiers.5.QualifierCategory", "Relationship.Quantifiers.1.MeasurementMethod", "Relationship.Quantifiers.1.QuantifierAmount", "Relationship.Quantifiers.1.QuantifierUnits", "Relationship.Quantifiers.2.MeasurementMethod", "Relationship.Quantifiers.2.QuantifierAmount", "Relationship.Quantifiers.2.QuantifierUnits", "Relationship.Quantifiers.3.MeasurementMethod", "Relationship.Quantifiers.3.QuantifierAmount", "Relationship.Quantifiers.3.QuantifierUnits", "Relationship.Quantifiers.4.MeasurementMethod", "Relationship.Quantifiers.4.QuantifierAmount", "Relationship.Quantifiers.4.QuantifierUnits", "Relationship.Quantifiers.5.MeasurementMethod", "Relationship.Quantifiers.5.QuantifierAmount", "Relationship.Quantifiers.5.QuantifierUnits", "Registration.InitialRegistrationDate", "Registration.LastUpdateDate", "Registration.RegistrationStatus", "Registration.NextRenewalDate", "Registration.ManagingLOU", "Registration.ValidationSources", "Registration.ValidationDocuments", "Registration.ValidationReference" ], "delta": "GoldenCopy", "file": { "etag": "\"175ce8c-65e0ce2414aaf\"", "record_count": 491462, "size_bytes": 24497804, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289765/20261017-1600-gleif-goldencopy-rr-golden-copy.csv.zip" }, "filetype": "rr", "next_row_offset": 1, "observed_at_ms": 1792279026340, "publication_id": "20261017-1600", "published_at": "2026-10-17T16:00:00Z", "records": [ { "deleted_at": null, "fields": { "Registration.InitialRegistrationDate": "2022-11-14T09:59:48.000Z", "Registration.LastUpdateDate": "2025-04-19T13:30:05.472Z", "Registration.ManagingLOU": "5493001KJTIIGC8Y1R12", "Registration.NextRenewalDate": "2025-04-18T15:48:53.604Z", "Registration.RegistrationStatus": "LAPSED", "Registration.ValidationDocuments": "SUPPORTING_DOCUMENTS", "Registration.ValidationReference": "https://www.sec.gov/Archives/edgar/data/722574/000072257422000127/filing4699.htm", "Registration.ValidationSources": "FULLY_CORROBORATED", "Relationship.EndNode.NodeID": "5493001Z012YSB2A0K51", "Relationship.EndNode.NodeIDType": "LEI", "Relationship.Period.1.periodType": "RELATIONSHIP_PERIOD", "Relationship.Period.1.startDate": "2012-11-29T00:00:00.000Z", "Relationship.RelationshipStatus": "ACTIVE", "Relationship.RelationshipType": "IS_FUND-MANAGED_BY", "Relationship.StartNode.NodeID": "001GPB6A9XPE8XJICC14", "Relationship.StartNode.NodeIDType": "LEI" }, "publication_id": "20261017-1600", "retrieved_at": "2026-10-17T23:16:23Z", "source_record_id": "001GPB6A9XPE8XJICC14|IS_FUND-MANAGED_BY|5493001Z012YSB2A0K51", "source_url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289765/20261017-1600-gleif-goldencopy-rr-golden-copy.csv.zip" } ], "retrieved_at": "2026-10-17T23:16:23Z", "row_offset": 0, "source_url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289765/20261017-1600-gleif-goldencopy-rr-golden-copy.csv.zip" } ``` ### 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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/search) Accepted options: - `country` (string): Pattern: ^[A-Z]{2}$. Example: `` - `limit` (number): limit Example: `20` - `name` (string, required): name Example: `` - `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" } ``` ### Source status - Capability: `entities/source_status` - Description: Cheap version check of the GLEIF Golden Copy: the latest publication (publication_id, published_at), and for lei2 (Level 1), rr (Level 2) and repex (reporting exceptions) the full and delta (IntraDay, LastDay, LastWeek, LastMonth) zip URLs, sizes and record counts. The publisher posts no checksum (content_hash is null). lei2 and repex full copies are hand-offs (URL, size, record count) because they exceed the fetch cap; rr is served by records_list. - Instructions: Cheap version check of the GLEIF Golden Copy: the latest publication (publication_id, published_at), and for lei2 (Level 1), rr (Level 2) and repex (reporting exceptions) the full and delta (IntraDay, LastDay, LastWeek, LastMonth) zip URLs, sizes and record counts. The publisher posts no checksum (content_hash is null). lei2 and repex full copies are hand-offs (URL, size, record count) because they exceed the fetch cap; rr is served by records_list. - Cost: 5 credits per call - Capability file: [Source status](https://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/source_status) Accepted options: - `filetype` (string): Restrict to one filetype (publishes/{filetype}/latest). Default: all three. Example: `lei2` Response schema example: ```json { "content_hash": null, "fetch_cap_bytes": 33554432, "files": { "rr": { "cdf_version": "RR_2.1", "deltas": { "IntraDay": { "csv": { "fits_fetch_cap": true, "record_count": 212, "size_bytes": 8723, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289792/20261017-1600-gleif-goldencopy-rr-intra-day.csv.zip" }, "json": { "fits_fetch_cap": true, "record_count": 212, "size_bytes": 12104, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289777/20261017-1600-gleif-goldencopy-rr-intra-day.json.zip" }, "xml": { "fits_fetch_cap": true, "record_count": 212, "size_bytes": 11904, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289768/20261017-1600-gleif-goldencopy-rr-intra-day.xml.zip" } }, "LastDay": { "csv": { "fits_fetch_cap": true, "record_count": 2474, "size_bytes": 106274, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289795/20261017-1600-gleif-goldencopy-rr-last-day.csv.zip" }, "json": { "fits_fetch_cap": true, "record_count": 2474, "size_bytes": 159078, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289780/20261017-1600-gleif-goldencopy-rr-last-day.json.zip" }, "xml": { "fits_fetch_cap": true, "record_count": 2474, "size_bytes": 150646, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289771/20261017-1600-gleif-goldencopy-rr-last-day.xml.zip" } }, "LastMonth": { "csv": { "fits_fetch_cap": true, "record_count": 55484, "size_bytes": 2623287, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289801/20261017-1600-gleif-goldencopy-rr-last-month.csv.zip" }, "json": { "fits_fetch_cap": true, "record_count": 55484, "size_bytes": 3824896, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289786/20261017-1600-gleif-goldencopy-rr-last-month.json.zip" }, "xml": { "fits_fetch_cap": true, "record_count": 55484, "size_bytes": 3617969, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289789/20261017-1600-gleif-goldencopy-rr-last-month.xml.zip" } }, "LastWeek": { "csv": { "fits_fetch_cap": true, "record_count": 15658, "size_bytes": 704069, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289798/20261017-1600-gleif-goldencopy-rr-last-week.csv.zip" }, "json": { "fits_fetch_cap": true, "record_count": 15658, "size_bytes": 1041651, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289783/20261017-1600-gleif-goldencopy-rr-last-week.json.zip" }, "xml": { "fits_fetch_cap": true, "record_count": 15658, "size_bytes": 980726, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289774/20261017-1600-gleif-goldencopy-rr-last-week.xml.zip" } } }, "full": { "csv": { "fits_fetch_cap": true, "record_count": 491462, "size_bytes": 24497804, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289765/20261017-1600-gleif-goldencopy-rr-golden-copy.csv.zip" }, "json": { "fits_fetch_cap": false, "record_count": 491462, "size_bytes": 35179850, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289762/20261017-1600-gleif-goldencopy-rr-golden-copy.json.zip" }, "xml": { "fits_fetch_cap": true, "record_count": 491462, "size_bytes": 33294545, "url": "https://goldencopy.gleif.org/storage/golden-copy-files/2026/10/17/1289759/20261017-1600-gleif-goldencopy-rr-golden-copy.xml.zip" } }, "handoff_reason": null, "list_supported": true, "record_count": 491462 } }, "observed_at_ms": 1792278963043, "publication_id": "20261017-1600", "published_at": "2026-10-17T16:00:00Z", "retrieved_at": "2026-10-17T23:16:02Z", "source_url": "https://goldencopy.gleif.org/api/v2/golden-copies/publishes/rr/latest" } ``` ### 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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/ultimate_children) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` - `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://alexandria.firecrawl.dev/agents/providers/gleif-org/entities/ultimate_parent) Accepted options: - `lei` (string, required): Pattern: ^[A-Z0-9]{20}$. Example: `` 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" } ```