Financials

Standardized line items per period, newest first. Every value is the trailing twelve months (TTM) ending at the period end; balance sheet items (total_debt, cash_and_equivalents) are the value at the period end. period=annual keeps only the fiscal year ends.

A period is left out when none of the requested items has a value for it, and an item without a value is omitted from values.

GET /api/v1/companies/{symbol}/financials

Requires an API key in the X-Api-Key header.

Parameters#

Request#

curl

curl "https://studyingstocks.com/api/v1/companies/CSCO/financials?period=annual&items=revenue,free_cash_flow&limit=5" \
  -H "X-Api-Key: $STUDYING_STOCKS_API_KEY"

Python

import os
import requests

response = requests.get("https://studyingstocks.com/api/v1/companies/CSCO/financials", params={"period": "annual", "items": "revenue,free_cash_flow", "limit": "5"}, headers={"X-Api-Key": os.environ["STUDYING_STOCKS_API_KEY"]})
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch("https://studyingstocks.com/api/v1/companies/CSCO/financials?period=annual&items=revenue,free_cash_flow&limit=5", {
  headers: { "X-Api-Key": process.env.STUDYING_STOCKS_API_KEY },
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Response#

Periods with their values.

{
    "data": [
        {
            "period": "2026Q4",
            "period_end": "2026-07-25",
            "fiscal_year": 2026,
            "fiscal_quarter": 4,
            "values": {
                "revenue": 63325000000,
                "free_cash_flow": 12767000000
            }
        }
    ],
    "meta": {
        "symbol": "CSCO",
        "currency": "USD",
        "period": "ttm",
        "items": [
            "revenue",
            "free_cash_flow"
        ],
        "count": 1,
        "filings_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000858877&type=10-&dateb=&owner=include&count=40",
        "source": "SEC EDGAR",
        "api_version": "v1",
        "generated_at": "2026-10-16T02:00:00Z"
    }
}

Response fields#

Errors#

All errors have the same shape.