---
title: "Cited property-value appeal deadline calculator"
method: POST
path: "/api/locus_appeal_window"
tags: ["taxes", "appeals", "deadlines", "read-only", "free", "free"]
---

# Cited property-value appeal deadline calculator

`POST /api/locus_appeal_window`

## Request

- Base URL: `https://api.locus.report`
- URL: `https://api.locus.report/api/locus_appeal_window`
- Auth: none required

Compute the property-value appeal/protest filing deadline from a US address, two-letter state code, or full state name and, when given, the date on the owner's notice. Pure date arithmetic on a cited rule; returns both candidates for later-of rules; never advises whether to appeal. Covered states: TX GA AZ FL NC CO OH NJ WA CA NY IL MI TN; PA only for Philadelphia. Locality rows: New York City class 1, New York City other classes, Nassau County, Philadelphia. Other localities return coverage guidance to locus_tax_calendar and locus_appeal_filing_guide.
Use this when you can call Locus free tools (REST tools/call or MCP).
Use locus-appeal-window instead when your client can only call paid x402 routes; it returns the same records. Direct flat-body route for this one free resource; no API key, payment, or catalog wrapper. Return only the cited bounded evidence described here; this route never produces a paid brief or full report.

## Request body

- object
  - `noticeDate` string, date: Optional ISO date YYYY-MM-DD from the owner's notice; use the mailed, delivered, printed, or publication date named by the returned rule.
  - `year` integer: Tax year; defaults to the current year.
  - `locality` string: Optional locality row: nyc_class1, nyc_other, nassau, or philadelphia. Other localities return coverage guidance.
  - `propertyClass` string: Optional published property class. NYC class 1 selects the nyc_class1 row when locality is not supplied.
  - `revaluationYear` boolean: NJ only: true when a municipal-wide revaluation or reassessment was implemented.
  - `countyExtended` boolean: WA only: true when the county adopted the 60-day notice period.
  - `state` string: Two-letter US state abbreviation or full state name, for example TX or Texas.
  - `address` string: Full US address used to resolve the governing state, county, and locality.

## Response `200`

Free cited evidence response.

- object

## Other responses

- `400`: Invalid request body.
- `429`: Rate limited.

---

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