> ## Documentation Index > Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Material events (8-K) > 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. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /api/v2/filings/events openapi: 3.0.3 info: title: GDELT Cloud API v2 version: 2.0.0 description: >- Clean v2 REST API for generated GDELT Cloud structured Events, clustered Stories, linked Entities, summaries, admin1 discovery, significance ranking, and paginated article evidence. Event significance is a family-scoped weighted blend, renormalized so every event family spans a true 0-1: each event's raw total is divided by the maximum its own family can reach (Conflict 1.00, CAMEO+ POLITICAL 0.90, other CAMEO+ domains 0.65). All events: Goldstein severity 0.25, article evidence 0.05, confidence 0.05. Conflict only: fatalities 0.55 (log-scaled by body count) and civilian targeting 0.10. CAMEO+ only: magnitude 0.20, systemic importance 0.15, propagation potential 0.10, market sensitivity 0.10. When magnitude is unmeasured its term AND its 0.20 weight are both dropped. The four CAMEO+ metrics are rubric scores produced by published formulas - ordinal ranking signals, not measurements, probabilities, or predicted price moves. goldstein_scale is one canonical public metric, populated for Conflict Events and CAMEO+ POLITICAL Events where meaningful. Story linked_event_count is a Story-to-Event link aggregate, not a distinct Event total. servers: - url: https://gdeltcloud.com description: Production - url: http://localhost:3000 description: Local development security: - ApiKeyAuth: [] tags: - name: Events description: Coded CAMEO+ / conflict events — search, fetch, and summarize. - name: Stories description: Clustered narratives (stories) and their articles. - name: Entities description: >- People & organizations — resolve a name to an entity, then fetch its profile and tone. - name: Geography description: Admin-1 geography lookups. - name: Energy description: Global Energy Monitor assets + ownership registry. - name: Facilities description: >- Unified physical-asset directory — GEM energy assets + World Port Index ports + Epoch AI data centers on one keyed surface, resolved to spine owners. Plan-gated (Analyst plan and up). - name: Screening and Reference description: >- Restricted-party lists, screening, and ownership-chain exposure. Plan-gated (`can_use_screening` / `can_use_exposure`). - name: China description: >- China overseas development finance (AidData GCDF). Plan-gated (`can_use_china`). - name: Media Intelligence description: >- Entity tone (`can_use_tone`) and Share of Voice (`can_use_share_of_voice`) are plan-gated. Social signal remains an admin-only preview. - name: Filings description: >- SEC EDGAR filings, XBRL financials, and AI-extracted relations. Requires a plan with SEC filings access (`can_use_filings`) — the Corporate & Supply Chain plan and above. - name: Macro Finance description: >- FRED economic time series (catalog, point-in-time observations, releases). Plan-gated (`can_use_macro`). - name: Maritime description: >- AIS-derived vessel-flow signals across maritime chokepoints — chokepoint transits, last-known vessel positions, carriers, dwell, and AIS-dark gaps. Plan-gated (`can_use_maritime`). - name: Briefs description: Source-backed monitoring briefs. paths: /api/v2/filings/events: get: tags: - Filings summary: Material events (8-K) description: >- 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. operationId: list-material-events-v2 parameters: - name: date_start in: query required: false schema: type: string description: Window start YYYY-MM-DD (≤30-day window). - name: date_end in: query required: false schema: type: string description: Window end YYYY-MM-DD. - name: date in: query required: false schema: type: string description: Anchor date YYYY-MM-DD (use with days). - name: days in: query required: false schema: type: integer minimum: 1 maximum: 30 description: Trailing N-day window (1–30, default 30). - name: cik in: query required: false schema: type: string description: One or more CIK numbers (comma-separated). - name: event_type in: query required: false schema: type: string enum: - acquisition - disposition - material_agreement - executive_change - results - guidance - restructuring - impairment - delisting - bankruptcy - other description: >- Filter to one classified event type. Full set: acquisition | disposition | material_agreement | executive_change | results | guidance | restructuring | impairment | delisting | bankruptcy | other. Matched exactly; omit for all. - name: search in: query required: false schema: type: string description: Case-insensitive substring match on the event headline. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 200 default: 50 description: Rows per page (1–200, default 50). - name: cursor in: query required: false schema: type: string description: Pagination cursor (opaque offset). responses: '200': description: >- 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 }. content: application/json: schema: type: object properties: success: type: boolean data: type: array items: type: object properties: event_uid: type: string cik: type: integer company_name: type: string accession_no: type: string item_code: type: string event_type: type: string headline: type: string counterparties: type: array items: {} amount_text: type: string resolved_entity_ids: type: array items: {} confidence: type: number event_date: type: string model: type: string pagination: type: object properties: limit: type: integer cursor: {} next_cursor: {} applied_filters: type: object properties: date_start: type: string date_end: type: string cik: type: array items: type: integer ignored: type: object properties: {} examples: example: summary: GET /api/v2/filings/events — example response value: success: true data: - event_uid: 9c8b7a6d5e4f30211029384756abcdef cik: 65270 company_name: METHODE ELECTRONICS INC accession_no: 0000065270-26-000058 item_code: '2.02' event_type: results headline: >- Methode Electronics reported fiscal fourth-quarter net sales of $260.1 million and a net loss of $0.79 per share, citing softer automotive demand and program transition costs. counterparties: [] amount_text: $260.1 million resolved_entity_ids: [] confidence: 0.93 event_date: '2026-06-18' model: gpt-5.4-mini:8k:v1 - event_uid: 1f2e3d4c5b6a70819283746556fedcba cik: 65270 company_name: METHODE ELECTRONICS INC accession_no: 0000065270-26-000052 item_code: '5.02' event_type: executive_change headline: >- Methode Electronics announced the appointment of Jonathan B. DeGaynor as President and Chief Executive Officer, effective June 9, 2026, succeeding the interim CEO. counterparties: - Jonathan B. DeGaynor amount_text: null resolved_entity_ids: - ent_7e3a1c89d2b4 confidence: 0.96 event_date: '2026-06-09' model: gpt-5.4-mini:8k:v1 pagination: limit: 50 cursor: null next_cursor: null applied_filters: date_start: '2026-05-30' date_end: '2026-06-28' cik: - 65270 ignored: {} '401': description: Missing/invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Plan required (PLAN_REQUIRED) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyAuth: [] components: schemas: ErrorResponse: type: object properties: success: type: boolean enum: - false error: type: string code: type: string details: type: object description: >- Recoverable validation context when available, such as param, invalid_value, accepted_values, nearest_values, and a corrected example. additionalProperties: true securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: gdelt_sk_... description: 'GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.' ````