---
title: "Summarize filings"
method: GET
path: "/api/v2/filings/summary"
tags: ["Filings"]
---

# Summarize filings

`GET /api/v2/filings/summary`

Rollup of filings by form type, date, or filer — counts + distinct filers. 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
- `group_by` 'form_type' | 'date' | 'filer'
- `form_type` '10-K' | '10-Q' | '8-K' | '13F-HR' | 'SCHEDULE 13D' | 'SCHEDULE 13G' | '3' | '4' | '5' | 'DEF 14A' | 'S-1' | '20-F' | '6-K'
- `country` string
- `region` 'Africa' | 'Asia' | 'Middle East' | 'Northern Africa' | 'Western Africa' | 'Eastern Africa' | 'Middle Africa' | 'Southern Africa' | 'Europe' | 'Eastern Europe' | 'South Asia' | 'Southeast Asia' | 'East Asia' | 'Central Asia' | 'North America' | 'Central America' | 'Caribbean' | 'South America' | 'Oceania'
- `continent` 'Africa' | 'Asia' | 'Europe' | 'North America' | 'South America' | 'Oceania'
- `limit` integer

## Response `200`

Filing counts bucketed by group_by (form_type | date | filer), highest count first. Each row carries the bucket key (form_type, date, or cik), filings (count) and — except when grouping by filer — filers (distinct CIKs). Envelope: { success, group_by, data, applied_filters }.

- object
  - `success` boolean
  - `group_by` string
  - `data` object[]
    - `form_type` string
    - `filings` integer
    - `filers` integer
  - `applied_filters` object
    - `date_start` string
    - `date_end` string
    - `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)