# Finanz XBRL Filing to JSON

> Finanz XBRL Filing to JSON is a paid API for AI agents from finanz.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Parses a company's SEC EDGAR XBRL filings and returns a standardized set of financial statement figures (income statement, balance sheet, cash flow) per reporting period.

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/filing-to-json
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finanz-xbrl-filing-to-json-a0f03a51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AXAKtEPFxAoKuj1QVSgs-

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 finanz-xbrl-filing-to-json-a0f03a51 -d '<json body>'
```

Example prompt: Pull Apple's standardized financial figures from its latest SEC EDGAR XBRL filing — I need revenue, gross profit, net income, EPS, assets, liabilities, equity, cash, operating cash flow, and capex all in one structured JSON.

## When to prefer this

Choose this endpoint when you need standardized, machine-readable financial statement data from SEC EDGAR XBRL filings for US public companies, especially when you want a consistent schema across companies and periods without writing your own XBRL parser. It is ideal for financial modeling, earnings analysis, and agent workflows that need structured fundamentals. Prefer this over raw SEC EDGAR APIs when you want pre-normalized figures and a single JSON response per filing rather than raw XBRL taxonomies.

## Known failure modes

- Company not found on SEC EDGAR (invalid ticker or CIK returns error)
- XBRL data not available for requested filing period
- Requested financial line item missing from company's XBRL taxonomy (returns null or omits field)
- SEC EDGAR rate limiting or downtime causing retrieval failure
- Malformed or non-standard XBRL filing causing parsing errors

## How this service works

Reads a company XBRL facts from SEC EDGAR and returns a consistent set of figures per reporting period: revenue, cost of revenue, gross and operating profit, net income, basic and diluted EPS, assets, liabilities, equity, cash, operating cash flow and capital expenditure.

## Output

A structured JSON object containing a consistent set of financial figures per reporting period, including: revenue, cost of revenue, gross profit, operating profit, net income, basic EPS, diluted EPS, total assets, total liabilities, equity, cash, operating cash flow, and capital expenditure — sourced and normalized from the company's SEC EDGAR XBRL data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 4,
   "maximum": 12,
   "minimum": 1,
   "description": "How many periods, newest first."
  },
  "issuer": {
   "type": "string",
   "maxLength": 40,
   "description": "Ticker such as AAPL, or a CIK number."
  },
  "period": {
   "enum": [
    "annual",
    "quarterly"
   ],
   "type": "string",
   "default": "annual",
   "description": "Which reporting periods to return."
  },
  "metrics": {
   "type": "array",
   "items": {
    "enum": [
     "revenue",
     "cost_of_revenue",
     "gross_profit",
     "operating_income",
     "net_income",
     "eps_basic",
     "eps_diluted",
     "assets",
     "liabilities",
     "equity",
     "cash",
     "operating_cash_flow",
     "capex",
     "shares_outstanding"
    ],
    "type": "string"
   },
   "description": "Restrict to these metrics."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finanz-xbrl-filing-to-json-a0f03a51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)