MASSARIdocsRequest access

Financial statements

GET/v1/symbols/{symbol}/financialsWhole, less the withheld

Income, balance sheet and cash flow as the company filed them.

Parameters

  • symbolpathrequired

    Ticker symbol, case-insensitive.

  • typequeryoptional

Response contract

Everything except the fields named as withheld, which are ours and not yours.

Withheld

income_grid_serving

These are ours: ingest bookkeeping and internal build stamps. They are removed at every level of the response, including inside arrays.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

symboltypeyearlyquarterlycurrencyperiod_filingsxbrl_provenancesourcexbrl_provenance_by_frequencyfield_sources

How this was verified

Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl "https://api.massari.ai/v1/symbols/AAPL/financials?type=income" \
  -H "Authorization: Bearer $MASSARI_TOKEN"

Example response

{
  "symbol": "AAPL",
  "type": "income"
}

A real response from the live API, captured August 18, 2026. This one is CUT: long arrays, wide objects and long strings were trimmed to keep it readable, so treat it as a sample of the shape rather than all of it. Either way it is valid JSON.

Book a meeting