Statistics

GET /v1/stats

Returns aggregate statistics across the entire filing database. Useful for building dashboards and summary views.

Parameters

This endpoint takes no parameters.

Example Request

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

Example Response

{
  "data": {
    "totalFilings": 248531,
    "uniqueOwners": 187204,
    "avgAmount": 8432.50,
    "minAmount": 52.00,
    "maxAmount": 1250000.00,
    "totalValue": 2095487632.00,
    "newThisWeek": 1243,
    "newThisMonth": 5872,
    "trustCount": 18742,
    "estateCount": 3291,
    "combinedTrustEstate": 22033,
    "trustPercentage": 7.54,
    "combinedPercentage": 8.86
  }
}

Response Fields

Field	Type	Description
totalFilings	integer	Total number of filings in the database.
uniqueOwners	integer	Number of distinct property owners.
avgAmount	number	Average filing amount in dollars.
minAmount	number	Smallest filing amount in the database.
maxAmount	number	Largest filing amount in the database.
totalValue	number	Sum of all filing amounts.
newThisWeek	integer	Number of filings added in the last 7 days.
newThisMonth	integer	Number of filings added in the last 30 days.
trustCount	integer	Number of filings where the owner is a trust.
estateCount	integer	Number of filings where the owner is an estate.
combinedTrustEstate	integer	Total filings owned by trusts or estates.
trustPercentage	number	Percentage of all filings owned by trusts.
combinedPercentage	number	Percentage of all filings owned by trusts or estates.

note

Statistics are computed across all filings regardless of your subscription tier. The values reflect the full database, not just the fields your tier can access.