# SEC XBRL Financials Endpoint

> SEC XBRL Financials Endpoint is a paid API for AI agents from company-enrichment.x402tookit.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-30).

Returns headline annual financial metrics for a US public company from SEC XBRL data: revenue, net income, assets, liabilities, cash flow, and financial health flags.

## Facts

- Endpoint: GET https://company-enrichment.x402tookit.com/sec-financials?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-xbrl-financials-endpoint-e5c5174d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qUaepA5zREY7Av6nC_K2K

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-xbrl-financials-endpoint-e5c5174d
```

Example prompt: Pull the headline annual financials for Tesla from SEC XBRL data — I want revenue, net income, total assets, debt-to-assets ratio, operating cash flow, and any financial health flags.

## When to prefer this

Choose this endpoint when you need structured, machine-readable annual financial metrics for a US public company derived directly from SEC XBRL filings. It is ideal for financial screening, due diligence, or portfolio monitoring workflows where you want standardized balance sheet, income statement, and cash flow figures with built-in health flags, rather than parsing raw SEC filings yourself or using a paid financial data provider.

## Known failure modes

- Unknown ticker or CIK returns null fields or empty response
- Company has incomplete XBRL data resulting in degraded=true and some null fields
- Non-US or non-public company not found in SEC EDGAR
- Rate limiting or payment failure with x402 protocol returns 402 status
- Very recent filings not yet indexed return stale or prior-year data

## How this service works

Headline annual financials for a US public company from XBRL: revenue, profit, assets, debt-to-assets, cash flow, flags.

## Output

Returns a JSON object with the company name, CIK, fiscal year end date, and headline financials: revenue, net income, total assets, total liabilities, shareholders equity, operating cash flow, cash, liabilities-to-assets ratio, net margin percentage, and revenue growth percentage. Also includes a verdict string, list of red-flag reasons, a plain-English summary, degraded-data flag, XBRL tags used for each metric, source URL, and disclaimer.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Ticker or CIK"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "cik": {
       "type": [
        "null",
        "number"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "cash": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "company": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "revenue": {
       "type": [
        "null",
        "number"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "tagsUsed": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "cash": {
         "type": [
          "null",
          "string"
         ]
        },
        "assets": {
         "type": [
          "null",
          "string"
         ]
        },
        "equity": {
         "type": [
          "null",
          "string"
         ]
        },
        "revenue": {
         "type": [
          "null",
          "string"
         ]
        },
        "netIncome": {
         "type": [
          "null",
          "string"
         ]
        },
        "liabilities": {
         "type": [
          "null",
          "string"
         ]
        },
        "operatingCashFlow": {
         "type": [
          "null",
          "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-xbrl-financials-endpoint-e5c5174d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from company-enrichment.x402tookit.com](https://www.zero.xyz/host/company-enrichment.x402tookit.com/llms.txt)