Date Ranges

GET /v1/counties/{county}/date-ranges

Returns an array of available date range strings for a specific county. These represent the distinct recording date ranges present in the filing data for that 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/date-ranges" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    "2024-01-01 to 2024-03-31",
    "2024-04-01 to 2024-06-30",
    "2024-07-01 to 2024-09-30",
    "2024-10-01 to 2024-12-31",
    "2025-01-01 to 2025-03-31",
    "2025-04-01 to 2025-06-30"
  ]
}

Response Format

The data field contains a flat array of date range strings. Each string represents a time period for which filing records exist in the specified county.

Error Responses

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

tip

Use the date range values from this endpoint to inform the date_start and date_end filters on the List Filings endpoint. This helps you query only the time periods where data is available for a given county.