# Periods and fiscal calendars

> API version: v1

## 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.