Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF’s required non-endorsement notice.
ACTIVE or INACTIVE. Observed vocabulary, measured 2026-08-10 (3 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/gleif/relationships?lei=<lei> — readstatus``. The status of a GLEIF relationship record. Unlike relationship_type beside it, this one is uppercased and passed through unvalidated, so it is published as measured. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_status
Source attribution, coverage and evidence interpretation; unknown coverage is not zero.
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"GDELT Cloud","colors":{"primary":"#00A3E6","light":"#33C3FF","dark":"#00B8FF"},"logo":{"light":"https://mintcdn.com/gdeltcloud/KTGJpOMcmte0oOTe/logo/light.png?fit=max\u0026auto=format\u0026n=KTGJpOMcmte0oOTe\u0026q=85\u0026s=a78b03b47abd8cab8440d155ed680c34","dark":"https://mintcdn.com/gdeltcloud/miSOHwAydO88jcW5/logo/dark.png?fit=max\u0026auto=format\u0026n=miSOHwAydO88jcW5\u0026q=85\u0026s=ca65237b8e8547e0eef674bbaf79a5e6"},"favicon":"https://mintcdn.com/gdeltcloud/miSOHwAydO88jcW5/favicon.ico?fit=max\u0026auto=format\u0026n=miSOHwAydO88jcW5\u0026q=85\u0026s=f9ab1eb729e9f162c1eca54614c5a903","api":{"openapi":["api-reference/openapi-v2.json"],"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://gdeltcloud.com/pricing","label":"Pricing"},{"href":"https://gdeltcloud.com/api-arena","label":"API Arena"},{"icon":"activity","href":"https://status.gdeltcloud.com","label":"Status"},{"href":"https://gdeltcloud.com/auth/sign-up?next=%2Fapi-keys","label":"Sign up"}],"primary":{"type":"button","label":"Try Builder free","href":"https://gdeltcloud.com/auth/sign-up?next=%2Fsettings%2Fsubscription%3Fplan%3Dbuilder%26billing_interval%3Dmonth"}},"footer":{"socials":{"github":"https://github.com/gdelt-cloud","linkedin":"https://www.linkedin.com/company/gdelt-cloud","x":"https://x.com/GDELTCloud"},"links":[{"header":"GDELT Cloud","items":[{"label":"Pricing","href":"https://gdeltcloud.com/pricing"},{"label":"Sign up","href":"https://gdeltcloud.com/auth/sign-up?next=%2Fapi-keys"},{"label":"Status","href":"https://status.gdeltcloud.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.gdeltcloud.com","keywords":"GDELT Cloud, geopolitical risk API, global event data API, structured event data, GDELT alternative, news API, MCP server for events, conflict event data, OSINT data API, energy asset data, entity resolution","og:type":"website","og:site_name":"GDELT Cloud","twitter:card":"summary_large_image","twitter:site":"@GDELTCloud","robots":"index, follow","author":"GDELT Cloud","language":"en"},"indexing":"all"},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gdeltcloud","hasAudioNarration":false,"actualSubdomain":"gdeltcloud","customDomains":["docs.gdeltcloud.com"],"gitSource":{"type":"github","owner":"ledgerw","repo":"gdelt-cloud","deployBranch":"production","contentDirectory":"gdelt-cloud-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adaae5f07ea8ad7a6970b0f"},"chroma":{"liveDeploymentHistoryId":"6ae21bd9f8179dd8087b4a66","collectionId":"4367061b-7c1e-4d09-b4b3-b6cdcc84cb82","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae21bd9f8179dd8087b4a66"},"feedback":{"agentFeedback":true},"entitlements":{},"buildId":"6ae21bd9f8179dd8087b4a66","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":122},{"language":"default","tag":"Data Reference","count":26},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Monitors","count":16},{"language":"default","tag":"Maritime","count":12},{"language":"default","tag":"CAMEO+ domain codes","count":10},{"language":"default","tag":"AI Compute","count":10},{"language":"default","tag":"Situations","count":9},{"language":"default","tag":"Data","count":7},{"language":"default","tag":"Energy","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--gdelt-docs-font:\"Inter\", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif}#body-content,#content-area,#content-container,#header,#navbar,#navigation-items,#page-context-menu,#page-title,#sidebar,#sidebar-content,#table-of-contents,#table-of-contents-content,.prose,body,h1,h2,h3,h4,h5,h6,html{font-family:var(--gdelt-docs-font)!important}#page-title,h1,h2,h3,h4,h5,h6{letter-spacing:0}button,input,select,textarea{font-family:inherit}#table-of-contents{max-height:calc(100vh - 7rem);overflow-y:auto;overscroll-behavior:contain}"}],"page":{"pagePath":"api-reference/reference-data/gleif-level-2-relationships","slug":"/api-reference/reference-data/gleif-level-2-relationships","pageMetadata":{"title":"GLEIF Level-2 relationships","description":"Parent/child relationship records as filed with the Global LEI System. `lei` matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the `can_use_gleif` entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries `meta.attributions[]` with GLEIF's required non-endorsement notice.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/relationships","href":"/api-reference/reference-data/gleif-level-2-relationships","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Parent/child relationship records as filed with the Global LEI System. \", _jsx(_components.code, {\n children: \"lei\"\n }), \" matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the \", _jsx(_components.code, {\n children: \"can_use_gleif\"\n }), \" entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries \", _jsx(_components.code, {\n children: \"meta.attributions[]\"\n }), \" with GLEIF’s required non-endorsement notice.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GLEIF Level-2 relationships","description":"Parent/child relationship records as filed with the Global LEI System. `lei` matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the `can_use_gleif` entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries `meta.attributions[]` with GLEIF's required non-endorsement notice.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/relationships","href":"/api-reference/reference-data/gleif-level-2-relationships","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"get-gleif-relationships-v2","summary":"GLEIF Level-2 relationships","description":"Parent/child relationship records as filed with the Global LEI System. `lei` matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the `can_use_gleif` entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries `meta.attributions[]` with GLEIF's required non-endorsement notice.","tags":["Reference Data"],"parameters":["a3bce463-7a1c-43e3-a83d-2a427bc72913","43741842-c3d8-4c6d-a2c9-9d2561f45130","64c5c7fc-a2da-4539-a078-4a8e950832cb","2b36befd-d070-47b7-9ea0-84fdea1f9ddb","ecdbb071-9c93-4b1e-8da5-9861938b17e0"],"security":["2a87e80a-1fd4-4330-a078-488627d7cee2"],"responses":{"200":"d6dc16ef-7791-400d-b602-4ad281a0df60","400":"e172495b-0f58-4c3c-9afa-5aafd55fe604","403":"229a1ae2-df51-41ce-8266-5c6f99155391"},"x-plan-feature":"can_use_gleif","method":"get","type":"path","servers":["cfb1f1ac-89ab-48cc-a3ad-82d050c6eb46","9e615e9b-181f-41cf-b4dc-9737ebcd2612"],"path":"/api/v2/gleif/relationships","baseUrlOptions":["https://gdeltcloud.com","http://localhost:3000"],"title":"GLEIF Level-2 relationships","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"a3bce463-7a1c-43e3-a83d-2a427bc72913":{"name":"lei","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Match relationships where this LEI is either endpoint. Must pass the ISO 17442 check digit.","uniqueKey":"","typeLabel":"string"},"description":"Match relationships where this LEI is either endpoint. Must pass the ISO 17442 check digit.","example":"7LTWFZYICNSX8D621K86"},"43741842-c3d8-4c6d-a2c9-9d2561f45130":{"name":"relationship_type","in":"query","required":false,"schema":{"type":"string","enum":["IS_DIRECTLY_CONSOLIDATED_BY","IS_ULTIMATELY_CONSOLIDATED_BY","IS_INTERNATIONAL_BRANCH_OF","IS_FUND-MANAGED_BY","IS_SUBFUND_OF","IS_FEEDER_TO"],"isRequired":false,"description":"e.g. IS_DIRECTLY_CONSOLIDATED_BY, IS_ULTIMATELY_CONSOLIDATED_BY, IS_INTERNATIONAL_BRANCH_OF. Validated — 400 INVALID_ENUM otherwise. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_type","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"e.g. IS_DIRECTLY_CONSOLIDATED_BY, IS_ULTIMATELY_CONSOLIDATED_BY, IS_INTERNATIONAL_BRANCH_OF. Validated — 400 INVALID_ENUM otherwise. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_type","example":"IS_DIRECTLY_CONSOLIDATED_BY"},"64c5c7fc-a2da-4539-a078-4a8e950832cb":{"name":"relationship_status","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"ACTIVE or INACTIVE. Observed vocabulary, measured 2026-08-10 (3 distinct values). Values outside it are accepted, not rejected. Discover current values: `GET /api/v2/gleif/relationships?lei=\u003clei> — read `status``. The status of a GLEIF relationship record. Unlike `relationship_type` beside it, this one is uppercased and passed through unvalidated, so it is published as measured. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_status","uniqueKey":"","typeLabel":"string"},"description":"ACTIVE or INACTIVE. Observed vocabulary, measured 2026-08-10 (3 distinct values). Values outside it are accepted, not rejected. Discover current values: `GET /api/v2/gleif/relationships?lei=\u003clei> — read `status``. The status of a GLEIF relationship record. Unlike `relationship_type` beside it, this one is uppercased and passed through unvalidated, so it is published as measured. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_status","example":"ACTIVE"},"2b36befd-d070-47b7-9ea0-84fdea1f9ddb":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50,"isRequired":false,"description":"Rows to return.","uniqueKey":"","typeLabel":"integer"},"description":"Rows to return."},"ecdbb071-9c93-4b1e-8da5-9861938b17e0":{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","minimum":0,"isRequired":false,"description":"Offset cursor.","uniqueKey":"","typeLabel":"integer"},"description":"Offset cursor."}},"responses":{"d6dc16ef-7791-400d-b602-4ad281a0df60":{"description":"Relationship records with `pagination`, `applied_filters` and `meta`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"start_node_lei":{"type":"string","description":"Child in the consolidation relationship.","uniqueKey":"data.items.[INDEX].start_node_lei","typeLabel":"string"},"end_node_lei":{"type":"string","description":"Parent in the consolidation relationship.","uniqueKey":"data.items.[INDEX].end_node_lei","typeLabel":"string"},"child_lei":{"type":"string","description":"Explicit child alias of start_node_lei.","uniqueKey":"data.items.[INDEX].child_lei","typeLabel":"string"},"parent_lei":{"type":"string","description":"Explicit parent alias of end_node_lei.","uniqueKey":"data.items.[INDEX].parent_lei","typeLabel":"string"},"relationship_type":{"type":"string","uniqueKey":"data.items.[INDEX].relationship_type","typeLabel":"string"},"relationship_status":{"type":"string","uniqueKey":"data.items.[INDEX].relationship_status","typeLabel":"string"},"accounting_standard":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].accounting_standard.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].accounting_standard.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].accounting_standard","typeLabel":"string | null"}},"description":"Reported accounting consolidation; no ownership percentages or natural persons.","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"},"pagination":{"type":"object","properties":{"limit":{"type":"number","uniqueKey":"pagination.limit","typeLabel":"number"},"cursor":{"type":"number","uniqueKey":"pagination.cursor","typeLabel":"number"},"next_cursor":{"oneOf":[{"type":"number","uniqueKey":"pagination.next_cursor.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"pagination.next_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.next_cursor","typeLabel":"number | null"}},"description":"Numeric continuation offset; copy next_cursor into the next request cursor. Null ends this page walk.","uniqueKey":"pagination","typeLabel":"object"},"applied_filters":{"type":"object","properties":{},"uniqueKey":"applied_filters","typeLabel":"object"},"meta":{"type":"object","properties":{},"description":"Source attribution, coverage and evidence interpretation; unknown coverage is not zero.","uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"example","value":{"success":true,"data":[{"child_lei":"5493001KJTIIGC8Y1R12","parent_lei":"213800D1EI4B9WTWWD28","relationship_type":"IS_DIRECTLY_CONSOLIDATED_BY"}],"pagination":{"limit":25,"next_cursor":null},"applied_filters":{"child_lei":"5493001KJTIIGC8Y1R12"},"meta":{"attributions":[{"source":"GLEIF","license":"CC0"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"e172495b-0f58-4c3c-9afa-5aafd55fe604":{"description":"Invalid parameter — `code` is one of INVALID_LEI, INVALID_ENUM, INVALID_LIMIT or FILTER_REQUIRED, with `details.accepted_values` where an enum was rejected.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"229a1ae2-df51-41ce-8266-5c6f99155391":{"description":"PLAN_REQUIRED — the caller's plan lacks `can_use_gleif`.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"2a87e80a-1fd4-4330-a078-488627d7cee2":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"gdelt_sk_...","description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"cfb1f1ac-89ab-48cc-a3ad-82d050c6eb46":{"url":"https://gdeltcloud.com","description":"Production"},"9e615e9b-181f-41cf-b4dc-9737ebcd2612":{"url":"http://localhost:3000","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"gdelt_sk_...","description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi-v2.json"},"subdomain":"gdeltcloud","siteName":"GDELT Cloud","title":"GLEIF Level-2 relationships - GDELT Cloud","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T16:01:13.526Z","originalFileLocation":"api-reference/reference-data/gleif-level-2-relationships.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF\u0026#x27;s required non-endorsement notice.\">\u003cmeta data-mint-head name=\"keywords\" content=\"GDELT Cloud, geopolitical risk API, global event data API, structured event data, GDELT alternative, news API, MCP server for events, conflict event data, OSINT data API, energy asset data, entity resolution\">\u003cmeta data-mint-head name=\"application-name\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GLEIF Level-2 relationships - GDELT Cloud\">\u003cmeta data-mint-head property=\"og:description\" content=\"Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF\u0026#x27;s required non-endorsement notice.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GDELT Cloud\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gdeltcloud.mintlify.app/_mintlify/api/og/v2?division=Reference+Data\u0026amp;title=GLEIF+Level-2+relationships\u0026amp;description=Parent%2Fchild+relationship+records+as+filed+with+the+Global+LEI+System.+%60lei%60+matches+EITHER+endpoint.+Note+the+direction+convention+in+the+source+data%3A+the+star\u0026amp;theme=656db59d762b3e0e53f3f90d\u0026amp;signature=73773b56ff6d1d2e6075c0c6c74edd0a31a37ba25fdb552d862c859e8c247ad6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GLEIF Level-2 relationships - GDELT Cloud\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF\u0026#x27;s required non-endorsement notice.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gdeltcloud.mintlify.app/_mintlify/api/og/v2?division=Reference+Data\u0026amp;title=GLEIF+Level-2+relationships\u0026amp;description=Parent%2Fchild+relationship+records+as+filed+with+the+Global+LEI+System.+%60lei%60+matches+EITHER+endpoint.+Note+the+direction+convention+in+the+source+data%3A+the+star\u0026amp;theme=656db59d762b3e0e53f3f90d\u0026amp;signature=73773b56ff6d1d2e6075c0c6c74edd0a31a37ba25fdb552d862c859e8c247ad6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00A3E6\">\u003cmeta data-mint-head name=\"author\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/reference-data/gleif-level-2-relationships.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gdeltcloud.com/#organization\",\"name\":\"GDELT Cloud\",\"url\":\"https://docs.gdeltcloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gdeltcloud/KTGJpOMcmte0oOTe/logo/light.png?fit=max\u0026auto=format\u0026n=KTGJpOMcmte0oOTe\u0026q=85\u0026s=a78b03b47abd8cab8440d155ed680c34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gdeltcloud.com#website\",\"name\":\"GDELT Cloud\",\"url\":\"https://docs.gdeltcloud.com\",\"publisher\":{\"@id\":\"https://docs.gdeltcloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships#webpage\",\"url\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships\",\"name\":\"GLEIF Level-2 relationships\",\"description\":\"Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.\",\"dateModified\":\"2026-10-28T16:01:13.526Z\",\"isPartOf\":{\"@id\":\"https://docs.gdeltcloud.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference Data\",\"item\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-legal-entities-open-feed\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GLEIF Level-2 relationships\",\"item\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships#apireference\",\"headline\":\"GLEIF Level-2 relationships\",\"name\":\"GLEIF Level-2 relationships\",\"description\":\"Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.\",\"url\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gdeltcloud.com/api-reference/reference-data/gleif-level-2-relationships#webpage\"},\"dateModified\":\"2026-10-28T16:01:13.526Z\",\"publisher\":{\"@id\":\"https://docs.gdeltcloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gdeltcloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GDELT Cloud\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GDELT Cloud","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Events","pages":[{"title":"Search Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events","href":"/api-reference/events/search-events"},{"title":"Get Event","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/{event_id}","href":"/api-reference/events/get-event"},{"title":"Get Event Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/{event_id}/stories","href":"/api-reference/events/get-event-stories"},{"title":"Summarize Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/summary","href":"/api-reference/events/summarize-events"}]},{"group":"Stories","pages":[{"title":"Search Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories","href":"/api-reference/stories/search-stories"},{"title":"Get Story","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/{story_id}","href":"/api-reference/stories/get-story"},{"title":"Get Story Articles","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/{story_id}/articles","href":"/api-reference/stories/get-story-articles"},{"title":"Summarize Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/summary","href":"/api-reference/stories/summarize-stories"}]},{"group":"Situations","pages":[{"title":"List Situations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations","href":"/api-reference/situations/list-situations"},{"title":"Create or expand a shared Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/situations","href":"/api-reference/situations/create-or-expand-a-shared-situation"},{"title":"Get a Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}","href":"/api-reference/situations/get-a-situation"},{"title":"List all linked entities in a stored Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/entities","href":"/api-reference/situations/list-all-linked-entities-in-a-stored-situation"},{"title":"List a Situation's stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/stories","href":"/api-reference/situations/list-a-situations-stories"},{"title":"List a Situation's events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/events","href":"/api-reference/situations/list-a-situations-events"},{"title":"List Situation membership connections chronologically","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/connections","href":"/api-reference/situations/list-situation-membership-connections-chronologically"},{"title":"Read a retained Situation brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/brief","href":"/api-reference/situations/read-a-retained-situation-brief"},{"title":"List retained Situation editions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/editions","href":"/api-reference/situations/list-retained-situation-editions"}]},{"group":"Entities","pages":[{"title":"Discover entities in reporting","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities","href":"/api-reference/entities/discover-entities-in-reporting"},{"title":"Get Entity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}","href":"/api-reference/entities/get-entity"},{"title":"Corporate hierarchy for a resolved entity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/hierarchy","href":"/api-reference/entities/corporate-hierarchy-for-a-resolved-entity"},{"title":"Entity tone (by entity)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/tone","href":"/api-reference/entities/entity-tone-by-entity"},{"title":"Entity Dossier — the statecraft timeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/dossier","href":"/api-reference/entities/entity-dossier-—-the-statecraft-timeline"},{"title":"Read publication activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/activity","href":"/api-reference/entities/read-publication-activity"},{"title":"Share of Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/share-of-voice","href":"/api-reference/entities/share-of-voice"}]},{"group":"Unified Search","pages":[{"title":"Unified cross-source entity search","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/search","href":"/api-reference/unified-search/unified-cross-source-entity-search"}]},{"group":"Media Intelligence","pages":[{"title":"Entity tone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entity-tone","href":"/api-reference/media-intelligence/entity-tone"},{"title":"List tone runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entity-tone/runs","href":"/api-reference/media-intelligence/list-tone-runs"},{"title":"Trigger a tone run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/entity-tone/runs","href":"/api-reference/media-intelligence/trigger-a-tone-run"},{"title":"Tone run status","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entity-tone/runs/{run_id}","href":"/api-reference/media-intelligence/tone-run-status"}]},{"group":"Facilities","pages":[{"title":"Search Facilities","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities","href":"/api-reference/facilities/search-facilities"},{"title":"Get Facility","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}","href":"/api-reference/facilities/get-facility"},{"title":"Facility context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/context","href":"/api-reference/facilities/facility-context"},{"title":"List Facility registry units","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/units","href":"/api-reference/facilities/list-facility-registry-units"},{"title":"Facility relationships","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/relationships","href":"/api-reference/facilities/facility-relationships"},{"title":"Facility source observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/observations","href":"/api-reference/facilities/facility-source-observations"},{"title":"Inspect a bounded Facilities example","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facility-examples/{slug}","href":"/api-reference/facilities/inspect-a-bounded-facilities-example"}]},{"group":"Monitors","pages":[{"title":"List Monitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors","href":"/api-reference/monitors/list-monitors"},{"title":"Create Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors","href":"/api-reference/monitors/create-monitor"},{"title":"Get Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}","href":"/api-reference/monitors/get-monitor"},{"title":"Delete Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json delete /api/v2/monitors/{id}","href":"/api-reference/monitors/delete-monitor"},{"title":"Update Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json patch /api/v2/monitors/{id}","href":"/api-reference/monitors/update-monitor"},{"title":"Preview Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/preview","href":"/api-reference/monitors/preview-monitor"},{"title":"Batch enable, pause, or delete","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/batch","href":"/api-reference/monitors/batch-enable-pause-or-delete"},{"title":"List triggered Monitor runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs","href":"/api-reference/monitors/list-triggered-monitor-runs"},{"title":"Get a triggered Monitor run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}","href":"/api-reference/monitors/get-a-triggered-monitor-run"},{"title":"Send a test webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/{id}/test-delivery","href":"/api-reference/monitors/send-a-test-webhook"},{"title":"Page a run's matched items","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}/matches","href":"/api-reference/monitors/page-a-runs-matched-items"},{"title":"Export a run's matched items as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}/matches.csv","href":"/api-reference/monitors/export-a-runs-matched-items-as-csv"},{"title":"Run a saved Monitor now","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/{id}/run-now","href":"/api-reference/monitors/run-a-saved-monitor-now"},{"title":"Try a signed demo webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/demo-webhook","href":"/api-reference/monitors/try-a-signed-demo-webhook"}]},{"group":"Saved Queries","pages":[{"title":"List saved queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/saved-queries","href":"/api-reference/saved-queries/list-saved-queries"},{"title":"Save a query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/saved-queries","href":"/api-reference/saved-queries/save-a-query"},{"title":"Get a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/get-a-saved-query"},{"title":"Delete a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json delete /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/delete-a-saved-query"},{"title":"Update a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json patch /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/update-a-saved-query"}]},{"group":"Geography","pages":[{"title":"List Admin1 Values","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/geo/admin1","href":"/api-reference/geography/list-admin1-values"},{"title":"Read country activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/countries","href":"/api-reference/geography/read-country-activity"},{"title":"Get country context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/countries/{iso3}","href":"/api-reference/geography/get-country-context"}]},{"group":"Government","pages":[{"title":"Federal Awards (USAspending)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gov/awards","href":"/api-reference/government/federal-awards-usaspending"},{"title":"Foreign Agents (FARA)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gov/fara","href":"/api-reference/government/foreign-agents-fara"}]},{"group":"Political Offices","pages":[{"title":"List Offices","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices","href":"/api-reference/political-offices/list-offices"},{"title":"Get Office","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices/{office_id}","href":"/api-reference/political-offices/get-office"},{"title":"List Office Holders","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices/{office_id}/holders","href":"/api-reference/political-offices/list-office-holders"},{"title":"List Entity Offices","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/offices","href":"/api-reference/political-offices/list-entity-offices"}]},{"group":"Filings","pages":[{"title":"List SEC filings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings","href":"/api-reference/filings/list-sec-filings"},{"title":"Summarize filings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/summary","href":"/api-reference/filings/summarize-filings"},{"title":"Material events (8-K)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/events","href":"/api-reference/filings/material-events-8-k"},{"title":"Filer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}","href":"/api-reference/filings/filer-profile"},{"title":"Filer relations (LLM)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}/relations","href":"/api-reference/filings/filer-relations-llm"},{"title":"Filer XBRL facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}/facts","href":"/api-reference/filings/filer-xbrl-facts"},{"title":"Resolve to CIK","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/resolve","href":"/api-reference/filings/resolve-to-cik"}]},{"group":"Reference Data","pages":[{"title":"GLEIF legal entities (Open Feed)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/entities","href":"/api-reference/reference-data/gleif-legal-entities-open-feed"},{"title":"One GLEIF entity, with its relationships and ISINs","description":"The full Level-1 record for a single LEI plus its Level-2 relationships, any declared reporting exceptions, and its LEI↔ISIN mappings. A structurally impossible LEI returns 400 INVALID_LEI (it fails the ISO 17442 check digit); a well-formed LEI we do not hold returns 404. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the `can_use_gleif` entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries `meta.attributions[]` with GLEIF's required non-endorsement notice.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/entities/{lei}","href":"/api-reference/reference-data/one-gleif-entity-with-its-relationships-and-isins"},{"title":"GLEIF Level-2 relationships","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/relationships","href":"/api-reference/reference-data/gleif-level-2-relationships"},{"title":"LEI ↔ ISIN mappings","description":"Resolve an LEI to its issued ISINs, or an ISIN back to its LEI. One of `lei` or `isin` is required — the mapping table holds ~9M rows and an unfiltered listing is refused with 400 FILTER_REQUIRED. Plan-gated: requires the `can_use_gleif` entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries `meta.attributions[]` with GLEIF's required non-endorsement notice.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/isin","href":"/api-reference/reference-data/lei-↔-isin-mappings"}]},{"group":"Energy","pages":[{"title":"Search Energy Assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets","href":"/api-reference/energy/search-energy-assets"},{"title":"Summarize Energy Assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets/summary","href":"/api-reference/energy/summarize-energy-assets"},{"title":"Map Energy Assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets/map","href":"/api-reference/energy/map-energy-assets"},{"title":"Get Energy Asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets/{tracker}/{gem_id}","href":"/api-reference/energy/get-energy-asset"},{"title":"Search Energy Owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/owners","href":"/api-reference/energy/search-energy-owners"},{"title":"Get Energy Owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/owners/{entity_id}","href":"/api-reference/energy/get-energy-owner"},{"title":"GEM gas project finance","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/finance","href":"/api-reference/energy/gem-gas-project-finance"}]},{"group":"AI Compute","pages":[{"title":"AI models","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/models","href":"/api-reference/ai-compute/ai-models"},{"title":"AI hardware","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/hardware","href":"/api-reference/ai-compute/ai-hardware"},{"title":"AI data centers","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/data-centers","href":"/api-reference/ai-compute/ai-data-centers"},{"title":"AI companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/companies","href":"/api-reference/ai-compute/ai-companies"},{"title":"AI chip sales","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/chip-sales","href":"/api-reference/ai-compute/ai-chip-sales"},{"title":"GPU clusters","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/gpu-clusters","href":"/api-reference/ai-compute/gpu-clusters"},{"title":"AI chip owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/chip-owners","href":"/api-reference/ai-compute/ai-chip-owners"},{"title":"AI chip users","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/chip-users","href":"/api-reference/ai-compute/ai-chip-users"},{"title":"AI chip components","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/chip-components","href":"/api-reference/ai-compute/ai-chip-components"},{"title":"Epoch observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/epoch/observations","href":"/api-reference/ai-compute/epoch-observations"}]},{"group":"Macro Finance","pages":[{"title":"List FRED series","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/series","href":"/api-reference/macro-finance/list-fred-series"},{"title":"Get FRED series detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/series/{series_id}","href":"/api-reference/macro-finance/get-fred-series-detail"},{"title":"List FRED observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/observations","href":"/api-reference/macro-finance/list-fred-observations"},{"title":"List FRED releases","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/releases","href":"/api-reference/macro-finance/list-fred-releases"}]},{"group":"Screening and Reference","pages":[{"title":"Screen a counterparty","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/screening/match","href":"/api-reference/screening-and-reference/screen-a-counterparty"},{"title":"Ownership-chain exposure","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/exposure","href":"/api-reference/screening-and-reference/ownership-chain-exposure"},{"title":"List catalog","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists","href":"/api-reference/screening-and-reference/list-catalog"},{"title":"Search list entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists/entries","href":"/api-reference/screening-and-reference/search-list-entries"},{"title":"List change feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists/changes","href":"/api-reference/screening-and-reference/list-change-feed"}]},{"group":"China","pages":[{"title":"China dev-finance projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/china/projects","href":"/api-reference/china/china-dev-finance-projects"},{"title":"China dev-finance rollup","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/china/projects/summary","href":"/api-reference/china/china-dev-finance-rollup"}]},{"group":"Maritime","pages":[{"title":"Chokepoint transit activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/transits","href":"/api-reference/maritime/chokepoint-transit-activity"},{"title":"Current vessels (last-known)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/vessels","href":"/api-reference/maritime/current-vessels-last-known"},{"title":"Vessel by IMO","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/carriers/{imo}","href":"/api-reference/maritime/vessel-by-imo"},{"title":"Chokepoint dwell episodes","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/dwell","href":"/api-reference/maritime/chokepoint-dwell-episodes"},{"title":"AIS-dark gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/gaps","href":"/api-reference/maritime/ais-dark-gaps"},{"title":"Area activity over time","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/activity","href":"/api-reference/maritime/area-activity-over-time"},{"title":"Spatial density grid","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/density","href":"/api-reference/maritime/spatial-density-grid"},{"title":"Raw position points in an area","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/tracks","href":"/api-reference/maritime/raw-position-points-in-an-area"},{"title":"One vessel's track over time","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/vessels/{imo}/track","href":"/api-reference/maritime/one-vessels-track-over-time"},{"title":"Ports reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/ports","href":"/api-reference/maritime/ports-reference"},{"title":"Port disruption pulse","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/port-pulse","href":"/api-reference/maritime/port-disruption-pulse"},{"title":"Chokepoint risk watch","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/chokepoint-watch","href":"/api-reference/maritime/chokepoint-risk-watch"}]},{"group":"Atlas Intelligence","pages":[{"title":"Atlas GPR — geopolitical risk vs a place’s own normal","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/gpr","href":"/api-reference/atlas-intelligence/atlas-gpr-—-geopolitical-risk-vs-a-place’s-own-normal"},{"title":"Atlas Posture — country condition and annual context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/posture","href":"/api-reference/atlas-intelligence/atlas-posture-—-country-condition-and-annual-context"},{"title":"Atlas coverage — where the index can and cannot be read","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/coverage","href":"/api-reference/atlas-intelligence/atlas-coverage-—-where-the-index-can-and-cannot-be-read"}]},{"group":"Natural Resources","pages":[{"title":"Natural-resource statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/resources/statistics","href":"/api-reference/natural-resources/natural-resource-statistics"}]},{"group":"Meta","pages":[{"title":"Value vocabularies, machine-readable","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/enums","href":"/api-reference/meta/value-vocabularies-machine-readable"},{"title":"Endpoint contracts, machine-readable","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/endpoints","href":"/api-reference/meta/endpoint-contracts-machine-readable"},{"title":"What a call costs, and what your plan allows","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/query-units","href":"/api-reference/meta/what-a-call-costs-and-what-your-plan-allows"}]}]},{"tab":"Data Reference","pages":[{"title":"Data Reference","href":"/reference"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"title":"GLEIF Level-2 relationships - GDELT Cloud","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}