Torus Digital Open API
  • Introduction
  • Get Started
  • Authentication
    • Login
    • Session Token
  • SDK
    • Self Generated SDK'S
  • Orders
    • Order Entry
    • Order Modify
    • Order Cancel
    • Order Convert To delivery
    • Order Margin
    • Order Book
    • Order Details
  • Holdings and Portfolio
    • Portfolio
    • Holding
    • Holding Details
    • Net Positions
  • Market
    • Market Status
  • Trade
    • Trade Book
    • Trade Details
  • Funds
    • Fund limits
    • Fund limits details
  • Historical Data
    • Search Stock
    • Company Basic Detail
    • Indices List
    • Monthly/Yearly Returns
    • Share Holding Pattern
    • Balance Sheet
    • Cash Flow
    • Profit and Loss
Powered by GitBook
On this page
  1. Historical Data

Profit and Loss

This API retrieves the profit and loss statement of a company based on the provided company code (cocode) and report type (reportType), such as S (Single) or C (Consolidated). The response includes key financial metrics for several fiscal years, such as revenue, expenses, profit, tax before and after profit and Operating Profit after Depreciation.

Note: cocode can be obtained from the Search Stock or Company Basic Detail API.

Endpoint

https://connects.torusdigital.com/api/v1/profitandloss/{cocode}/{reportType}

Request Parameter

Name
Mandatory
Description

cocode

Y

The unique company code identifier.

reportType

Y

The type of report to retrieve. Report type (S - Single or C - Consolidated)

Request

cURL
curl -X 'GET' \
  'https://connects.torusdigital.com/api/v1/profitandloss/{cocode}/{reportType}' \
  -H 'accept: application/json'
Java-Unirest
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/profitandloss/{cocode}/{reportType}")
  .header("Content-Type", "application/json")
  .asString();
Go-Native
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"strings"
)

func main() {
	url := "https://connects.torusdigital.com/api/v1/profitandloss/{cocode}/{reportType}"
	method := "GET"

	client := &http.Client{}
	req, err := http.NewRequest(method, url, nil)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")

	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := ioutil.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}
JavaScript-jQuery
var settings = {
  "url": "https://connects.torusdigital.com/api/v1/profitandloss/{cocode}/{reportType}",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Response

[
  {
    "COLUMNNAME": "Total Revenue",
    "YearData": {
      "Y202003": 350519,
      "Y202103": 260485,
      "Y202203": 437575,
      "Y202303": 550496,
      "Y202403": 546662
    }
  },
  {
    "COLUMNNAME": "Total Expenses",
    "YearData": {
      "Y202003": 305958,
      "Y202103": 237577,
      "Y202203": 390789,
      "Y202303": 496378,
      "Y202403": 491389
    }
  },
  {
    "COLUMNNAME": "Profit Before Tax",
    "YearData": {
      "Y202003": 40316,
      "Y202103": 27212,
      "Y202203": 46786,
      "Y202303": 54118,
      "Y202403": 55273
    }
  },
  {
    "COLUMNNAME": "Profit After Tax",
    "YearData": {
      "Y202003": 30903,
      "Y202103": 31944,
      "Y202203": 39084,
      "Y202303": 43002,
      "Y202403": 42042
    }
  },
  {
    "COLUMNNAME": "Operating Profit after Depreciation",
    "YearData": {
      "Y202003": 56666,
      "Y202103": 39119,
      "Y202203": 55909,
      "Y202303": 66751,
      "Y202403": 68703
    }
  }
]

Response Parameter

Parameters
Description

COLUMNNAME

Describes the financial metric (e.g., Total Revenue, Total Expenses, Profit Before Tax, etc.).

YearData

A key-value pair containing the year (Yyyyy03) as the key and the corresponding financial value.

Y20XX03

Financial data for the fiscal year ending in March 20XX.

PreviousCash Flow

Last updated 8 months ago