Chadwin

Financial statements beta

Retrieve reviewed normalized annual statement values and calculated metrics.

What the beta contains

The beta returns values that Chadwin has normalized, reviewed, and published from original Form 10-K filings. It covers annual US company results only. It does not imply that every company or fiscal year has been published.

Each available period groups values into the balance sheet, income statement, cash-flow statement, and calculated metrics. The API reference is the source of truth for the fields in CompanyFinancialStatementsResponse.

Choose periods

Send fiscal_year for one filer-reported fiscal year, or years for the newest available published years. Do not send both. With neither filter, the API returns the newest available published period.

Read missing results

  • Unknown ticker: the API returns 404 company_not_found
  • Known company with no matching published result: the response contains the issuer and an empty periods array
  • Missing item in an available period: the item is omitted because no value was published for it

An omitted item does not state why the value was unavailable. It may be absent from the filing, not applicable, ambiguous, or unsupported by the current rules.

Use the API

HTTP

curl --get \
  --url "https://api.chadwin.co/v1/companies/US/AAPL/financial-statements" \
  --data-urlencode "fiscal_year=2024" \
  --header "Authorization: Bearer $CHADWIN_API_KEY"

Node.js SDK

const result = await client.financialStatements.get({
  ticker: "AAPL",
  fiscalYear: 2024,
});

for (const period of result.periods) {
  console.log(period.fiscal_year, period.income_statement.revenue);
}