# TBS SEC Filings API

> TBS SEC Filings API is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Retrieves recent SEC EDGAR filings for any US public company by ticker or CIK, with optional form type filtering, returning filing metadata and direct archive URLs.

## Facts

- Endpoint: GET https://x402.tbs-digital.com/sec/filings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-sec-filings-api-4b72b1f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gbl4hRRIMBxru4xVJf3oY

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 tbs-sec-filings-api-4b72b1f7
```

Example prompt: Can you pull the last 5 SEC filings for Microsoft — specifically 10-K and 10-Q forms — and give me the filing dates and direct SEC archive links?

## When to prefer this

Use this endpoint when an AI agent needs fast, keyless access to SEC EDGAR filing metadata for US public companies by ticker or CIK, without needing to build SEC EDGAR API integrations. Ideal for investment research bots, compliance monitors, and fundamental analysis workflows that need filing dates, accession numbers, and direct archive links in a unified schema. Prefer over direct SEC EDGAR scraping when a normalized, agent-friendly JSON response is required.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty filings array
- CIK not found in SEC EDGAR returns no results
- Invalid form type filter returns empty results or error
- Limit out of range (outside 1-50) may return an error or be clamped
- Network or upstream SEC EDGAR unavailability causes request failure
- Payment not processed via x402 protocol results in 402 response

## How this service works

Recent SEC EDGAR filings for any US public company, for AI agents and research bots. Query by stock ticker or CIK, optionally filter by form type (10-K, 10-Q, 8-K), and get each filing's form, filing date, accession number, primary document and a direct SEC Archives URL. Sourced from SEC EDGAR submissions — keyless, unified schema.

## Output

Returns a JSON object containing the company's metadata, a list of filings each with form type, filing date, accession number, primary document filename, and a direct SEC Archives URL, plus a filing count, request ID, generation timestamp, and source attribution.

## 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 CIK, e.g. 320193 (or use ticker)"
      },
      "type": {
       "type": "string",
       "description": "Form type filter, e.g. 10-K (optional)"
      },
      "limit": {
       "type": "string",
       "description": "Max filings 1-50 (default 20)"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker, e.g. AAPL (or use cik)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "company": {
       "type": "object"
      },
      "filings": {
       "type": "array"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-sec-filings-api-4b72b1f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)