address_history
Retrieves every NYC 311 service request for a given address, newest first, with status, days open or closed, resolution text, and issue-type counts; supports date, status, and borough filters.
Instructions
Every request at one address, newest first, with its status, days to close or days open, and the agency's resolution text, plus counts by problem. The address is converted to the City's spelling as in find_district. With no dates, covers every request since 2020. From BoardStat (BetaNYC, NYC Open Data, 2020 on); not an official City report. 311 counts are reports, not problems; 'closed' is not 'fixed'.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>"
},
"name": "address_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to list (default 50). | |
| offset | No | Rows to skip (default 0); for the next page, next_page.offset. | |
| status | No | 'not_closed' = any status but Closed. | |
| address | Yes | Street address, e.g. '1000 5th Ave'. | |
| borough | No | Needed when the same address exists in several boroughs. | |
| to_date | No | End, YYYY-MM-DD, inclusive. | |
| problems | No | BoardStat problem names, e.g. ['HEAT/HOT WATER']; any case. | |
| from_date | No | Start, YYYY-MM-DD, inclusive. | |
| last_days | No | The last N days of data, ending on the newest request's day (not today). | |
| data_as_of | No | For the next page, next_page.data_as_of; a page from a newer build is refused. | |
| fiscal_year | No | NYC fiscal year: 2027 or 'FY2027' = 2026-07-01 to 2027-06-30. | |
| community_district | No | Optional: the district (BoardStat id) to use when the address straddles a line. Default: the one with the most requests there. |