Cash Flow API | Upstox Developer API

Get Cash Flow

API to retrieve the historical cash flow statements for a company identified by its ISIN. The response groups cash flows by category (Operating, Investing, Financing), each with historical values and period-over-period percentage changes. You can filter by statement type (consolidated or standalone). All monetary values are in Indian Rupees (Crore).

Path Parameters

Name	Required	Type	Description
isin	true	string	International Securities Identification Number (ISIN) of the company. Example: `INE002A01018`.

Query Parameters

Name	Required	Type	Description
type	false	string	Financial statement type. Allowed values: `consolidated`, `standalone`. Default: `consolidated`.
fs	false	boolean	When set to `true`, the response includes a detailed line-item breakdown in the `full_statement` field.

Request

curl --location 'https://api.upstox.com/v2/fundamentals/INE002A01018/cash-flow?type=consolidated&fs=true' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your_access_token}'

For additional samples in various languages, please refer to the Sample code section on this page.

Responses

Response Body

{
  "status": "success",
  "data": {
    "type": "consolidated",
    "time_period": "yearly",
    "units_in": "crore",
    "cash_flow": [
      {
        "category": "operating",
        "history": [
          { "value": 178703, "period": "Mar 2025", "change": "+12.54%" },
          { "value": 158788, "period": "Mar 2024", "change": "+38.04%" },
          { "value": 115032, "period": "Mar 2023", "change": "+3.96%" },
          { "value": 110654, "period": "Mar 2022" }
        ]
      },
      {
        "category": "investing",
        "history": [
          { "value": -137535, "period": "Mar 2025", "change": "-21.09%" },
          { "value": -113581, "period": "Mar 2024", "change": "-24.49%" },
          { "value": -91235, "period": "Mar 2023", "change": "+17.14%" },
          { "value": -110103, "period": "Mar 2022" }
        ]
      },
      {
        "category": "financing",
        "history": [
          { "value": -31891, "period": "Mar 2025", "change": "-91.58%" },
          { "value": -16646, "period": "Mar 2024", "change": "-259.22%" },
          { "value": 10455, "period": "Mar 2023", "change": "-39.53%" },
          { "value": 17289, "period": "Mar 2022" }
        ]
      }
    ],
    "full_statement": [
      {
        "particular": "Profit before tax",
        "history": [
          { "period": "Mar 2025", "value": 106017 },
          { "period": "Mar 2024", "value": 104340 },
          { "period": "Mar 2023", "value": 94801 },
          { "period": "Mar 2022", "value": 84142 }
        ]
      },
      {
        "particular": "Income before WC changes",
        "history": [
          { "period": "Mar 2025", "value": 166904 },
          { "period": "Mar 2024", "value": 164383 },
          { "period": "Mar 2023", "value": 140963 },
          { "period": "Mar 2022", "value": 113726 }
        ]
      },
      {
        "particular": "Change in Assets",
        "history": [
          { "period": "Mar 2025", "value": -14703 },
          { "period": "Mar 2024", "value": -28430 },
          { "period": "Mar 2023", "value": -19034 },
          { "period": "Mar 2022", "value": -39163 }
        ]
      },
      {
        "particular": "Change in Liabilities",
        "history": [
          { "period": "Mar 2025", "value": 38427 },
          { "period": "Mar 2024", "value": 34796 },
          { "period": "Mar 2023", "value": -600 },
          { "period": "Mar 2022", "value": 39888 }
        ]
      },
      {
        "particular": "Change in WC",
        "history": [
          { "period": "Mar 2025", "value": 23724 },
          { "period": "Mar 2024", "value": 6366 },
          { "period": "Mar 2023", "value": -19634 },
          { "period": "Mar 2022", "value": 725 }
        ]
      },
      {
        "particular": "Cash flow from Operations",
        "history": [
          { "period": "Mar 2025", "value": 178703 },
          { "period": "Mar 2024", "value": 158788 },
          { "period": "Mar 2023", "value": 115032 },
          { "period": "Mar 2022", "value": 110654 }
        ]
      },
      {
        "particular": "Cash flow from Investing",
        "history": [
          { "period": "Mar 2025", "value": -137535 },
          { "period": "Mar 2024", "value": -113581 },
          { "period": "Mar 2023", "value": -91235 },
          { "period": "Mar 2022", "value": -110103 }
        ]
      },
      {
        "particular": "Cash flow from Financing",
        "history": [
          { "period": "Mar 2025", "value": -31891 },
          { "period": "Mar 2024", "value": -16646 },
          { "period": "Mar 2023", "value": 10455 },
          { "period": "Mar 2022", "value": 17289 }
        ]
      },
      {
        "particular": "Total Cash Flow",
        "history": [
          { "period": "Mar 2025", "value": 9277 },
          { "period": "Mar 2024", "value": 28561 },
          { "period": "Mar 2023", "value": 34252 },
          { "period": "Mar 2022", "value": 17840 }
        ]
      },
      {
        "particular": "Cash (Start of the year)",
        "history": [
          { "period": "Mar 2025", "value": 97225 },
          { "period": "Mar 2024", "value": 68664 },
          { "period": "Mar 2023", "value": 36178 },
          { "period": "Mar 2022", "value": 17397 }
        ]
      },
      {
        "particular": "Cash (End of the year)",
        "history": [
          { "period": "Mar 2025", "value": 106502 },
          { "period": "Mar 2024", "value": 97225 },
          { "period": "Mar 2023", "value": 68664 },
          { "period": "Mar 2022", "value": 36178 }
        ]
      }
    ]
  }
}

Name	Type	Description
status	string	A string indicating the outcome of the request. Possible values: `success`, `error`.
data	object	Cash flow data for the requested statement type and time period.
data.type	string	Financial statement type. Possible values: `consolidated`, `standalone`.
data.time_period	string	Reporting period. Possible values: `yearly`, `quarterly`.
data.units_in	string	Unit of monetary values. Value: `crore`.
data.cash_flow	array	Cash flow categories with historical values ordered by reporting period (most recent first).
data.cash_flow[].category	string	Cash flow category. Possible values: `operating`, `investing`, `financing`.
data.cash_flow[].history	array	Historical values for the cash flow category.
data.cash_flow[].history[].value	number	Cash flow amount for the period (in Crore). Negative values indicate net outflow.
data.cash_flow[].history[].period	string	Reporting period label, e.g., `Mar 2025`.
data.cash_flow[].history[].change	string	Period-over-period percentage change, e.g., `"+12.54%"`. Absent for the oldest period in the series.
data.full_statement	array	Detailed line-item breakdown of the cash flow statement. Present only when `fs=true` is passed.
data.full_statement[].particular	string	Label for the cash flow line item, e.g., `Profit before tax`, `Income before WC changes`, `Change in Assets`, `Change in Liabilities`, `Change in WC`, `Cash flow from Operations`, `Cash flow from Investing`, `Cash flow from Financing`, `Total Cash Flow`, `Cash (Start of the year)`, `Cash (End of the year)`.
data.full_statement[].history	array	Historical values for the line item across reporting periods.
data.full_statement[].history[].period	string	Reporting period label, e.g., `Mar 2025`.
data.full_statement[].history[].value	number	Monetary value for the period (in Crore).

Error codes

Error code	Description
UDAPI1206	Invalid ISIN - The provided ISIN is invalid.
UDAPI1207	Invalid type - Allowed values: `consolidated`, `standalone`.

Sample Code

Python
Node.js
Java
PHP

import requests

url = 'https://api.upstox.com/v2/fundamentals/INE002A01018/cash-flow'
params = {
    'type': 'consolidated',
    'fs': 'true'
}
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}'
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

const axios = require('axios');

axios.get('https://api.upstox.com/v2/fundamentals/INE002A01018/cash-flow', {
  params: { type: 'consolidated', fs: 'true' },
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}'
  }
}).then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetCashFlow {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(new URI("https://api.upstox.com/v2/fundamentals/INE002A01018/cash-flow?type=consolidated&fs=true"))
                .header("Accept", "application/json")
                .header("Authorization", "Bearer {your_access_token}")
                .GET()
                .build();
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

<?php
$url = 'https://api.upstox.com/v2/fundamentals/INE002A01018/cash-flow?' . http_build_query([
    'type' => 'consolidated',
    'fs' => 'true'
]);
$headers = [
    'Accept: application/json',
    'Authorization: Bearer {your_access_token}'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_errno($ch) ? print('Error: ' . curl_error($ch)) : print($response);
curl_close($ch);
?>

Get Cash Flow​

Path Parameters​

Query Parameters​

Request​

Response Body​

Error codes​

Sample Code​