estimate_stamp_duty_and_registration

Pan-India stamp duty + registration estimate for a property purchase across all 28 states + 8 union territories, with buyer-gender concessions, urban/rural splits, and per-state surcharges.

Endpoint POST https://api.avnester.com/public/v1/estimate_stamp_duty_and_registration

Parameters

The most-used parameters. Full schema in the OpenAPI document.

Name	Type	Required	Description
propertyValueInr	number	required	Sale consideration in INR.
state	string	required	Indian state — ISO code ("MH"), URL slug ("maharashtra"), or display name ("Maharashtra"). All 28 states + 8 UTs supported.
buyerGender	string	optional	male \| female \| joint. Overrides legacy isWomanBuyer.
propertyType	string	optional	residential \| commercial \| agricultural. Applies state-specific multiplier.
isUrban	boolean	optional	Gates metro-cess surcharges (e.g., Mumbai LBT, BBMP cess). Defaults to true.
isWomanBuyer	boolean	optional	Backward-compat shim — prefer buyerGender. true → buyerGender="female".

Worked example

# stamp duty + registration for a ₹65L property in Tamil Nadu (woman buyer)

curl -X POST https://api.avnester.com/public/v1/estimate_stamp_duty_and_registration \
  -H 'Content-Type: application/json' \
  -d '{
       "propertyValueInr": 6500000,
       "state": "TN",
       "buyerGender": "female"
     }'

Response

{
  "propertyValue": 6500000,
  "state": "TN",
  "supported": true,
  "stampDuty": 390000,
  "registrationFee": 260000,
  "total": 650000,
  "rateBasis": "Tamil Nadu: 6% stamp + 4% registration (woman-buyer rate applied).",
  "rateEffectiveDate": "2024-04-01",
  "attribution": "AVnester",
  "disclaimer": "..."
}

# stamp duty for a ₹1Cr Mumbai property (man, urban — metro cess applies)

curl -X POST https://api.avnester.com/public/v1/estimate_stamp_duty_and_registration \
  -H 'Content-Type: application/json' \
  -d '{
       "propertyValueInr": 10000000,
       "state": "maharashtra",
       "buyerGender": "male",
       "isUrban": true
     }'

Response

{
  "propertyValue": 10000000,
  "state": "maharashtra",
  "supported": true,
  "stampDuty": 700000,
  "registrationFee": 100000,
  "total": 800000,
  "rateBasis": "Maharashtra: 5% stamp + 1% registration; surcharges: Metro Cess (Mumbai/Pune/Thane) 1%, Local Body Tax 1%.",
  "rateEffectiveDate": "2024-04-01",
  "attribution": "AVnester",
  "disclaimer": "..."
}

Rate limits

Anonymous

60/min

OAuth (Team)

600/min

Per-IP aggregate cap (across all tools): 60/min. OAuth registration lifts both the per-tool budget (10×) and removes the IP cap.

Common errors

400Unsupported state
Returns supported=false + zero numerics + named-states message. The 36 supported states (28 states + 8 UTs) are listed in the rateBasis field on a refusal response.
429Rate limit exceeded
Back off until the time in the Retry-After header; or authenticate with OAuth for the 10× tier.

Next steps

→ Try estimate_stamp_duty_and_registration in the playground (no signup, anon tier)
→ Register an OAuth client (10× rate budget)
→ Browse the other 6 tools
→ Full schema in the OpenAPI spec