# SEC Financials API

> SEC Financials API is a paid API for AI agents from companyfacts.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Retrieves structured financial metrics from SEC filings (10-K, 10-Q) for public companies, returning parsed XBRL data with filing provenance.

## Facts

- Endpoint: GET https://companyfacts.dev/x402/v1/sec-financials?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-financials-api-3a394b77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lvAwMP4KAteLp2srMcar4

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-financials-api-3a394b77
```

Example prompt: What was Apple's net income for fiscal year 2024? Pull it directly from their SEC filing so I can see the verified source.

## When to prefer this

Use this endpoint when you need audited, GAAP-compliant financial figures for a public US company sourced directly from SEC regulatory filings, with full provenance (accession number, verify URL). Prefer this over scraped financial data aggregators when auditability and citation to primary sources matter — e.g. for due diligence, regulatory research, or investor reporting.

## Known failure modes

- Company not found in SEC EDGAR — returns zero matches if name is ambiguous or company is private
- Metric not reported by the company in XBRL — returns empty records array
- Ambiguous period specification — may return multiple records across fiscal years
- Rate limiting or payment failure — 402 response if USDC payment not attached
- Invalid metric name — no matching XBRL tag found in filings

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

Returns a JSON object containing the matched company's CIK, the requested financial metric value (as a number), the fiscal period and dates, filing form type (e.g. 10-K), XBRL tag used, accession number, and a direct URL to the SEC filing index for verification.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "metric": {
       "type": "string"
      },
      "period": {
       "type": "string"
      },
      "company": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "company",
  "count": 1,
  "metric": "net_income",
  "company": {
   "cik": 320193,
   "name": "Apple Inc."
  },
  "matched": 1,
  "records": [
   {
    "cik": 320193,
    "form": "10-K",
    "unit": "USD",
    "filed": "2024-11-01",
    "value": 93736000000,
    "metric": "net_income",
    "company": "Apple Inc.",
    "xbrl_tag": "NetIncomeLoss",
    "accession": "0000320193-24-000123",
    "period_end": "2024-09-28",
    "verify_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm",
    "fiscal_year": 2024,
    "period_days": 363,
    "period_type": "annual",
    "period_start": "2023-10-01",
    "fiscal_period": "FY"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-financials-api-3a394b77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companyfacts.dev](https://www.zero.xyz/host/companyfacts.dev/llms.txt)