DocumentationIncome Tax Calculator API
Income Tax Calculator API
Chinese individual income tax calculation
Overview
GET /v1/life/tax calculates Chinese individual income tax, supporting cumulative withholding for monthly salary and separate taxation for annual bonuses.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
monthly_salary | float | Yes | - | Pre-tax monthly salary |
bonus | float | No | 0 | Annual bonus |
insurance | float | No | 0 | Social insurance deduction |
special_deduction | float | No | 0 | Special additional deductions |
additional_deduction | float | No | 0 | Other deductions |
Request Examples
Basic Calculation
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/life/tax?monthly_salary=20000"Full Calculation
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/life/tax?monthly_salary=20000&bonus=50000&insurance=2000&special_deduction=1500"Response Fields
| Field | Description |
|---|---|
monthly_salary | Pre-tax monthly salary |
monthly_tax | Monthly tax |
monthly_after_tax | Monthly take-home pay |
annual_tax | Annual tax |
annual_after_tax | Annual take-home pay |
bonus_tax | Bonus tax (when bonus is provided) |
bonus_after_tax | Bonus take-home (when bonus is provided) |
total_annual_tax | Total annual tax (when bonus is provided) |
total_annual_after_tax | Total annual take-home (when bonus is provided) |
Pricing
$0.01/call. First 500 calls/month are free.
Updated 6 days ago