# SEC EDGAR Filings Lookup

> SEC EDGAR Filings Lookup is a paid API for AI agents from agents.crowdspark.me, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Retrieves recent SEC EDGAR filings for a US-listed company by ticker or CIK, with form type, dates, 8-K item codes, accession numbers, and direct document links.

## Facts

- Endpoint: GET https://agents.crowdspark.me/v1/finance/sec-filings?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-filings-lookup-7d4525f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uMcThZDjT1ITd143Xhz4v

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-edgar-filings-lookup-7d4525f0
```

Example prompt: Pull the last 5 SEC EDGAR filings for Apple (ticker AAPL), focusing on 8-K and 10-Q forms filed since 2024-01-01.

## When to prefer this

Use this endpoint when you need structured, ready-to-use SEC filing metadata — including 8-K item labels and direct document links — without scraping EDGAR yourself. Ideal for finance agents that need to monitor regulatory disclosures, surface earnings events, or retrieve specific form types by ticker. Prefer over raw EDGAR APIs when you want pre-parsed item codes and plain-English labels in one call.

## Known failure modes

- Unknown ticker or CIK returns empty filings array or error
- Invalid form type string returns no results or validation error
- since date in wrong format (not YYYY-MM-DD) may cause filter to be ignored or error
- limit outside 1-40 range may be clamped or rejected
- Rate limit exceeded on free tier (25 calls/day per IP) without paid header returns 402
- Company with no filings in requested date range returns matched: 0

## How this service works

Pay-per-call utilities for AI agents over x402, USDC on Base.

## Output

Returns a JSON object with company metadata (CIK, name, tickers, exchanges, SIC description), a list of filings each containing form type, filing and report dates, amendment flag, 8-K item codes with plain-English labels, accession number, and a direct SEC document URL. Also includes applied filters and total matched/returned counts.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "Optional SEC CIK number, e.g. 320193"
      },
      "form": {
       "type": "string",
       "description": "Optional form type or comma list, e.g. 8-K,10-Q"
      },
      "limit": {
       "type": "string",
       "description": "1 to 40, default 10"
      },
      "since": {
       "type": "string",
       "description": "Optional earliest filing date, YYYY-MM-DD"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker, e.g. AAPL or BRK-B. Give ticker or cik"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "SEC EDGAR (data.sec.gov, public)",
  "company": {
   "cik": "320193",
   "name": "Apple Inc.",
   "tickers": [
    "AAPL"
   ],
   "exchanges": [
    "Nasdaq"
   ],
   "fiscal_year_end": "0926",
   "sic_description": "Electronic Computers"
  },
  "filings": [
   {
    "form": "8-K",
    "items": [
     {
      "code": "2.02",
      "label": "Results of operations and financial condition"
     },
     {
      "code": "9.01",
      "label": "Financial statements and exhibits"
     }
    ],
    "amendment": false,
    "filing_date": "2026-07-31",
    "report_date": "2026-07-31",
    "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000071/aapl-20260731.htm",
    "accession_number": "0000320193-26-000071"
   }
  ],
  "filters": {
   "form": [
    "8-K"
   ],
   "limit": 3,
   "since": null
  },
  "matched": 12,
  "returned": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-filings-lookup-7d4525f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.crowdspark.me](https://www.zero.xyz/host/agents.crowdspark.me/llms.txt)
