---
title: "Capital gains on a property sale"
method: POST
path: "/api/v1/tools/capital_gains"
---

# Capital gains on a property sale

`POST /api/v1/tools/capital_gains`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/capital_gains`
- Auth: HTTP bearer

Calculate capital gains and tax on a property sale (our Capital Gains Calculator): indexed cost via the CII table, long-term (held over 2 years) vs short-term, and for long-term BOTH regimes compared (20% with indexation vs 12.5% without indexation, post July 2024 rules). For property bought before 1 April 2001, the fair market value as on 1.4.2001 replaces the purchase price (ask the user for it). Optional improvement/development costs with their years are indexed too. Dates must be YYYY-MM-DD. Free.

## Request body

- object
  - `purchase_date` string, required: YYYY-MM-DD
  - `purchase_amount` number, required
  - `sale_date` string, required: YYYY-MM-DD
  - `sale_amount` number, required
  - `resident` boolean: Whether the seller is a resident individual or HUF (default true). Only they may choose 20% with indexation on land or a building bought before 23 July 2024 and sold after it; anyone else pays 12.5% without indexation.
  - `fmv_2001` number: Fair market value as on 1 April 2001; used INSTEAD of purchase_amount when the purchase is before that date
  - `development_costs` object[]: Improvement costs, each with its date
    - `date` string, required: YYYY-MM-DD
    - `amount` number, required

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)
