Skip to main content
GET
Get SEC filing items

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.

Coverage

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, 10-Q, and 8-K 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
  • https://api.financialdatasets.ai/filings/items/types/?filing_type=8-K - returns only 8-K item types
The response includes the item name, title, and description for each valid item type. 8-K item names follow the SEC’s numbering scheme in the format Item-X.XX, for example Item-1.01, Item-2.02, Item-5.02, Item-8.01, and Item-9.01.

Filtering by item

Use the item query parameter (repeatable) to return only the items you need. This works for all three filing types. Because a given 8-K contains only the items the company chose to report, requesting an item that is not in the filing returns a 404 that names the missing items and the items the filing does contain (see Error handling).

Examples

Asynchronous requests (202 Accepted)

Most requests return data immediately. The first request for a filing we haven’t processed yet can take longer. If your filing isn’t ready within ~10 seconds, the API returns 202 Accepted with a result_url to poll. Your request is never dropped.
Poll result_url with the same X-API-KEY header. Each poll returns one of three responses: Example with polling (Python):
Good to know:
  • Most filings are ready within 30 seconds. If a filing can’t be prepared within 5 minutes, polling returns failed.
  • You are only billed when data is delivered. A 202, a processing poll, or a failed request never costs anything.
  • Retrying your original request URL also works: once the filing is ready, the same request returns it immediately. The result_url is simply the version that can also tell you definitively that a filing failed.

Error handling

Requests with mismatched parameters fail immediately with a 400 instead of being accepted for processing. The error message always names the correct value so you can fix the request in one step.
400 Filing type mismatch
404 Items not found in filing

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[]