---
title: "Filer relations (LLM)"
method: GET
path: "/api/v2/filings/{cik}/relations"
tags: ["Filings"]
---

# Filer relations (LLM)

`GET /api/v2/filings/{cik}/relations`

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

- `cik` integer, required

## Query parameters

- `rel_type` 'subsidiary' | 'supplier' | 'customer' | 'counterparty' | 'partner' | 'jurisdiction_exposure' | 'risk_factor'
- `country` string
- `limit` integer
- `cursor` string

## Response `200`

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

- object
  - `success` boolean
  - `cik` integer
  - `data` object[]
    - `relation_uid` string
    - `rel_type` string
    - `source` string
    - `subject_name` string
    - `object_name` string
    - `object_country_iso3` string
    - `object_commodity` unknown
    - `ownership_pct` integer
    - `amount_usd` unknown
    - `amount_text` unknown
    - `pct_value` unknown
    - `evidence` string
    - `resolved_entity_id` string
    - `confidence` number
    - `model` string
    - `accession_no` string
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `applied_filters` object
    - `cik` integer
    - `ignored` object

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED)
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)