research · research · sec · xbrl · company · financial-data · financial · fundamentals · earnings · official-data

SEC normalized financial facts

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

$0.02 USDCBasex402 v2POST

Endpoint

https://apiacre.com/v1/research/sec-financial-facts

Send the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.

Input example

{
  "identifier": "AAPL",
  "metrics": [
    "revenue",
    "net_income",
    "total_assets",
    "diluted_eps"
  ],
  "period_type": "both",
  "periods": 4
}

Response shape

View free static sample JSON

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

Try the payment challenge

curl -i -X POST 'https://apiacre.com/v1/research/sec-financial-facts' \
  -H 'content-type: application/json' \
  --data '{"identifier":"AAPL","metrics":["revenue","net_income","total_assets","diluted_eps"],"period_type":"both","periods":4}'