---
title: "Material events (8-K)"
method: GET
path: "/api/v2/filings/events"
tags: ["Filings"]
---

# Material events (8-K)

`GET /api/v2/filings/events`

Dated 8-K material corporate events (M&A, material agreements, executive changes, bankruptcies, delistings, impairments) extracted from 8-K bodies, with counterparties resolved into the entity spine. Requires a plan with SEC filings access (`can_use_filings`) — the Corporate & Supply Chain plan and above.

## Query parameters

- `date_start` string
- `date_end` string
- `date` string
- `days` integer
- `cik` string
- `event_type` 'acquisition' | 'disposition' | 'material_agreement' | 'executive_change' | 'results' | 'guidance' | 'restructuring' | 'impairment' | 'delisting' | 'bankruptcy' | 'other'
- `search` string
- `limit` integer
- `cursor` string

## Response `200`

A page of 8-K material events, most recent first. Each row: event_uid, cik, company_name, accession_no, item_code, event_type, headline, counterparties (names mentioned in the disclosure), amount_text (deal/transaction value as disclosed, when present), resolved_entity_ids (counterparties resolved into the entity spine), confidence, event_date. Standard envelope: { success, data, pagination, applied_filters }.

- object
  - `success` boolean
  - `data` object[]
    - `event_uid` string
    - `cik` integer
    - `company_name` string
    - `accession_no` string
    - `item_code` string
    - `event_type` string
    - `headline` string
    - `counterparties` unknown[]
      - unknown
    - `amount_text` string
    - `resolved_entity_ids` unknown[]
      - unknown
    - `confidence` number
    - `event_date` string
    - `model` string
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `applied_filters` object
    - `date_start` string
    - `date_end` string
    - `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)