# GLEIF API: Get corporate parents > Finds a company's reported direct and ultimate accounting-consolidation parents, the reasons parents are not reported, and direct children in the GLEIF LEI system. Unofficial. Not affiliated with or endorsed by GLEIF. - Page: https://fous.com/methods/gleif.org/get-corporate-parents - Method: `gleif.org/get_corporate_parents`, version 1 - Website: gleif.org - Returns: legal name, LEI, country, direct and ultimate parents with reasons, child counts, direct children - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `company` | string | yes | `"Unilever PLC"` | Legal company name or 20-character LEI, such as Unilever PLC. | | `country` | string | no | | Country name or two-letter code to distinguish namesakes, such as United Kingdom or GB. Default "". | | `max_children` | integer | no | | Most direct children to show, such as 50 (up to 200). Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "company": "Unilever PLC" } ``` Its output: ```json { "lei": "549300MKFYEKVRWML317", "country": "United Kingdom of Great Britain and Northern Ireland", "children": [ { "lei": "213800HCGYEJXD99N110", "status": "Active", "country": "Canada", "page_url": "https://search.gleif.org/#/record/213800HCGYEJXD99N110", "legal_name": "UNILEVER CANADA INC." }, { "lei": "213800WR5NOVOEYFLN72", "status": "Active", "country": "Egypt", "page_url": "https://search.gleif.org/#/record/213800WR5NOVOEYFLN72", "legal_name": "يونيليفر مشرق للصناعة و التجارة ش م م" }, { "lei": "213800IPN2AVTPFEY722", "status": "Active", "country": "Oman", "page_url": "https://search.gleif.org/#/record/213800IPN2AVTPFEY722", "legal_name": "تاول يونيليفر" } ], "page_url": "https://search.gleif.org/#/record/549300MKFYEKVRWML317", "legal_name": "UNILEVER PLC", "direct_parent": null, "ultimate_parent": null, "direct_parent_reason": "The accounting consolidation definition for parent relationships does not apply to the entity", "direct_children_total": 70, "ultimate_parent_reason": "The accounting consolidation definition for parent relationships does not apply to the entity", "ultimate_children_total": 109 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"gleif.org/get_corporate_parents","input":{"company":"Unilever PLC"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Who is the direct and ultimate accounting parent of Unilever PLC in the United Kingdom, and why are they not reported if missing? - Show the consolidation parents and direct subsidiaries for LEI 549300GZJ7E4XCJ0NC43 with up to 25 children - Find the ultimate parent company of Siemens AG in Germany according to GLEIF LEI data - What are the direct child entities of Nestle SA, country CH, limited to 100 results? - Look up the reported parent companies and reasons for no parent for Toyota Motor Corporation, JP, on gleif.org ## Input schema ```json { "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "minLength": 1, "description": "Legal company name or 20-character LEI, such as Unilever PLC." }, "country": { "type": "string", "default": "", "description": "Country name or two-letter code to distinguish namesakes, such as United Kingdom or GB." }, "max_children": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Most direct children to show, such as 50 (up to 200)." } } } ``` ## Output schema ```json { "type": "object", "required": [ "legal_name", "lei", "country", "page_url", "direct_parent", "direct_parent_reason", "ultimate_parent", "ultimate_parent_reason", "direct_children_total", "ultimate_children_total", "children" ], "properties": { "lei": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "children": { "type": "array", "items": { "type": "object", "required": [ "legal_name", "lei", "country", "page_url", "status" ], "properties": { "lei": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "page_url": { "type": [ "string", "null" ] }, "legal_name": { "type": [ "string", "null" ] } } } }, "page_url": { "type": [ "string", "null" ] }, "legal_name": { "type": [ "string", "null" ] }, "direct_parent": { "anyOf": [ { "type": "object", "required": [ "legal_name", "lei", "country", "page_url", "relationship_start_date" ], "properties": { "lei": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "page_url": { "type": [ "string", "null" ] }, "legal_name": { "type": [ "string", "null" ] }, "relationship_start_date": { "type": [ "string", "null" ], "format": "date" } } }, { "type": "null" } ] }, "ultimate_parent": { "anyOf": [ { "type": "object", "required": [ "legal_name", "lei", "country", "page_url", "relationship_start_date" ], "properties": { "lei": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "page_url": { "type": [ "string", "null" ] }, "legal_name": { "type": [ "string", "null" ] }, "relationship_start_date": { "type": [ "string", "null" ], "format": "date" } } }, { "type": "null" } ] }, "direct_parent_reason": { "type": [ "string", "null" ] }, "direct_children_total": { "type": "integer" }, "ultimate_parent_reason": { "type": [ "string", "null" ] }, "ultimate_children_total": { "type": "integer" } } } ``` ## See more - [GLEIF API: Get legal entity](https://fous.com/methods/gleif.org/get-legal-entity.md): Looks up the official LEI record for a company name or LEI, optionally narrowing namesakes by registered country. Prefers active records with the closest name. - [Companies House API: Get UK company profile](https://fous.com/methods/company-information.service.gov.uk/get-company-profile.md): Looks up a UK company on Companies House by name, company number or Companies House link and returns its public registration details; a name prefers an active exact match. - [Companies House API: List company filing history](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-filing-history.md): Lists a UK company's Companies House filings, newest first, with date, form code, type, description, page count and PDF link. Finds the company by name, company number or Companies House link; a category picks accounts, confirmation statements, officers, address, capital, charges or incorporation filings. - [SEC EDGAR API: List company SEC filings](https://fous.com/methods/sec.gov/get-company-filings.md): Finds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date. - [Companies House API: List company owners](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-owners.md): Lists a UK company's people with significant control and any register statement, from the public Companies House register. Ceased owners and withdrawn statements are included only when asked for. - [Companies House API: Search companies](https://fous.com/methods/find-and-update.company-information.service.gov.uk/search-companies.md): Searches the UK Companies House register by company name and returns each company's status, type, incorporation date and registered office address, in result order. - [data.gouv.fr API: Get French company](https://fous.com/methods/annuaire-entreprises.data.gouv.fr/get-company.md): Looks up a French company by name, SIREN or SIRET and returns its registration, directors and latest public financial figures. Financial figures are null when not published; a city or postcode helps pick the right namesake. - [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null. - [All GLEIF methods](https://fous.com/methods/gleif.org.md)