County Statistics

GET /v1/stats/counties

Returns per-county aggregate statistics. Useful for comparing filing activity and amounts across different counties.

Query Parameters

Parameter	Type	Default	Description
state	string		Optional. Filter counties by state abbreviation (e.g., OH, FL). When omitted, returns statistics for all counties.

Example Request

curl -X GET "https://api.acqatlas.com/v1/stats/counties?state=OH" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "county": "Franklin",
      "state": "OH",
      "filingCount": 42531,
      "totalAmount": 358742100.00,
      "avgAmount": 8435.20,
      "minAmount": 125.00,
      "maxAmount": 875000.00
    },
    {
      "county": "Hamilton",
      "state": "OH",
      "filingCount": 31204,
      "totalAmount": 241506800.00,
      "avgAmount": 7738.50,
      "minAmount": 52.00,
      "maxAmount": 620000.00
    },
    {
      "county": "Cuyahoga",
      "state": "OH",
      "filingCount": 28915,
      "totalAmount": 215389200.00,
      "avgAmount": 7449.10,
      "minAmount": 78.00,
      "maxAmount": 1250000.00
    }
  ]
}

Response Fields

Each object in the data array contains:

Field	Type	Description
county	string	County name.
state	string	Two-letter state abbreviation.
filingCount	integer	Total number of filings in this county.
totalAmount	number	Sum of all filing amounts in this county.
avgAmount	number	Average filing amount for this county.
minAmount	number	Smallest filing amount in this county.
maxAmount	number	Largest filing amount in this county.

tip

Combine this endpoint with the List Counties endpoint to build county selection UIs that show filing counts and average amounts alongside each county name.