Balance Sheet API | Upstox Developer API

Get Balance Sheet

API to retrieve the historical balance sheet data for a company identified by its ISIN. The response contains total assets and total liabilities across multiple reporting periods, and can be filtered 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/balance-sheet?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",
    "history": [
      { "total_asset": 1950121, "total_liability": 940495, "period": "Mar 2025" },
      { "total_asset": 1755986, "total_liability": 830198, "period": "Mar 2024" },
      { "total_asset": 1607431, "total_liability": 778550, "period": "Mar 2023" },
      { "total_asset": 1499665, "total_liability": 610681, "period": "Mar 2022" }
    ],
    "full_statement": [
      {
        "particular": "Non-Current Assets",
        "history": [
          { "period": "Mar 2025", "value": 1450851 },
          { "period": "Mar 2024", "value": 1285886 },
          { "period": "Mar 2023", "value": 1182135 },
          { "period": "Mar 2022", "value": 1152646 }
        ]
      },
      {
        "particular": "Current Assets",
        "history": [
          { "period": "Mar 2025", "value": 499270 },
          { "period": "Mar 2024", "value": 470100 },
          { "period": "Mar 2023", "value": 425296 },
          { "period": "Mar 2022", "value": 347019 }
        ]
      },
      {
        "particular": "Total Assets",
        "history": [
          { "period": "Mar 2025", "value": 1950121 },
          { "period": "Mar 2024", "value": 1755986 },
          { "period": "Mar 2023", "value": 1607431 },
          { "period": "Mar 2022", "value": 1499665 }
        ]
      },
      {
        "particular": "Current Liabilities",
        "history": [
          { "period": "Mar 2025", "value": 453737 },
          { "period": "Mar 2024", "value": 397367 },
          { "period": "Mar 2023", "value": 395743 },
          { "period": "Mar 2022", "value": 308662 }
        ]
      },
      {
        "particular": "Net Current Asset",
        "history": [
          { "period": "Mar 2025", "value": 45533 },
          { "period": "Mar 2024", "value": 72733 },
          { "period": "Mar 2023", "value": 29553 },
          { "period": "Mar 2022", "value": 38357 }
        ]
      },
      {
        "particular": "Non-Current Liabilities",
        "history": [
          { "period": "Mar 2025", "value": 486758 },
          { "period": "Mar 2024", "value": 432831 },
          { "period": "Mar 2023", "value": 382807 },
          { "period": "Mar 2022", "value": 302019 }
        ]
      },
      {
        "particular": "Equity Capital",
        "history": [
          { "period": "Mar 2025", "value": 1009626 },
          { "period": "Mar 2024", "value": 925788 },
          { "period": "Mar 2023", "value": 828881 },
          { "period": "Mar 2022", "value": 888984 }
        ]
      },
      {
        "particular": "Total Equity & Liabilities",
        "history": [
          { "period": "Mar 2025", "value": 1950121 },
          { "period": "Mar 2024", "value": 1755986 },
          { "period": "Mar 2023", "value": 1607431 },
          { "period": "Mar 2022", "value": 1499665 }
        ]
      }
    ]
  }
}

Name	Type	Description
status	string	A string indicating the outcome of the request. Possible values: `success`, `error`.
data	object	Balance sheet 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.history	array	Summary balance sheet records ordered by reporting period (most recent first).
data.history[].total_asset	number	Total assets of the company for the period (in Crore).
data.history[].total_liability	number	Total liabilities of the company for the period (in Crore).
data.history[].period	string	Reporting period label, e.g., `Mar 2025`.
data.full_statement	array	Detailed line-item breakdown of the balance sheet. Present only when `fs=true` is passed.
data.full_statement[].particular	string	Label for the balance sheet line item, e.g., `Non-Current Assets`, `Current Assets`, `Total Assets`, `Current Liabilities`, `Net Current Asset`, `Non-Current Liabilities`, `Equity Capital`, `Total Equity & Liabilities`.
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/balance-sheet'
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/balance-sheet', {
  params: { type: 'consolidated' },
  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 GetBalanceSheet {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(new URI("https://api.upstox.com/v2/fundamentals/INE002A01018/balance-sheet?type=consolidated"))
                .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/balance-sheet?' . http_build_query([
    'type' => 'consolidated'
]);
$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 Balance Sheet​

Path Parameters​

Query Parameters​

Request​

Response Body​

Error codes​

Sample Code​