Guides

Periods and fiscal calendars

View as Markdown

TTM and annual

  • period=ttm (the default) returns one row per quarter end. Flow items (revenue, net income, free cash flow, per-share earnings and dividends) are the trailing twelve months ending on that date. Balance sheet items (total_debt, cash_and_equivalents) are the value on that date. Share counts are the weighted average of the quarter.
  • period=annual returns only the rows at the end of a fiscal year, so each value is that fiscal year's.

Discrete quarters (period=quarter) are not available yet.

Labels

Periods are labelled with the company's own fiscal calendar, taken from its SEC filings: 2026Q4 is the fourth fiscal quarter of fiscal year 2026, which for Cisco ends in July 2026. Annual rows are labelled FY2026. Each row also has fiscal_year and fiscal_quarter as numbers and the real period_end date; use period_end to compare companies on a calendar.

The profile endpoint reports fiscal_year_end_month. Fifty-two and 53-week years can end in the first days of the next month; the fiscal year is still the one the company reports.

Filtering and order

Rows are newest first. from and to filter by period_end (YYYY-MM-DD). limit caps the number of rows (default 20, maximum 40; ten years of quarters is 40 rows).

Missing values

If a company did not report an item for a period, the item is left out of values. A period with none of the requested items is left out of the response.