curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/{cik}/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/{cik}/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/{cik}/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"cik": 65270,
"data": [
{
"relation_uid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"rel_type": "subsidiary",
"source": "ex21",
"subject_name": "Methode Electronics, Inc.",
"object_name": "Hetronic Germany GmbH",
"object_country_iso3": "DEU",
"object_commodity": null,
"ownership_pct": 100,
"amount_usd": null,
"amount_text": null,
"pct_value": null,
"evidence": "Hetronic Germany GmbH (Germany) — 100% owned, included in the list of subsidiaries filed as Exhibit 21.1 to this Annual Report on Form 10-K.",
"resolved_entity_id": "ent_4d9a2f31c7b8",
"confidence": 0.97,
"model": "gpt-5.4-nano:ex21:v1",
"accession_no": "0000065270-26-000041"
},
{
"relation_uid": "f0e9d8c7b6a51403928f7e6d5c4b3a21",
"rel_type": "supplier",
"source": "item1",
"subject_name": "Methode Electronics, Inc.",
"object_name": "Taiwan Semiconductor Manufacturing Company",
"object_country_iso3": "TWN",
"object_commodity": "semiconductors",
"ownership_pct": null,
"amount_usd": 84000000,
"amount_text": "approximately $84 million",
"pct_value": null,
"evidence": "We source a significant portion of our application-specific integrated circuits from foundry partners in Taiwan, and a disruption in that supply could materially affect our Automotive segment.",
"resolved_entity_id": "ent_2b7c9e14a6d3",
"confidence": 0.84,
"model": "gpt-5.4-mini:item1:v1",
"accession_no": "0000065270-26-000041"
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"cik": 65270,
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Filer relations (LLM)
Subsidiary / supplier / customer / jurisdiction edges for a filer, derived from filing text through GDELT Cloud’s proprietary AI pipeline and resolved to entity_ids with evidence. Requires a plan with SEC filings access (can_use_filings) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/{cik}/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/{cik}/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/{cik}/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"cik": 65270,
"data": [
{
"relation_uid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"rel_type": "subsidiary",
"source": "ex21",
"subject_name": "Methode Electronics, Inc.",
"object_name": "Hetronic Germany GmbH",
"object_country_iso3": "DEU",
"object_commodity": null,
"ownership_pct": 100,
"amount_usd": null,
"amount_text": null,
"pct_value": null,
"evidence": "Hetronic Germany GmbH (Germany) — 100% owned, included in the list of subsidiaries filed as Exhibit 21.1 to this Annual Report on Form 10-K.",
"resolved_entity_id": "ent_4d9a2f31c7b8",
"confidence": 0.97,
"model": "gpt-5.4-nano:ex21:v1",
"accession_no": "0000065270-26-000041"
},
{
"relation_uid": "f0e9d8c7b6a51403928f7e6d5c4b3a21",
"rel_type": "supplier",
"source": "item1",
"subject_name": "Methode Electronics, Inc.",
"object_name": "Taiwan Semiconductor Manufacturing Company",
"object_country_iso3": "TWN",
"object_commodity": "semiconductors",
"ownership_pct": null,
"amount_usd": 84000000,
"amount_text": "approximately $84 million",
"pct_value": null,
"evidence": "We source a significant portion of our application-specific integrated circuits from foundry partners in Taiwan, and a disruption in that supply could materially affect our Automotive segment.",
"resolved_entity_id": "ent_2b7c9e14a6d3",
"confidence": 0.84,
"model": "gpt-5.4-mini:item1:v1",
"accession_no": "0000065270-26-000041"
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"cik": 65270,
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
SEC CIK number.
Query Parameters
Filter to one relation kind: subsidiary | supplier | customer | counterparty | partner | jurisdiction_exposure | risk_factor (Item 1A risk themes). Omit for all. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_rel_type
subsidiary, supplier, customer, counterparty, partner, jurisdiction_exposure, risk_factor Filter to relation edges whose counterparty (object) jurisdiction matches this country — useful on jurisdiction_exposure edges. Accepts a country name (Vietnam), ISO-2 (VN), or ISO-3 (VNM) via the shared resolveCountryInput layer, matched against the edge's object_country_iso3; an unresolvable value returns 400 INVALID_COUNTRY.
"Vietnam"
Rows per page (1–200).
x <= 200Pagination cursor (opaque offset).
Response
A page of LLM-extracted relation edges, by rel_type then confidence. Each row: rel_type, source, subject_name, object_name, object_country_iso3, object_commodity, ownership_pct (or null), evidence (supporting quote), resolved_entity_id (entity-spine id, when resolved), confidence (0–1), model (extraction model version), accession_no. Envelope: { success, cik, data, pagination, applied_filters }.

