Financial statements

GET

/v1/stocks/{symbol}/financials

curl --request GET \
  --url 'https://api.tapetide.com/v1/stocks/example/financials?section=quarterly&periods=12' \
  --header 'Authorization: Bearer <token>'

Financial statements. section is one of quarterly (quarterly P&L), profit_loss, balance_sheet, cash_flow, ratios (all annual). Omit it for every section. Each section carries periods (oldest first), data {row: {period: value}}, pct_changes, row_order and an availability array with the point-in-time available_from date per period. Unlike the MCP tool, this route returns the FULL document: periods defaults to every period held, and nothing is trimmed to fit a context window. ETFs, index funds and bonds have no statements and return 404.

Authorizations

• bearer

Parameters

Path Parameters

symbol

required

string

<= 64 characters

Stock or index symbol, e.g. “RELIANCE”, “TCS”, “NIFTY”. Percent-encode symbols containing “&” (M%26M).

Query Parameters

section

string

Quarterly | profit_loss | balance_sheet | cash_flow | ratios. Accepted spellings include quarters, quarterly_results, income_statement, pnl, bs, cf.

Example

quarterly

periods

integer

>= 1 <= 40

Latest N periods per section (max 40). Default: all periods held. Also accepted as: quarters.

Example

12

Responses

200

OK. Costs one request unit.

Media typeapplication/json

object

data

required

The document. Shape is route-specific and never truncated.

meta

required

Paging and window information where the route pages (e.g. window.next_cursor on price history).

object

as_of

When this response was assembled (UTC).

string format: date-time

route

The operationId that served it.

string

key

additional properties

any

Example ^generated

{
  "data": "example",
  "meta": {
    "as_of": "2026-04-15T12:00:00Z",
    "route": "example"
  }
}

Headers

X-RateLimit-Reset

integer

Unix seconds when the binding quota window resets (IST boundaries).

400

Malformed or out-of-range parameter. Not charged.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: authentication_required invalid_token invalid_request route_not_found not_found method_not_allowed rate_limited quota_exhausted upstream_unavailable service_unavailable tool_error internal_error

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "authentication_required"
  }
}

401

Missing or invalid bearer token.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: authentication_required invalid_token invalid_request route_not_found not_found method_not_allowed rate_limited quota_exhausted upstream_unavailable service_unavailable tool_error internal_error

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "authentication_required"
  }
}

404

The symbol, index or document does not exist. Not charged.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: authentication_required invalid_token invalid_request route_not_found not_found method_not_allowed rate_limited quota_exhausted upstream_unavailable service_unavailable tool_error internal_error

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "authentication_required"
  }
}

429

Per-minute burst cap or plan quota reached.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: authentication_required invalid_token invalid_request route_not_found not_found method_not_allowed rate_limited quota_exhausted upstream_unavailable service_unavailable tool_error internal_error

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "authentication_required"
  }
}

Headers

Retry-After

integer

X-RateLimit-Reset

integer

Unix seconds when the binding quota window resets (IST boundaries).

502

A data dependency was unavailable. Not charged.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: authentication_required invalid_token invalid_request route_not_found not_found method_not_allowed rate_limited quota_exhausted upstream_unavailable service_unavailable tool_error internal_error

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "authentication_required"
  }
}