# 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-12).

Retrieves XBRL financial facts from SEC EDGAR for a given company (by ticker or CIK), returning reported us-gaap concepts like revenues, net income, assets, liabilities, and EPS with period and form metadata.

## Facts

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

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-13f9bfb0
```

Example prompt: Pull the SEC EDGAR financial facts for Apple — ticker AAPL — and filter to just the Revenues concept so I can see what they've been reporting each fiscal year.

## When to prefer this

Choose this endpoint when you need structured, schema-normalized XBRL financial facts sourced directly from SEC EDGAR filings, especially for fundamental analysis of US public companies. It is keyless and uses a unified schema, making it ideal for AI agents that need quick access to reported financials without managing API keys or parsing raw EDGAR JSON. Prefer it over direct EDGAR API calls when you want a simplified, pay-per-call interface with consistent output format.

## Known failure modes

- Invalid or unknown ticker returns empty facts array or error
- CIK not found in SEC EDGAR returns no results
- Requested us-gaap concept does not exist for the company returns empty array
- Missing required ticker or CIK parameter returns validation error
- Rate limiting or payment failure returns 402 error
- SEC EDGAR data lag may mean very recent filings are not yet reflected

## How this service works

XBRL company financial facts from SEC EDGAR for AI agents and fundamental-analysis bots. Query by stock ticker or CIK for reported us-gaap concepts — revenues, net income, assets, liabilities, EPS and more — each with its latest value, unit, fiscal year and period, form and period-end date. Optionally filter to one concept. Keyless, USD, unified schema.

## Output

Returns a structured JSON object containing an array of financial facts for the requested company, each with the us-gaap concept name, reported value, unit (e.g. USD), fiscal year, reporting period, SEC form type (e.g. 10-K, 10-Q), and period-end date. Also includes company metadata, request ID, generation timestamp, count of returned facts, and payer/network info.

## 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)"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker, e.g. AAPL (or use cik)"
      },
      "concept": {
       "type": "string",
       "description": "us-gaap concept filter, e.g. Revenues (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "facts": {
       "type": "array"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "company": {
       "type": "object"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-sec-filings-api-13f9bfb0/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)