---
title: Check Wallet Balance API (eStamping)
slug: contract360/check-wallet-balance-api-estamping
docTags: 
createdAt: 2024-02-28T04:42:41.855Z
---

# Introduction

Embark on a journey of financial empowerment with the innovative Signzy system, where clients can effortlessly monitor their wallet balances. By simply crediting a stamp, challan, or revenue stamp, clients unlock the ability to gain valuable financial insights within the Signzy ecosystem. The key to this is the smart use of the "Parameter type" — a powerful identifier that enables clients to seamlessly access their eStamp, eChallan, or Revenue Stamp wallet, offering a comprehensive view of their available funds. Say goodbye to uncertainty and welcome a world of financial clarity, all at your fingertips, with Signzy’s intuitive and secure platform.

Clients can check their wallet balance in the Signzy system after crediting a stamp, challan, or revenue stamp. The "Parameter type" is used to identify the specific eStamp, eChallan, or Revenue Stamp wallet to be accessed.

# Authentication

API authentication is a crucial security process that ensures authorized access to an application programming interface (API). It involves validating the identity of users or systems seeking to interact with the API. Please use the `access token` shared with you by your assigned Signzy's CSM. Please set the value of the key `Authorization` in the headers to the `access token`, while making an API call. In this way, Signzy's system will be able to authenticate you and you will be able to make a successful API call.&#x20;

# API Details

The details of the API can be found here.

## Sample cURL

:::CodeblockTabs
Pre Production

```curl
curl --location 'https://api-preproduction.signzy.app/api/v3/contract/eStamp/walletBalance' \
--header 'Authorization: *********************************' \
--header 'Content-Type: application/json' \
--data '{
         "type": "eChallan" ,
         "exportFormat":"json"  
}'
```

Production

```curl
curl --location 'https://api.signzy.app/api/v3/contract/eStamp/walletBalance' \
--header 'Authorization: *********************************' \
--header 'Content-Type: application/json' \
--data '{
         "type": "eChallan",
         "exportFormat":"json" 
}'
```
:::

## Input Parameters

| **PARAMETERS** | **DESCRIPTION**                                                                   | **TYPE** | **MANDATORY/OPTIONAL** |
| -------------- | --------------------------------------------------------------------------------- | -------- | ---------------------- |
| type           | ` eStamp` , `eChallan`<br />and` REVENUE_STAMP`, By default `eStamp` will be used | String   | Mandatory              |
| exportFormat   | ` json` <br />and`csv`, By default`csv` will be used                              | String   | Optional               |

## Sample Response

:::CodeblockTabs
200

```json
{
    "result": {
        "logFile": "...logFile..."
    }
}
```
:::

## Output Parameters

| **PARAMETERS** | **TYPE** | **DESCRIPTION** |
| -------------- | -------- | --------------- |
| logFile        | String   | CSV file        |

**The following terms are used in eStamp CSV reports.**

| **Column**     | **Description&#x20;**       |
| -------------- | --------------------------- |
| SNo            | Serial Number               |
| FirstPartyName | Name of the First Party     |
| StateCode      | State Code for eStamp       |
| Denomination   | Value of stamp              |
| ArticleCode    | Article code for the eStamp |
| Status         | Status of the eStamp        |

**Sample**

| SNo | FirstPartyName | StateCode | Denomination | ArticleCode | Status     |
| --- | -------------- | --------- | ------------ | ----------- | ---------- |
| 1   | Signzy         | MH        | 500          | MH10041     | Available  |

**The following terms are used in eChallan CSV reports.**

| **Column**       | **Description&#x20;**                   |
| ---------------- | --------------------------------------- |
| SNo              | Serial Number                           |
| FirstPartyName   | Name of the First Party                 |
| StateCode        | State Code for eChallan                 |
| ArticleCode      | Article code for the eChallan           |
| ChallanNo        | eChallan no which have the balance left |
| InitialBalance   | The uploaded amount                     |
| CurrentBalalance | Amount present in the challan           |

**Sample**

| SNo | FirstPartyName | StateCode | ArticleCode | ChallanNo    | InitialBalance | CurrentBalalance |
| --- | -------------- | --------- | ----------- | ------------ | -------------- | ---------------- |
| 1   | Signzy         | KA        | KA1005      | KA345FOWO20F | 10,000         | 1000             |

**The following terms are used in Revenue Stamp CSV reports.**

| **Column**        | **Description&#x20;**                                  |
| ----------------- | ------------------------------------------------------ |
| SNo               | Serial Number                                          |
| LotNo             | Lot Number Automatically assigned to the revenue stamp |
| revenueStampsDate | Date of the revenue stamp                              |
| InitialBalance    | The uploaded amount                                    |
| CurrentBalalance  | Amount present in the revenue stamp                    |

**Sample**

| SNo | LotNo            | revenueStampsDate | InitialBalance | CurrentBalalance |
| --- | ---------------- | ----------------- | -------------- | ---------------- |
| 1   | 677ecghee5434545 | 07/01/2025        | 50,000         | 10,000           |

## Sample Error

:::CodeblockTabs
400

```json
{
    "name": "error",
    "message": "",
    "reason": "VALIDATION_ERROR",
    "type": "Bad Request",
    "statusCode": 400
}
```

401

```json
{
    "message": "Invalid authentication credentials"
}
```

404

```json
{
    "name": "error",
    "message": "",
    "reason": "Not Found",
    "type": "Not Found",
    "statusCode": 404
}
```

500

```json
{
    "error": {
        "name": "error",
        "message": "Internal Server Error",
        "reason": "INTERNAL_SERVER_ERROR",
        "type": "Internal Server Error",
        "statusCode": 500
    }
}
```
:::

## Error Parameter

| **Parameter** | **Type** | **Description**                                                            |
| ------------- | -------- | -------------------------------------------------------------------------- |
| name          | String   | In case of errors, it will have the value "error". It represents an error. |
| message       | String   | Message for the error                                                      |
| reason        | String   | Reasons for the error                                                      |
| type          | String   | Type of error                                                              |
| statusCode    | String   | Status code of the error                                                   |

## Error Codes

| **Error Code** | **Error Message**     | **Explanation**                                                    |
| -------------- | --------------------- | ------------------------------------------------------------------ |
| 400            | Bad Request           | Input parameter has a missing required parameter or invalid inputs |
| 401            | Authorization Failed  | Authorization token is invalid                                     |
| 404            | Not found             | Not found                                                          |
| 500            | Internal Server Error | Internal error at Signzy, Please reach out to help\@signzy.com     |

# Contract360 Dashboard View&#x20;

The Contract360 dashboard provides a centralized view to track all your stamping-related activities. You can easily **view the added eStamps, eChallans, and Revenue Stamps** from their respective sections within the dashboard:

### eStamp Management

The **eStamp Management section&#x20;**&#x64;isplays all the stamps currently available in your wallet. You can track **real-time activities&#x20;**&#x72;elated to each stamp. Additionally, you can **download your stamp balance&#x20;**&#x75;sing the **"Export CSV"&#x20;**&#x62;utton for easy reporting or record-keeping.

![](https://api.archbee.com/api/optimize/w0YdjmC6Uxu0AJ6sPj9OT/KI6trHCSgLecwwjz4jSuB_image.png)

### eChallan Management

The **eChallan Management section&#x20;**&#x64;isplays the available eChallan in your wallet. You can track **real-time activities&#x20;**&#x72;elated to eChallan. Additionally, you can **download your eChallan balance&#x20;**&#x75;sing the **"Export CSV"&#x20;**&#x62;utton for easy reporting or record-keeping.

![](https://api.archbee.com/api/optimize/w0YdjmC6Uxu0AJ6sPj9OT/_4gidNUJD_gbRcjQFxC1E_image.png)

### Revenue Stamp Management

The **Revenue Stamp Management section&#x20;**&#x64;isplays all the revenue stamps currently available in your wallet. You can track **real-time activities&#x20;**&#x72;elated to each revenue stamp. Additionally, you can **download your revenue stamp balance&#x20;**&#x75;sing the **"Export CSV"&#x20;**&#x62;utton for easy reporting or record-keeping.

![](https://api.archbee.com/api/optimize/w0YdjmC6Uxu0AJ6sPj9OT/XRO5eDJYhyQMZMQR2SKSz_image.png)

You can review their estamping transaction logs in the Signzy system for a specific time range, using [Get Wallet Logs API,](https://docs.signzy.com/contract360/get-wallet-logs-api-estamping) allowing you to track and monitor financial activities efficiently.
