---
title: "List SEC filings"
method: GET
path: "/api/v2/filings"
tags: ["Filings"]
---

# List SEC filings

`GET /api/v2/filings`

List the SEC EDGAR filing index by company (CIK), form type, name, and date window. 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
- `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'
- `search` string
- `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'
- `sort` 'recent' | 'filer'
- `limit` integer
- `cursor` string

## Response `200`

A page of filings, most recent first (or grouped by filer when sort=filer). Each row: accession_no, cik, company_name, form_type, file_date, is_amendment (bool), primary_doc_url, biz_country_iso2 (when known), items (form-specific item tags, when present). Standard envelope: { success, data, pagination, sort, applied_filters }.

- object
  - `success` boolean
  - `data` object[]
    - `accession_no` string
    - `cik` integer
    - `company_name` string
    - `form_type` string
    - `file_date` string
    - `is_amendment` boolean
    - `primary_doc_url` string
    - `biz_country_iso2` string
    - `items` string[]
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `sort` string
  - `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)