Alpha AnalystDocs
API Portal

Entity Structure API

Retrieve the parent and subsidiary legal-entity tree when we have an LEI. scope=below lists descendants; scope=ultimate walks from the top parent. Flat nodes—rebuild with parent_lei and level.

curl -X GET "https://example.com/v2/entities/structure?id=AAPL"

{  "id": "AAPL",  "scope": "below",  "level": -1,  "active": -1,  "entity": {    "name": "Apple Inc.",    "name_short": "Apple Inc.",    "full_ticker": "AAPL US",    "normalized_ticker": "AAPL",    "backlink_url": "https://alpha-analyst.com/stocks/aapl",    "category": "EQUITY",    "cik": "0000320193",    "lei": "HWUPKR0MPOU8FGXBT394"  },  "center_lei": "HWUPKR0MPOU8FGXBT394",  "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",  "has_relationships": true,  "count": 21,  "nodes": [    {      "lei": "HWUPKR0MPOU8FGXBT394",      "parent_lei": null,      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 1,      "is_center": 1,      "is_inactive": 0,      "relationship_type": "",      "relationship_status": "",      "registration_status": "",      "registration_is_lapsed": 0,      "relationship_start_date": "",      "relationship_end_date": "",      "corroboration_level": "",      "legal_name": "Apple Inc.",      "country": "US",      "legal_jurisdiction": "US-CA",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Inc.",      "name_short": "Apple Inc.",      "full_ticker": "AAPL US",      "normalized_ticker": "AAPL",      "backlink_url": "https://alpha-analyst.com/stocks/aapl",      "category": "EQUITY",      "cik": "0000320193"    },    {      "lei": "2549008YU9EOMHFUA249",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2023-05-17",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE OPERATIONS INDIA PRIVATE LIMITED",      "country": "IN",      "legal_jurisdiction": "IN",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Operations India Private Limited",      "name_short": "Apple Operations India Private Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-operations-india-private-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493004QI6E3PJNCEB09",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2013-09-11",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE CHILE COMERCIAL LIMITADA",      "country": "CL",      "legal_jurisdiction": "CL",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Chile Comercial Limitada",      "name_short": "Apple Chile Comercial Limitada",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/casio-computer-co-ltd",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493004SYPRAVRVNK561",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2023-05-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE CANADA INC.",      "country": "CA",      "legal_jurisdiction": "CA-ON",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Canada Inc.",      "name_short": "Apple Canada Inc.",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-canada-inc",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493006LHHR4CLPX4Q79",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2005-10-03",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "BRAEBURN CAPITAL, INC.",      "country": "US",      "legal_jurisdiction": "US-NV",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Braeburn Capital, Inc.",      "name_short": "Braeburn Capital, Inc.",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/braeburn-capital-inc",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300G81RQKP7XW2N18",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2017-12-13",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE OPERATIONS INTERNATIONAL LIMITED",      "country": "IE",      "legal_jurisdiction": "IE",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Operations International Limited",      "name_short": "Apple Operations International Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-operations-international-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "2549005JJKRFXSM5CC84",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2026-04-10",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "Apple Technology Services India Private Limited",      "country": "IN",      "legal_jurisdiction": "IN",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Technology Services India Private Limited",      "name_short": "Apple Technology Services India Private Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-technology-services-india-private-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "54930027SQL2KPSDBM58",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2009-05-11",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE DISTRIBUTION INTERNATIONAL LIMITED",      "country": "IE",      "legal_jurisdiction": "IE",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Distribution International Limited",      "name_short": "Apple Distribution International Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-distribution-international-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493004DRENYD68POX17",      "parent_lei": "54930027SQL2KPSDBM58",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 4,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2022-06-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE TEKNOLOJİ VE SATIŞ LİMİTED ŞİRKETİ",      "country": "TR",      "legal_jurisdiction": "TR",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Technology And Sales Limited",      "name_short": "Apple Technology And Sales Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-technology-and-sales-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493004NKTUXS10HUX68",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2017-12-06",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE SOUTH ASIA PTE. LTD.",      "country": "SG",      "legal_jurisdiction": "SG",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple South Asia Pte. Ltd.",      "name_short": "Apple South Asia Pte. Ltd.",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-south-asia-pte-ltd",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493004NRK1XLI2A3K89",      "parent_lei": "5493004NKTUXS10HUX68",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 4,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2023-06-09",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "Apple Japan合同会社",      "country": "JP",      "legal_jurisdiction": "JP",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Japan LLC",      "name_short": "Apple Japan LLC",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-japan-llc",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "5493007Y31O7VTA60Y74",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2022-06-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "蘋果電腦貿易（上海）有限公司",      "country": "CN",      "legal_jurisdiction": "CN",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Computer Trading (shanghai) Co., Ltd.",      "name_short": "Apple Computer Trading (shanghai) Co., Ltd.",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-computer-trading-shanghai-co-ltd",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300GF4NZMYB9VP153",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2017-12-11",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE PTY LIMITED",      "country": "AU",      "legal_jurisdiction": "AU",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Pty Limited",      "name_short": "Apple Pty Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-pty-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "54930064XZWGVDHF4G62",      "parent_lei": "549300GF4NZMYB9VP153",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 4,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2023-05-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE SALES NEW ZEALAND",      "country": "NZ",      "legal_jurisdiction": "NZ",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Sales New Zealand",      "name_short": "Apple Sales New Zealand",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-sales-new-zealand",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300JTZWECUOC8CW13",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2023-06-09",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "애플코리아 유한회사",      "country": "KR",      "legal_jurisdiction": "KR",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Korea Limited",      "name_short": "Apple Korea Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-korea-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300MGN03W4U2NK749",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2021-08-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE OPERATIONS LIMITED",      "country": "IE",      "legal_jurisdiction": "IE",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Operations Limited",      "name_short": "Apple Operations Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-operations-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300QKDHYRRQH2MB86",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2022-06-09",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE (UK) LIMITED",      "country": "GB",      "legal_jurisdiction": "GB",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple (uk) Limited",      "name_short": "Apple (uk) Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-uk-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300XL0CAPYOJAG264",      "parent_lei": "549300G81RQKP7XW2N18",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 3,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2019-05-01",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE INDIA PRIVATE LIMITED",      "country": "IN",      "legal_jurisdiction": "IN",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple India Private Limited",      "name_short": "Apple India Private Limited",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-india-private-limited",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300MF6CNUB2URPE58",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2013-10-31",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE OPERATIONS MEXICO SA DE CV",      "country": "MX",      "legal_jurisdiction": "MX",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Operations Mexico Sa De Cv",      "name_short": "Apple Operations Mexico Sa De Cv",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-operations-mexico-sa-de-cv",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300UJWEUFNYXPJ620",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2022-06-08",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE COMPUTER BRASIL LTDA.",      "country": "BR",      "legal_jurisdiction": "BR",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Computer Brasil Ltda.",      "name_short": "Apple Computer Brasil Ltda.",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-computer-brasil-ltda",      "category": "PRIVATE_COMP",      "cik": ""    },    {      "lei": "549300YX4S1LLSMK2627",      "parent_lei": "HWUPKR0MPOU8FGXBT394",      "ultimate_parent_lei": "HWUPKR0MPOU8FGXBT394",      "level": 2,      "is_center": 0,      "is_inactive": 0,      "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",      "relationship_status": "ACTIVE",      "registration_status": "PUBLISHED",      "registration_is_lapsed": 0,      "relationship_start_date": "2018-04-10",      "relationship_end_date": "",      "corroboration_level": "ENTITY_SUPPLIED_ONLY",      "legal_name": "APPLE ENERGY LLC",      "country": "US",      "legal_jurisdiction": "US-DE",      "entity_status": "ACTIVE",      "entity_category": "GENERAL",      "name": "Apple Energy Llc",      "name_short": "Apple Energy Llc",      "full_ticker": "",      "normalized_ticker": "",      "backlink_url": "https://alpha-analyst.com/companies/apple-energy-llc",      "category": "PRIVATE_COMP",      "cik": ""    }  ]}

GET
/v2/entities/structure

Query Parameters

id*Entity Id

Company or listing id. Same resolve as Entity Reference: ticker (AAPL, AAPL US, AAPL-US), CIK, LEI, EDINET code, CRD, SEC series id, internal id, FIGI, composite FIGI, and share-class FIGI. ISIN and CUSIP match but are never returned. See Ids you can send.

Length1 <= length <= 200
scope?string

below or ultimate. Default below. below returns the requested entity as the root and entities under it. ultimate returns the ultimate parent as the root and the full subordinate tree, including siblings of the requested entity.

Default"below"

Value in

  • "below"
  • "ultimate"
level?integer

Depth filter. -1 returns every level. 1-8 returns only nodes at that depth (root is 1).

Range-1 <= value <= 8
Default-1
active?integer

-1, 0, or 1. Default -1. 1 keeps active nodes, 0 keeps inactive nodes, -1 keeps both. The requested entity is always included when its level matches.

Default-1

Value in

  • -1
  • 0
  • 1

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json