Skip to main content
GET
Filer relations (LLM)

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Path Parameters

cik
integer
required

SEC CIK number.

Query Parameters

rel_type
enum<string>

Filter to one relation kind: subsidiary | supplier | customer | counterparty | partner | jurisdiction_exposure | risk_factor (Item 1A risk themes). Omit for all.

Available options:
subsidiary,
supplier,
customer,
counterparty,
partner,
jurisdiction_exposure,
risk_factor
country
string

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.

Example:

"Vietnam"

limit
integer
default:50

Rows per page (1–200).

Required range: x <= 200
cursor
string

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 }.

success
boolean
cik
integer
data
object[]
pagination
object
applied_filters
object