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",
      "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/

​
🚀 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'

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

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

# parse filings from the response
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>

The type of filing.

Available options:
10-K,
10-Q,
8-K,
4,
144

Response

200
application/json

SEC filings response

The response is of type object.