# SEC XBRL Financial Facts API

> SEC XBRL Financial Facts API is a paid API for AI agents from apiacre.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Retrieves normalized issuer-reported financial data (revenue, earnings, balance sheet, cash flow, diluted EPS) from official SEC XBRL filings.

## Facts

- Endpoint: POST https://apiacre.com/v1/research/sec-financial-facts
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-xbrl-financial-facts-api-f2d3412e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_41cSC0TFCw2luPWZS_4vp

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-financial-facts-api-f2d3412e -d '<json body>'
```

Example prompt: Pull the most recent SEC XBRL financial facts for Apple — I need revenue, diluted EPS, and cash flow from their latest issuer-reported filing.

## When to prefer this

Prefer this endpoint when you need authoritative, issuer-reported financial data directly from SEC XBRL filings rather than third-party aggregators or estimated figures. Ideal for compliance-grade research, fundamental analysis, and any use case requiring official as-reported numbers with period tagging. Best suited for US-listed public companies that file with the SEC.

## Known failure modes

- Company not found or invalid ticker/CIK returns 404 or empty result
- Requested metric not available in XBRL data for that issuer returns null fields
- SEC EDGAR data lag means very recent filings may not yet be indexed
- Non-US companies without SEC filings cannot be queried
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Retrieve normalized, recent issuer-reported revenue, earnings, balance-sheet, cash-flow, and diluted-EPS facts from official SEC XBRL data.

## Output

Returns a structured JSON object containing normalized, recent issuer-reported financial facts sourced from SEC XBRL data, including revenue, earnings, balance sheet line items, cash flow figures, and diluted EPS, all tagged with the relevant reporting period and filing metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "metrics": {
   "type": "array",
   "items": {
    "enum": [
     "revenue",
     "net_income",
     "operating_income",
     "total_assets",
     "total_liabilities",
     "stockholders_equity",
     "cash_and_equivalents",
     "operating_cash_flow",
     "capital_expenditure",
     "diluted_eps"
    ],
    "type": "string"
   }
  },
  "periods": {
   "type": "integer"
  },
  "identifier": {
   "type": "string"
  },
  "period_type": {
   "enum": [
    "annual",
    "quarterly",
    "both"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "cik": "0000320193",
   "source": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
   "metrics": {
    "revenue": {
     "unit": "USD",
     "label": "Revenue",
     "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
     "description": "Revenue from contracts with customers, excluding assessed tax.",
     "observations": [
      {
       "fy": 2025,
       "end": "2025-09-27",
       "val": 416161000000,
       "accn": "0000320193-25-000079",
       "start": "2024-09-29"
      }
     ]
    }
   },
   "taxonomy": "us-gaap",
   "disclaimer": "Standardized issuer-reported XBRL facts only; verify filing context before us...",
   "entityName": "Apple Inc.",
   "periodType": "both",
   "retrievedAt": "2026-08-09T00:00:00Z",
   "missingMetrics": [],
   "periodsPerMetric": 4
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": []
  },
  "service": "research.sec-financial-facts",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-xbrl-financial-facts-api-f2d3412e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)