Skip to main content
POST
curl
Schema 2 stock_financials is the statement-face source for the fields below. Served cells are filed-scale decimal strings unless the row is a derived ratio.

2026-07-07 income statement fields

Both fields still pass through the normal verification masks: a cell can refuse with verification_pending while scoring is incomplete or oracle_contradicted if verification blocks serving it.

Authorizations

X-API-Key
string
header
required

Body

application/json

Request body for stock_financials.

symbol
string
required

Ticker or resolvable symbol.

Required string length: 1 - 24
statement
enum<string>
default:financials

Schema-1 statement selector. financials returns all three statements.

Available options:
income,
balance,
cash_flow,
financials
period_kind
enum<string>
default:annual

Period family to return.

Available options:
annual,
quarter,
ytd
periods
integer
default:3

Number of periods to return.

Required range: 1 <= x <= 20
vintage
enum<string>
default:latest_restated

Only latest_restated is advertised and served for new integrations.

Available options:
latest_restated
detail
enum<string>
default:concise

Schema 1 accepts concise/full. Schema 2 maps omitted or concise to core and accepts core/full/audit.

Available options:
concise,
full,
core,
audit
schema
enum<integer>
default:2

Response schema selector. Omit (or send 2) for the schema-2 envelope, the default; 1 selects the frozen legacy wire. Boolean values are rejected by the API boundary.

Available options:
1,
2
statements
enum<string>[]

Schema-2 statement list. Aliases income_statement and balance_sheet are canonicalized before validation; the response orders statements as income, balance, cash_flow.

Maximum array length: 3
Available options:
income,
balance,
cash_flow
approx
boolean
default:false

Schema-2 only. Adds approximate twin fields when the renderer can compute them.

Response

Get SEC-verified financial statements. Envelope-level schema; captured examples remain authoritative for full nested payload detail.

Schema-2 envelope. The OpenAPI schema is structural; captured examples are authoritative for full nested payload detail.

data
object
required

Tool payload or typed schema-2 refusal.

meta
object
required

Schema-2 metadata. Unknown optional fields are omitted, not emitted as null.

subject
object

Resolved entity and security when the tool has a single subject.