# StableFinance SEC Filing Items API

> StableFinance SEC Filing Items API is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Retrieves specific items (sections) from SEC filings (10-K, 10-Q, 8-K) for a given company ticker, year, and filing type

## Facts

- Endpoint: GET https://stablefinance.dev/api/filings/items
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-sec-filing-items-api-a8f44974
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m1zXVj68PvYmpAgczkeX1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablefinance-sec-filing-items-api-a8f44974
```

Example prompt: Can you pull the Risk Factors section (Item 1A) from Apple's 2024 10-K annual filing?

## When to prefer this

Use this endpoint when you need the full text of specific sections from SEC filings — especially for financial analysis, due diligence, or research tasks requiring the actual language from annual or quarterly reports. Prefer this over general web search when you need structured, authoritative filing content tied to a specific accession number or year.

## Known failure modes

- Missing required parameters (ticker, filing_type, year) returns 400 error
- Unknown or delisted ticker returns empty result or 404
- Filing not found for the specified year/quarter returns empty items array
- Payment failure via x402 returns 402 Payment Required
- Invalid filing_type value (not 10-K, 10-Q, or 8-K) returns validation error
- Quarter specified for a 10-K (annual) filing may return unexpected results

## How this service works

Extracted item-level text from a specific filing (e.g., 10-K Item 1A Risk Factors).

## Output

Returns a JSON object containing the requested filing's items array, where each item has a name (e.g. 'Risk Factors'), item number (e.g. 'Item-1A'), full text content, and any associated exhibits. Also includes metadata like ticker, CIK, accession number, filing type, and year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "filing_type",
      "year"
     ],
     "properties": {
      "item": {
       "type": "string",
       "minLength": 1
      },
      "year": {
       "type": "integer",
       "maximum": 2100,
       "minimum": 1900
      },
      "ticker": {
       "type": "string",
       "minLength": 1
      },
      "quarter": {
       "type": "integer",
       "maximum": 4,
       "minimum": 1
      },
      "filing_type": {
       "enum": [
        "10-K",
        "10-Q",
        "8-K"
       ],
       "type": "string"
      },
      "accession_number": {
       "type": "string",
       "minLength": 1
      },
      "include_exhibits": {
       "type": "boolean"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "resource",
      "ticker",
      "cik",
      "filing_type",
      "accession_number",
      "year",
      "items"
     ],
     "properties": {
      "cik": {
       "type": "string"
      },
      "year": {
       "type": "number"
      },
      "items": {
       "type": "array",
       "items": {}
      },
      "ticker": {
       "type": "string"
      },
      "quarter": {
       "type": "number"
      },
      "resource": {
       "type": "string"
      },
      "filing_type": {
       "type": "string"
      },
      "accession_number": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "year": 2024,
  "items": [
   {
    "name": "Risk Factors",
    "text": "The Company's business, reputation, results of operations, financial condition...",
    "number": "Item-1A",
    "exhibits": []
   }
  ],
  "ticker": "AAPL",
  "resource": "filings",
  "filing_type": "10-K",
  "accession_number": "0000320193-24-000123"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-sec-filing-items-api-a8f44974/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)