Company financials (SEC XBRL numbers) API

Get a US company's actual financial numbers from its SEC filings, across any period: revenue, net income, gross/operating income, EPS, assets, liabilities, equity, cash flow, R&D, shares — or any raw XBRL concept. Plain metric names are mapped to the right GAAP tags for you. Answers queries like 'Apple revenue last 5 years', 'Microsoft net income quarterly', 'what was Tesla's gross profit in 2023', 'total assets over time'.

Price$0.01per request

MethodPOST

Route/v1/finance/edgar-financials

StatusLive

MIME typeapplication/json

Rate limit40/minute

Cache3600s public

financesecedgarfinancialsxbrlrevenuenet-incomefundamentals10-kearnings

API URLhttps://x402.hexl.dev/v1/finance/edgar-financials

Integration docs

Example request

{
  "ticker": "AAPL",
  "metrics": [
    "revenue",
    "netIncome",
    "eps"
  ],
  "period": "annual",
  "limit": 3
}

Example response

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company": "Apple Inc.",
  "period": "annual",
  "metrics": {
    "revenue": {
      "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
      "unit": "USD",
      "values": [
        {
          "value": 391035000000,
          "unit": "USD",
          "fiscalYear": 2024,
          "fiscalPeriod": "FY",
          "periodStart": "2023-10-01",
          "periodEnd": "2024-09-28",
          "form": "10-K",
          "filed": "2024-11-01"
        }
      ]
    }
  },
  "notFound": []
}

Input schema

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "examples": [
        "AAPL",
        "MSFT",
        "TSLA"
      ]
    },
    "metrics": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Plain names (revenue, netIncome, eps, totalAssets...) or raw us-gaap concepts. Defaults to a key-metrics snapshot.",
      "examples": [
        [
          "revenue",
          "netIncome",
          "eps"
        ]
      ]
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "all"
      ],
      "default": "annual"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 8,
      "description": "max periods per metric, most recent first"
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "ticker",
    "cik",
    "company",
    "metrics"
  ],
  "properties": {
    "ticker": {
      "type": "string"
    },
    "cik": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "metrics": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "concept": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "values": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "number"
                },
                "unit": {
                  "type": "string"
                },
                "fiscalYear": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "fiscalPeriod": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "periodStart": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "periodEnd": {
                  "type": "string"
                },
                "form": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "filed": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "notFound": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}