# SEC Filings Feed EDGAR

> SEC Filings Feed EDGAR is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-13).

Retrieves SEC EDGAR filings (8-K, 10-K, 10-Q, S-1, Form 4, etc.) for a ticker, CIK, or the whole market, with links to each filing, from 1994 to present.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/sec-filings-feed?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-filings-feed-edgar-be69c468
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__PybggF3jRSX4ewj2frzS

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 sec-filings-feed-edgar-be69c468 -d '<json body>'
```

Example prompt: Pull the last 10 SEC filings for Apple (ticker AAPL) from EDGAR — I want 8-Ks and 10-Ks filed in the past 365 days, with links to each filing document.

## When to prefer this

Use this endpoint when you need to discover, list, or monitor SEC EDGAR filings by ticker or CIK — especially for filtering by form type (8-K, 10-K, 10-Q, Form 4, S-1) or specific 8-K item codes. Prefer this over scraping SEC.gov directly for structured, paginated, pay-per-row access with direct document URLs. It is especially suited for agents that need to watch for new filings, pull earnings releases, or build a filing history going back to 1994.

## Known failure modes

- Unknown ticker or CIK returns empty rows with no charge
- Invalid form type string returns empty result
- Date range with no filings returns empty rows
- Request error or server fault returns no charge and no rows
- Exceeding maxResults cap of 200 silently truncates to 200

## How this service works

Data tools for AI agents and analysts: SEC filings, insider trades, company accounts, sanctions, EU law, tenders, contracts. Sourced JSON, pay per result.

## Output

Returns a JSON array of filing rows, each containing the company name, ticker, CIK, form type, filing date, accepted timestamp, accession number, 8-K item codes and descriptions, market timing (before/after close), source URL on SEC.gov, primary document URL, and filing index URL. Also includes metadata: total count, charge in USD, duration, and any warnings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ciks": {
   "type": "array",
   "description": "SEC Central Index Keys as digits, leading zeros optional, e.g. [\"320193\"] for Apple"
  },
  "dateTo": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "Latest filing date, YYYY-MM-DD"
  },
  "tickers": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*$"
   },
   "description": "Company tickers, e.g. [\"AAPL\", \"MSFT\"]"
  },
  "dateFrom": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "Earliest filing date, YYYY-MM-DD, e.g. \"2020-01-01\""
  },
  "formTypes": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "EDGAR form types, exact match"
  },
  "itemCodes": {
   "type": "array",
   "items": {
    "enum": [
     "1.01",
     "1.02",
     "1.03",
     "1.04",
     "1.05",
     "2.01",
     "2.02",
     "2.03",
     "2.04",
     "2.05",
     "2.06",
     "3.01",
     "3.02",
     "3.03",
     "4.01",
     "4.02",
     "5.01",
     "5.02",
     "5.03",
     "5.04",
     "5.05",
     "5.06",
     "5.07",
     "5.08",
     "6.01",
     "6.02",
     "6.03",
     "6.04",
     "6.05",
     "6.06",
     "6.10",
     "7.01",
     "8.01",
     "9.01"
    ],
    "type": "string"
   },
   "description": "Only 8-Ks reporting at least one of these items, as strings"
  },
  "maxResults": {
   "type": "integer",
   "default": 10,
   "maximum": 200,
   "minimum": 1,
   "description": "Maximum filings, newest first, e.g. 10 for a company's latest 10 filings"
  },
  "lookbackDays": {
   "type": "integer",
   "maximum": 12000,
   "minimum": 1,
   "description": "Used only when `dateFrom` is empty: read filings from this many days back until today, e.g. 365"
  },
  "earningsReleasesOnly": {
   "type": "boolean",
   "default": false,
   "description": "true = only 8-Ks with Item 2.02"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "cik": "0000320193",
    "form": "8-K",
    "items": [
     "2.02"
    ],
    "source": "submissions-api",
    "ticker": "AAPL",
    "parties": null,
    "source_url": "https://data.sec.gov/submissions/CIK0000320193.json",
    "accepted_at": "2026-11-02T16:30:23-05:00",
    "filing_date": "2026-11-02",
    "report_date": "2026-11-02",
    "company_name": "Apple Inc.",
    "retrieved_at": "2026-11-05T16:23:00+00:00",
    "market_timing": "after_close",
    "accession_number": "0000320193-26-000024",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000024/0000320193-...",
    "item_descriptions": [
     "Results of Operations and Financial Condition"
    ],
    "primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000024/aapl-202611..."
   }
  ],
  "tool": "sec-filings-feed",
  "count": 1,
  "message": "",
  "paid_via": "x402",
  "warnings": [],
  "balance_usd": 0,
  "charged_usd": 0.05,
  "duration_seconds": 1.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-filings-feed-edgar-be69c468/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
