Items
Get specific sections and items from SEC filings, like Item 1A Risk Factors or Item 7 MD&A.
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 anexhibits array when exhibits are present. Use the include_exhibits parameter to retrieve the raw text content of linked exhibits.
Coverage
| Tickers | Years of Coverage | Updated |
|---|---|---|
| 22,000+ | 30+ years | Real-time |
Available Tickers
You can fetch a list of available tickers with aGET 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 aGET 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 typeshttps://api.financialdatasets.ai/filings/items/types/?filing_type=10-Q- returns only 10-Q item typeshttps://api.financialdatasets.ai/filings/items/types/?filing_type=8-K- returns only 8-K item types
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 theitem 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
- 10-K Filing
- 10-Q Filing
- 8-K Filing
- Specific Items
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 returns202 Accepted with a result_url to poll. Your request is never dropped.
result_url with the same X-API-KEY header. Each poll returns one of three responses:
| Response | Meaning | What to do |
|---|---|---|
{"status": "processing", ...} | Still preparing the filing | Wait Retry-After seconds, then poll again |
| The filing items payload | Ready | Done. You are billed once, on this response |
{"status": "failed", ...} | The filing could not be prepared | Re-request GET /filings/items with your original parameters |
- 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_urlis simply the version that can also tell you definitively that a filing failed.
Error handling
Requests with mismatched parameters fail immediately with a400 instead of being accepted for processing. The error message always names the correct value so you can fix the request in one step.
| Status | Error | Meaning | What to do |
|---|---|---|---|
400 | Filing type mismatch | The accession number belongs to a different form type than filing_type | Retry with the filing_type named in the message |
400 | Filing company mismatch | The accession number belongs to a different company than ticker | Retry with the ticker named in the message |
404 | Filing not found | The accession number does not exist on SEC EDGAR for this ticker | Verify the accession number and ticker |
404 | Items not found in filing | At least one requested item is not in this filing (common for 8-Ks, which contain only the items the company reported) | The message lists the items the filing does contain. Retry with those, or drop the item filter to get all items. You are not billed |
404 | No data found | The filing exists but contains no extractable items | Nothing to retry. You are not billed |
200 {"status": "failed"} | Returned by result_url | The filing could not be prepared | Re-request GET /filings/items with your original parameters |
Authorizations
API key for authentication.
Query Parameters
The ticker symbol.
The type of filing.
10-K, 10-Q, 8-K The year of the filing.
The quarter of the filing if 10-Q.
The item to get.
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 The accession number of the filing if 8-K.
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
The resource type identifier.
The ticker symbol of the company.
The Central Index Key (CIK) of the company.
The type of filing.
The accession number of the filing.
The year of the filing.
The quarter of the filing.