Available Months

GET /v1/counties/{county}/months

Returns an array of months (in YYYY-MM format) for which filing data is available in a specific county. Use this to populate month selectors or to determine data coverage for a county.

Path Parameters

Parameter	Type	Required	Description
county	string	Yes	The county name. Must match a value returned by the List Counties endpoint.

Example Request

curl -X GET "https://api.acqatlas.com/v1/counties/Franklin/months" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    "2024-01",
    "2024-02",
    "2024-03",
    "2024-04",
    "2024-05",
    "2024-06",
    "2024-07",
    "2024-08",
    "2024-09",
    "2024-10",
    "2024-11",
    "2024-12",
    "2025-01",
    "2025-02",
    "2025-03",
    "2025-04",
    "2025-05",
    "2025-06"
  ]
}

Response Format

The data field contains a flat array of month strings in YYYY-MM format, sorted chronologically. Each entry represents a month during which at least one filing was recorded in the specified county.

Error Responses

Status Code	Description
404	The specified county was not found.
401	Missing or invalid API key.

tip

Pass a month value from this endpoint directly to the month query parameter on the List Filings endpoint to filter results to a specific recording month.