---
title: "Revenue & profitability chart"
method: GET
path: "/api/financials/chart/revenue-profitability"
tags: ["Financials"]
---

# Revenue & profitability chart

`GET /api/financials/chart/revenue-profitability`

## Request

- Base URL: `https://api.stockfit.io/v1`
- URL: `https://api.stockfit.io/v1/api/financials/chart/revenue-profitability`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/stockfit/apis/stockfit-api/docs/api/financials/chart/revenue-profitability/get.ts> (a function with typed inputs; its response is checked against the schema)

![Free](https://img.shields.io/badge/Free-22c55e) ![Starter](https://img.shields.io/badge/Starter-3b82f6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Returns chart-ready data for revenue, net income, and profitability margins over time. Periods are sorted ascending. Use `series` for absolute values and `rates` for margin ratios.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string
- `period` 'annual' | 'quarter': Base reporting period: `annual` or `quarter` (the periods companies actually report, without the derived `ttm` rollup).
- `limit` integer

## Response `200`

Series-oriented chart data with periods sorted ascending

- object
  - `periods` string[], required: Reporting period end dates (YYYY-MM-DD), sorted ascending. Each entry corresponds index-wise to the values in every `series.data` and `rates.data` array.
  - `series` object[], required: Absolute value series in the requested `currency` (default USD). Always returns two entries, `Revenue`, `Net Income`, in that order. Individual data points may be `null` for periods where the underlying fact wasn't tagged.
    - `name` 'Revenue' | 'Net Income', required
    - `data` number[], required
  - `rates` object[], required: Margin ratio series, expressed as decimals (e.g. 0.469 = 46.9%). Always returns three entries, `Gross Margin`, `Operating Margin`, `Net Margin`, in that order.
    - `name` 'Gross Margin' | 'Operating Margin' | 'Net Margin', required
    - `data` number[], required

## Other responses

- `400`: Invalid parameters or symbol not found
- `403`: Feature not available on current plan

---

[API](https://skmtc.dev/stockfit/apis/stockfit-api.md) - [All operations](https://skmtc.dev/stockfit/apis/stockfit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockfit/apis/stockfit-api/revisions/ade8e65563c3?raw)