# x402 Agent Hub – SEC Company Filings

> x402 Agent Hub – SEC Company Filings is a paid API for AI agents from x402-agent-hub.x402-agent-hub.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-14).

Retrieves a company's most recent SEC filings, optionally filtered by form type and date, returning filing dates, 8-K item numbers, and direct document links

## Facts

- Endpoint: GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/filings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-hub-sec-company-filings-7f43c555
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tK_a2NWq5tmammvP4V-4D

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 x402-agent-hub-sec-company-filings-7f43c555
```

Example prompt: Pull the last 5 SEC filings for Apple (ticker AAPL), only 10-K and 8-K forms, filed since 2024-01-01, and give me the filing dates and direct document links.

## When to prefer this

Use this endpoint when you need structured, machine-readable SEC filing metadata for US public companies — including direct document URLs — especially when filtering by form type (10-K, 10-Q, 8-K) or date range. It is preferable over scraping SEC EDGAR directly because it returns clean JSON with parsed item numbers and settlement only occurs on successful reads. Choose it over generic financial data APIs when you need the actual SEC filing links rather than just financial metrics.

## Known failure modes

- Invalid or unrecognized ticker returns a not-found error and cancels payment settlement
- Invalid CIK format triggers input validation error with no charge
- Unknown form type filter may return empty results
- SEC EDGAR upstream unavailability causes upstream error with no charge
- Limit parameter outside 1-50 range causes validation failure
- Company has no filings matching the date/form filter returns empty filings array

## How this service works

A company's most recent SEC filings, optionally filtered by form type (e.g. 10-K,8-K) and date, with filing/report dates, 8-K item numbers and direct links to the document and filing index. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Output

Returns a JSON object with the total filing count, company metadata (CIK, legal name, ticker), and an array of filing records each containing the form type, filing date, report date, 8-K item numbers (where applicable), and a direct URL to the SEC document.

## 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",
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC Central Index Key, e.g. 320193 (alternative to ticker)."
      },
      "form": {
       "type": "string",
       "description": "Comma-separated form types, e.g. 10-K,10-Q,8-K."
      },
      "limit": {
       "type": "string",
       "description": "Max filings, 1-50 (default 10)."
      },
      "since": {
       "type": "string",
       "description": "Only filings on/after this date (YYYY-MM-DD)."
      },
      "ticker": {
       "type": "string",
       "description": "US stock ticker, e.g. AAPL or BRK.B. Provide 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": {
  "count": 1,
  "company": {
   "cik": 320193,
   "name": "Apple Inc.",
   "ticker": "AAPL"
  },
  "filings": [
   {
    "form": "8-K",
    "items": "2.02,9.01",
    "filingDate": "2026-07-30",
    "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/..."
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-hub-sec-company-filings-7f43c555/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-hub.x402-agent-hub.workers.dev](https://www.zero.xyz/host/x402-agent-hub.x402-agent-hub.workers.dev/llms.txt)
