GET /api/v1/us/financial-statements

Returns full financial statement line items from SEC filings including balance sheet, income statement, and cash flow.

Request

GET /api/v1/us/financial-statements

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
cik	string	No	exact	SEC CIK
ticker	string	No	exact	Stock ticker
accession_number	string	No	exact	Accession number
statement_type	string	No	exact	BalanceSheet, IncomeStatement, CashFlow
concept	string	No	exact	XBRL concept
fiscal_year	string	No	exact	Fiscal year
fiscal_period	string	No	exact	Fiscal period
date_from	string	No	range	Start date
date_to	string	No	range	End date
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default period_end)
order	asc | desc	No	—	Sort direction (default desc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/us/financial-statements?ticker=AAPL&statement_type=BalanceSheet&limit=10"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "accession_number": "0000320193-24-000123",
      "fiscal_year": "2024",
      "fiscal_period": "FY",
      "statement_type": "BalanceSheet",
      "concept": "us-gaap:CashAndCashEquivalentsAtCarryingValue",
      "label": "Cash and cash equivalents",
      "value": 23453000000,
      "unit": "USD",
      "period_start": "2024-09-29",
      "period_end": "2024-09-29",
      "source": "sec",
      "updated_at": "2024-11-01T00:00:00Z"
    }
  ],
  "meta": {
    "total": 10,
    "limit": 10,
    "offset": 0,
    "has_more": false
  }
}