Skip to main content
GET
/
filings
/
items
Get SEC filing items
curl --request GET \
  --url https://api.financialdatasets.ai/filings/items \
  --header 'X-API-KEY: <api-key>'
{
  "resource": "<string>",
  "ticker": "<string>",
  "cik": "<string>",
  "filing_type": "<string>",
  "accession_number": "<string>",
  "year": 123,
  "quarter": 123,
  "items": [
    {
      "number": "<string>",
      "name": "<string>",
      "text": "<string>",
      "exhibits": [
        {
          "number": "<string>",
          "description": "<string>",
          "url": "<string>",
          "text": "<string>"
        }
      ]
    }
  ]
}

​
Overview

The Items endpoint allows you to retrieve the raw text from the sections (called items) from a given 10-K, 10-Q, or 8-K filing. This lets you easily extract data from a filing without having to parse the entire document on your own. For 8-K filings, items may include an exhibits array when exhibits are present. Use the include_exhibits parameter to retrieve the raw text content of linked exhibits.

​
Available Tickers

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

​
Valid Item Types

You can fetch a list of valid item types for 10-K and 10-Q filings with a GET request to: https://api.financialdatasets.ai/filings/items/types/ You can optionally filter by filing type using the filing_type query parameter:
  • https://api.financialdatasets.ai/filings/items/types/?filing_type=10-K - returns only 10-K item types
  • https://api.financialdatasets.ai/filings/items/types/?filing_type=10-Q - returns only 10-Q item types
The response includes the item name and title for each valid item type.

​
Examples

import requests

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

# set your query params
ticker = 'AAPL'
filing_type = '10-K'
year = 2023

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

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

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

​
Handling slow filings (503 retry-after)

When you request items from a filing that isn’t already in our cache, we parse it from the SEC and serve it to you. Most filings complete in well under a second. For large 8-Ks with multiple HTML exhibits, the first request to a brand-new filing may take longer. If the parse doesn’t complete within ~15 seconds, we return a 503 Service Unavailable and continue parsing in the background. Your retry will hit a warm cache. 
HTTP/1.1 503 Service Unavailable
Retry-After: 30
Content-Type: application/json

{
  "error": "Filing parse in progress",
  "message": "We are processing this filing. Please retry in ~30 seconds.",
  "accession_number": "0001277902-25-000182",
  "retry_after_seconds": 30
}
What to do:
  • Honor the Retry-After header (most HTTP clients do this automatically when configured).
  • Subsequent requests for the same filing will return immediately from cache.
  • This response only affects the first request to an uncached filing — once cached, all future requests are fast.
Example with retry handling (Python): 
import time
import requests

def get_filing_items_with_retry(url, headers, max_attempts=3):
    for attempt in range(max_attempts):
        response = requests.get(url, headers=headers)
        if response.status_code == 503:
            retry_after = int(response.headers.get("Retry-After", 30))
            time.sleep(retry_after)
            continue
        return response
    return response

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string
required

The ticker symbol.

​
filing_type
enum<string>
required

The type of filing.

Available options:
10-K,
10-Q,
8-K
​
year
integer
required

The year of the filing.

​
quarter
integer

The quarter of the filing if 10-Q.

​
item
enum<string>

The item to get.

Available options:
Item-1,
Item-1A,
Item-1B,
Item-2,
Item-3,
Item-4,
Item-5,
Item-6,
Item-7,
Item-7A,
Item-8,
Item-9,
Item-9A,
Item-9B,
Item-10,
Item-11,
Item-12,
Item-13,
Item-14,
Item-15,
Item-16,
Item-1.01,
Item-1.02,
Item-1.03,
Item-1.04,
Item-2.01,
Item-2.02,
Item-2.03,
Item-2.04,
Item-2.05,
Item-2.06,
Item-3.01,
Item-3.02,
Item-3.03,
Item-4.01,
Item-4.02,
Item-5.01,
Item-5.02,
Item-5.03,
Item-5.04,
Item-5.05,
Item-5.06,
Item-5.07,
Item-5.08,
Item-6.01,
Item-6.02,
Item-6.03,
Item-6.04,
Item-6.05,
Item-7.01,
Item-8.01,
Item-9.01
​
accession_number
string

The accession number of the filing if 8-K.

​
include_exhibits
boolean
default:false

Whether to include the raw text from linked exhibits. Only applicable for 8-K filings. When true, exhibit objects will include the 'text' field containing the full exhibit content.

Response

SEC filing items response

​
resource
string

The resource type identifier.

​
ticker
string

The ticker symbol of the company.

​
cik
string

The Central Index Key (CIK) of the company.

​
filing_type
string

The type of filing.

​
accession_number
string

The accession number of the filing.

​
year
integer

The year of the filing.

​
quarter
integer

The quarter of the filing.

​
items
object[]