POST
/v1/tax/income- Authentication
- Bearer token
- Scope
tax:calc
Before you integrate
- Surcharge marginal relief is not applied, so results just above a surcharge threshold come out slightly high.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
regime | string | Yes | old or new. |
gross_income_minor | integer | Yes | Gross yearly income in paise; 0 or more. |
salaried | boolean | No | True to apply the standard deduction for salaried people. Defaults to false. |
deductions_minor | integer | No | Chapter VI-A deductions such as 80C in paise. Used only under the old regime; ignored under the new one. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/tax/income' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"regime": "new",
"gross_income_minor": 120000000,
"salaried": true
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"regime": "new",
"taxable_income_minor": 112500000,
"base_tax_minor": 6875000,
"rebate_87a_minor": 0,
"surcharge_minor": 0,
"cess_minor": 275000,
"total_tax_minor": 7150000
}
}Response fields
| Field | Type | Description |
|---|---|---|
regime | string | The regime used. |
taxable_income_minor | integer | Income after deductions, in paise. |
base_tax_minor | integer | Tax on the slabs before rebate, in paise. |
rebate_87a_minor | integer | Section 87A rebate in paise. |
surcharge_minor | integer | Surcharge in paise. |
cess_minor | integer | Health and education cess in paise. |
total_tax_minor | integer | Total tax payable in paise. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.