---
title: "Capital gains tax estimate"
method: GET
path: "/api/v1/calculate/capital-gains-tax"
---

# Capital gains tax estimate

`GET /api/v1/calculate/capital-gains-tax`

## Request

- Base URL: `https://everycalc.xyz`
- URL: `https://everycalc.xyz/api/v1/calculate/capital-gains-tax`
- Auth: none declared

Federal tax on ordinary income plus short term gains at ordinary rates, with long term gains stacked at the 0, 15, and 20 percent thresholds for the filing status. Results match the interactive calculator at everycalc.xyz; every response includes a calculator_url deep link to it.

## Query parameters

- `filing_status` 'single' | 'mfj' | 'hoh'
- `ordinary_income` number, required
- `long_term_gains` number, required
- `short_term_gains` number

## Response `200`

Calculation result.

## Other responses

- `400`: Invalid input.

---

[API](https://skmtc.dev/everycalc/apis/everycalc-api.md) · [All operations](https://skmtc.dev/everycalc/apis/everycalc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/everycalc/apis/everycalc-api/revisions/a4bd5db0868a?raw)