Filing Items

GET

filings

items

Get extracted SEC filing sections

curl --request GET \
  --url https://financialdatasets.rip/filings/items \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/filings/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/filings/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/filings/items"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/filings/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "resource": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019326000001/example-10k.htm",
  "ticker": "AAPL",
  "filing_type": "10-K",
  "accession_number": "0000320193-26-000001",
  "year": 2026,
  "quarter": null,
  "items": [
    {
      "number": "Item 1",
      "name": "Business",
      "text": "Illustrative placeholder excerpt only — no live capture for this endpoint exists in this repo. [truncated]"
    }
  ]
}

This route resolves one specific filing, scrapes it, and extracts a named section, “Item 1A Risk Factors” for example, as text. Filing-section extraction uses rule-based parsing against known SEC section boundaries. There is no LLM guessing where a section starts and ends, which is why the extracted text matches the filing verbatim rather than a summary of it.

What this answers

What a specific filing actually says in one section, without downloading and parsing the filing yourself.

Coverage


Provider chain	The `/filings` index, plus Monid Context.dev `/web/scrape/markdown` to fetch and parse the filing
Measured cost	$0.0015 per call (index lookup plus scrape)
Cache TTL	600 seconds, see Caching

Query rules

ticker, filing_type, and year are all required. This is stricter than the Financial Datasets schema, which lets year be omitted so the server resolves the latest matching filing on its own, a capability that exists only over MCP for this server, not on this REST route. include_exhibits=true always answers 400 bad_request, exhibit content is not implemented. item takes one item code per request here, not the array the Financial Datasets schema declares. When no filing matches the request, this route answers HTTP 200 with an ErrorResponse body rather than a 404, at no additional cost.

Worked example

This repo has no committed live capture for /filings/items. The example below is illustrative only, field names follow go/fd/types.go, and the accession number and excerpt text are synthetic placeholders, not a real filing.

curl

curl -s 'https://financialdatasets.rip/filings/items?ticker=AAPL&filing_type=10-K&year=2026&item=Item%201' \
  -H 'X-API-KEY: <your-api-key>'

Item extracted, illustrative

{
  "resource": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019326000001/example-10k.htm",
  "ticker": "AAPL",
  "filing_type": "10-K",
  "accession_number": "0000320193-26-000001",
  "year": 2026,
  "quarter": null,
  "items": [
    {
      "number": "Item 1",
      "name": "Business",
      "text": "Illustrative placeholder excerpt only \u2014 no live capture for this endpoint exists in this repo. [truncated]"
    }
  ]
}

No matching filing

{
  "error": "not_found",
  "message": "No 10-K filing matches ticker AAPL, year 1999."
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

required

Uppercase-normalized ticker symbol.

filing_type

enum<string>

required

The filing type.

Available options:

10-K,

10-Q,

8-K

year

integer

required

The filing year. Required here (see description).

quarter

integer

The fiscal quarter, for 10-Q filings.

Required range: 1 <= x <= 4

accession_number

string

Select an exact filing by SEC accession number, e.g. for 8-K filings.

item

string

A single item code, e.g. Item-1, Item-1A. The FD schema declares this as an array; only one value is accepted per request here. Omit to return every detected section.

include_exhibits

boolean

default:false

Accepted for FD parameter parity but true always answers 400 bad_request; exhibits are not sourced.

Response

Extracted filing sections, or a not_found soft failure (see description).

FilingItemsResponse
ErrorResponse

The unwrapped body returned by GET /filings/items.

resource

string<uri>

required

SEC EDGAR URL of the source filing document.

ticker

string

required

Uppercase ticker symbol.

filing_type

string

required

Normalized filing type: 10-K, 10-Q, or 8-K.

accession_number

string | null

required

SEC EDGAR accession number, or null when the source filing has none.

year

integer

required

Filing year.

quarter

integer | null

required

Fiscal quarter (1-4), or null for a 10-K.

items

FilingItem · object[]

required

Extracted sections. Empty array (never omitted) when nothing matched.

Show child attributes

Get extracted SEC filing sections

curl --request GET \
  --url https://financialdatasets.rip/filings/items \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/filings/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/filings/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/filings/items"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/filings/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "resource": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019326000001/example-10k.htm",
  "ticker": "AAPL",
  "filing_type": "10-K",
  "accession_number": "0000320193-26-000001",
  "year": 2026,
  "quarter": null,
  "items": [
    {
      "number": "Item 1",
      "name": "Business",
      "text": "Illustrative placeholder excerpt only — no live capture for this endpoint exists in this repo. [truncated]"
    }
  ]
}

Overview

Integrations

Datasets

Guides

MCP Tools

What this answers

Coverage

Query rules

Worked example

Authorizations

Query Parameters

Response

​What this answers

​Coverage

​Query rules

​Worked example

Authorizations

Query Parameters

Response

What this answers

Coverage

Query rules

Worked example