---
title: "Cited owner-program dates within a bounded window"
method: POST
path: "/api/locus_program_windows"
tags: ["owner-programs", "read-only", "free", "free"]
---

# Cited owner-program dates within a bounded window

`POST /api/locus_program_windows`

## Request

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

Exact dates printed in matching owner-program registry rows, for agents. Returns upcoming dates inside a caller-selected 1-to-400-day window and dates that passed in the prior 60 days. Use to read printed program dates only. It does not infer or calculate dates beyond deterministic window filtering.
Use this when you can call Locus free tools (REST tools/call or MCP).
Use locus-program-windows 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
  - `address` string: US street address or ZIP used to resolve state, county, and city program rows.
  - `place` string: US city, county, state, ZIP, or address used to resolve program rows.
  - `withinDays` integer: Days after asOf to include; default 120, maximum 400.
  - `asOf` string, date: Optional ISO date YYYY-MM-DD; defaults to today's UTC date.

## 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)