---
title: "List all 50 states with property tax rates"
method: POST
path: "/api/v1/list-states"
tags: ["calculations"]
---

# List all 50 states with property tax rates

`POST /api/v1/list-states`

## Request

- Base URL: `https://www.usmortgagecalc.com`
- URL: `https://www.usmortgagecalc.com/api/v1/list-states`
- Auth: none declared

Every US state with its average effective property tax rate, median home value and estimated annual tax. Sortable, so it answers 'which states have the highest property taxes' directly. Call this to discover valid state names for the other tools.

## Request body

- object: All 50 states with average property tax rate, median home value and estimated annual tax.
  - `sortBy` 'name' | 'taxRate' | 'medianHomeValue': Ordering of the returned list.
  - `order` 'asc' | 'desc': Sort direction.
  - `limit` integer: How many states to return.

## Response `200`

Calculation result.

- object
  - `data` object: The calculation result.
  - `meta` object
    - `operation` string
    - `computedAt` string, date-time

## Other responses

- `400`: Input failed validation. The message names the offending field.
- `429`: Rate limit exceeded. Retry after the interval in Retry-After.

---

[API](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api.md) · [All operations](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api/revisions/4439848058a8?raw)