GET
/
financials
/
{symbol}
Get financial data
curl --request GET \
  --url https://api.financialcontext.com/financials/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "fs_123456",
    "symbol": "AAPL",
    "date": "2023-09-30",
    "period": "annual",
    "fiscal_year": 2023,
    "fiscal_quarter": 4,
    "currency": "USD",
    "income_statement": {
      "revenue": 394328000000,
      "cost_of_revenue": 223546000000,
      "gross_profit": 170782000000,
      "gross_profit_margin": 0.433,
      "research_and_development": 29915000000,
      "selling_general_administrative": 25094000000,
      "total_operating_expenses": 55009000000,
      "operating_income": 115773000000,
      "operating_margin": 0.294,
      "interest_income": 3750000000,
      "interest_expense": 3933000000,
      "income_before_tax": 115590000000,
      "income_tax_expense": 16741000000,
      "net_income": 98849000000,
      "net_profit_margin": 0.251,
      "eps_basic": 6.16,
      "eps_diluted": 6.13,
      "weighted_average_shares_basic": 16049000000,
      "weighted_average_shares_diluted": 16115000000
    },
    "balance_sheet": {
      "cash_and_cash_equivalents": 29965000000,
      "short_term_investments": 31590000000,
      "accounts_receivable": 29508000000,
      "inventory": 6331000000,
      "total_current_assets": 143566000000,
      "property_plant_equipment": 43715000000,
      "goodwill": 0,
      "intangible_assets": 0,
      "long_term_investments": 100544000000,
      "total_assets": 352755000000,
      "accounts_payable": 62611000000,
      "short_term_debt": 15308000000,
      "total_current_liabilities": 133973000000,
      "long_term_debt": 95281000000,
      "total_liabilities": 290437000000,
      "common_stock": 73812000000,
      "retained_earnings": -214000000,
      "total_shareholders_equity": 62318000000,
      "total_liabilities_and_equity": 352755000000
    },
    "cash_flow_statement": {
      "net_income": 98849000000,
      "depreciation_amortization": 11519000000,
      "stock_based_compensation": 10833000000,
      "change_in_working_capital": -1200000000,
      "operating_cash_flow": 110543000000,
      "capital_expenditures": -10959000000,
      "investments_purchases": -29513000000,
      "investments_sales": 31446000000,
      "investing_cash_flow": -3705000000,
      "share_repurchases": -77550000000,
      "dividend_payments": -14841000000,
      "debt_issuance": 5228000000,
      "debt_repayment": -11151000000,
      "financing_cash_flow": -104618000000,
      "net_change_in_cash": 2220000000,
      "free_cash_flow": 99584000000
    },
    "key_metrics": {
      "market_cap": 2800000000000,
      "enterprise_value": 2750000000000,
      "pe_ratio": 28.5,
      "pb_ratio": 45.2,
      "ps_ratio": 7.3,
      "ev_ebitda": 22.1,
      "ev_sales": 7,
      "roe": 0.175,
      "roa": 0.125,
      "roic": 0.155,
      "gross_margin": 0.433,
      "operating_margin": 0.294,
      "net_margin": 0.251,
      "debt_to_equity": 1.77,
      "current_ratio": 1.07,
      "quick_ratio": 0.85,
      "interest_coverage": 29.4,
      "dividend_yield": 0.005,
      "payout_ratio": 0.15,
      "book_value_per_share": 3.88,
      "tangible_book_value_per_share": 3.88,
      "revenue_growth": 0.028,
      "net_income_growth": 0.135,
      "eps_growth": 0.142
    },
    "is_audited": true,
    "is_restated": false,
    "data_source": "SEC_EDGAR",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

​
period
enum<string>

Filter by reporting period

Available options:
annual,
quarterly,
ttm
Example:

"annual"

​
fiscal_year
integer

Filter by fiscal year

Required range: 2000 <= x <= 2100
Example:

2023

​
fiscal_quarter
integer

Filter by fiscal quarter

Required range: 1 <= x <= 4
Example:

4

​
statement_types
enum<string>[]

Filter by statement types

​
include_income_statement
boolean
default:true

Include income statement data

Example:

true

​
include_balance_sheet
boolean
default:true

Include balance sheet data

Example:

true

​
include_cash_flow
boolean
default:true

Include cash flow statement data

Example:

true

​
include_key_metrics
boolean
default:true

Include key metrics data

Example:

true

​
sort_by
enum<string>
default:date

Sort by field

Available options:
date,
fiscal_year,
fiscal_quarter,
createdAt,
updatedAt
Example:

"date"

​
sort_order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
from
string | null

Start date, format YYYY-MM-DD

Example:

"2023-01-01"

​
to
string | null

End date, format YYYY-MM-DD

Example:

"2023-12-31"

​
page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

​
page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

Financial data retrieved successfully

Single financial statement response

​
success
boolean
required

Indicates successful API response

​
data
object | null
required

Financial statement data Complete financial statement data

​
timestamp
string<date-time>
required

ISO 8601 timestamp of the response

​
message
string

Optional success message

​
meta
object

Optional metadata including pagination, statistics, and additional context