---
title: "Cash Itc Balance"
method: GET
path: "/v1/gst/tax-payer/ledgers/balance"
tags: ["GST Taxpayer APIs"]
---

# Cash Itc Balance

`GET /v1/gst/tax-payer/ledgers/balance`

## Request

- Base URL: `https://api.deepvue.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.deepvue.ai/v1/gst/tax-payer/ledgers/balance`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `authorize`
- TypeScript: <https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/docs/v1/gst/tax-payer/ledgers/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

- The Cash ITC Balance is the balance present after deduction of Input Tax Credit (ITC) has to be paid.   
- The API takes in the gstin and the time period(month and year) for which you want to retrieve the Cash ITC Balance.

## Query parameters

- `gstin_number` string, required
- `year` string, required
- `month` string, required

## Response `200`

Successful Response

- union
  - RESPONSEGSTBALANCESUCCESSFUL
    - `data` ItcBalData, required
      - `cash_bal` CashBalObject, required
        - `sgst` SgstObject, required
          - `intr` integer, required
          - `oth` integer, required
          - `tx` integer, required
          - `fee` integer, required
          - `pen` integer, required
        - `cgst` CgstObject, required
          - `intr` integer, required
          - `oth` integer, required
          - `tx` integer, required
          - `fee` integer, required
          - `pen` integer, required
        - `igst` IgstObject, required
          - `intr` integer, required
          - `oth` integer, required
          - `tx` integer, required
          - `fee` integer, required
          - `pen` integer, required
        - `cess` CessObject, required
          - `intr` integer, required
          - `oth` integer, required
          - `tx` integer, required
          - `fee` integer, required
          - `pen` integer, required
        - `sgst_tot_bal` integer, required
        - `igst_tot_bal` integer, required
      - `itc_bal` ItcBalObject, required
        - `cgst_bal` integer, required
        - `igst_bal` integer, required
        - `sgst_bal` integer, required
        - `cess_bal` integer, required
      - `itc_blck_bal` ItcBlckBalObject, required
        - `cgst_blck_bal` integer, required
        - `igst_blck_bal` integer, required
        - `sgst_blck_bal` integer, required
        - `cess_blck_bal` integer, required
      - `gstin` string, required
    - `code` integer, required
    - `timestamp` integer, required
    - `transaction_id` string, required
  - RESPONSEGSTAUTHENTICATIONFAILED
    - `data` object
    - `code` integer, required
    - `timestamp` integer, required
    - `transaction_id` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide.md) - [All operations](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/llms.txt) - [OpenAPI document](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/revisions/c1b0558e7d77?raw)