v1
latestOpenAPI 3.0.32026-07-226744340.8 KBFiler 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) — the Corporate & Supply Chain plan and above.
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.
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.
Rows per page (1–200).
Pagination 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 }.