Skip to main content
GET
/
filings
Get SEC filings
curl --request GET \
  --url https://api.financialdatasets.ai/filings \
  --header 'X-API-KEY: <api-key>'
{
  "filings": [
    {
      "cik": 123,
      "accession_number": "<string>",
      "filing_type": "<string>",
      "report_date": "2023-12-25",
      "filing_date": "2023-12-25",
      "ticker": "<string>",
      "url": "<string>"
    }
  ]
}

​
Overview

The Filings endpoint allows you to fetch a list of filings for a given company. The endpoint returns all of the filings that the company has filed with the SEC. This includes 10-Ks, 10-Qs, 8-Ks, and more. We have SEC filings for 10,000+ public companies. To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

​
Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/filings/tickers/

​
Available Filing Types

You can fetch a list of valid filing types with a GET request to: https://api.financialdatasets.ai/filings/types/

​
Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add query params like ticker to filter the data.
  3. Execute the API request.
Note: You must include either the ticker in your query params.

​
Example

Filings
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'
limit = 10

# create the URL
url = (
    f'https://api.financialdatasets.ai/filings'
    f'?ticker={ticker}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse filings from the response
filings = response.json().get('filings')

​
Filtering by Filing Type

Use the filing_type query param to filter filings.
  • Single type: ?ticker=AAPL&filing_type=10-K
  • Multiple types: repeat the param (same pattern as multi-item filtering), e.g. ?ticker=AAPL&filing_type=10-Q&filing_type=10-K
FilingsWithMultipleTypes
import requests

headers = {"X-API-KEY": "your_api_key_here"}
url = "https://api.financialdatasets.ai/filings"
params = [
    ("ticker", "AAPL"),
    ("filing_type", "10-Q"),
    ("filing_type", "10-K"),
]

response = requests.get(url, headers=headers, params=params)
filings = response.json().get("filings")

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
cik
string

The Central Index Key (CIK) of the company.

​
ticker
string

The ticker symbol.

​
filing_type
enum<string>[]

Filter by one or more filing types. Repeat the query parameter to pass multiple values (e.g. filing_type=10-Q&filing_type=10-K).

Available options:
10-K,
10-Q,
8-K,
20-F,
6-K
​
limit
integer
default:10

The maximum number of filings to return (default: 10).

Required range: x >= 1

Response

SEC filings response

​
filings
object[]