> **Source:** https://knowledge.leegality.com/document-execution/api/calculate-nesl-stamp-duty
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# POST /v4/nesl/stampDuty/calculate — Calculate NeSL stamp duty

Calculates the stamp duty amount applicable for a NeSL document based on the consideration amount, article code, and state.

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
POST https://app1.leegality.com/api/v4/nesl/stampDuty/calculate
```

**Environments:**
- Production: `https://app1.leegality.com/api/v4/nesl/stampDuty/calculate`
- Sandbox: `https://sandbox.leegality.com/api/v4/nesl/stampDuty/calculate`

---

## Request Body

**Content-Type:** `application/json`

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `considerationAmount` | string | Yes | The consideration amount on which stamp duty is to be calculated.  - **Format:** Numeric value passed as a string. | `10000` |
| `articleId` | string | Yes | Article code applicable for the document type. Use the same article code provided by NeSL. | `115` |
| `articleSubCode` | string | No | This is article sub-code. | `159` |
| `stateCode` | string | Yes | Two-letter state code where the stamp duty is being paid. Currently supported only for **eGRAS states** (not for SHCIL states). Accepted values are- MH, MP, KL, WB, KA, TS, BH, RJ. Allowed: `MH`, `MP`, `KL`, `WB`, `KA`, `TS`, `BH`, `RJ`. | `MP` |

### Sample Request

```json
{
  "considerationAmount": "10000",
  "articleId": "115",
  "articleSubCode": "159",
  "stateCode": "MP"
}
```

---

## Responses

### 200 — NeSL stamp duty calculation response.

Response for the Calculate NeSL Stamp Duty API.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `data` | object | No | Response data object containing the calculated stamp duty. See **data** below. | — |
| `messages` | array\<object\> | No | Contains details about the response message. Empty on success. See **messages** below. | — |
| `status` | integer | No | Indicates API response status. `1` means success. | `1` |

#### data

Response data object containing the calculated stamp duty.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `stampDutyAmount` | string | No | The calculated stamp duty amount for the given consideration amount, article code, and state. | `100` |

#### messages

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Response code. | — |
| `message` | string | No | Response message. | — |

### Sample Response (200)

```json
{
  "data": {
    "stampDutyAmount": "100"
  },
  "messages": {},
  "status": 1
}
```