Search Filings

GET /v1/filings/search

Performs a full-text search across filing records. The search term is matched against owner names, property addresses, case numbers, and county names.

Query Parameters

Parameter	Type	Default	Description
q	string	required	Search term. Searches across owner, property address, case number, and county.
min_amount	number		Minimum filing amount in dollars.
max_amount	number		Maximum filing amount in dollars.
property_type	string		Filter by property type (e.g., residential, commercial).
date_range	integer		Only return filings recorded within the last N days.
city	string		Filter by city name.
sort_by	string	record_date	Field to sort results by. One of: record_date, filing_amount, current_amount, property_owner, created_at.
sort_order	string	DESC	Sort direction. One of: ASC, DESC.
limit	integer	20	Number of results per page. Max 100.
offset	integer	0	Number of results to skip for pagination.

Example Request

curl -X GET "https://api.acqatlas.com/v1/filings/search?q=Smith&min_amount=1000&sort_by=filing_amount&sort_order=DESC&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": [
    {
      "id": 67890,
      "county": "Franklin, OH",
      "caseNumber": "2025-TX-008732",
      "owner": "Smith Family Trust",
      "propertyAddress": "5678 Oak Ave, Columbus, OH 43201",
      "filingType": "Tax Lien",
      "filingAmount": 28750.00,
      "currentAmount": 29100.00,
      "filingDate": "2025-05-10",
      "filingHolder": "Franklin County Treasurer",
      "categories": ["residential"]
    },
    {
      "id": 67891,
      "county": "Hamilton, OH",
      "caseNumber": "2025-ML-001234",
      "owner": "Robert J. Smith",
      "propertyAddress": "910 Elm St, Cincinnati, OH 45202",
      "filingType": "Municipal Lien",
      "filingAmount": 8200.00,
      "currentAmount": 8200.00,
      "filingDate": "2025-04-22",
      "filingHolder": "City of Cincinnati",
      "categories": ["commercial"]
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 5,
    "offset": 0,
    "has_more": true
  },
  "meta": {
    "request_id": "req_abc123",
    "tier": "free",
    "rate_limit_remaining": 93
  }
}

Sort Options

sort_by Value	Description
record_date	Date the filing was recorded (default).
filing_amount	Original filing amount.
current_amount	Current outstanding amount.
property_owner	Alphabetical by owner name.
created_at	Date the record was added to Acquisition Atlas.

tip

Use the q parameter for broad searches. For example, searching "123 Main" will match any filing with that substring in the owner name, address, case number, or county. Combine with filters like min_amount or city to narrow results.

Response Fields by Tier

Search results return the same tier-based fields as the List Filings endpoint:

• Free -- ~16 core fields
• Pro -- Core fields plus enriched property data
• Enterprise -- All fields plus skip trace contacts