Skip to main content

Get Filing Details

GET /v1/filings/{id}

Returns the full details of a single filing by its unique ID. The fields returned depend on your subscription tier.

Path Parameters

ParameterTypeRequiredDescription
idintegerYesThe unique identifier of the filing.

Example Request

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

Example Response (Pro Tier)

{
"success": true,
"data": {
"id": 12345,
"county": "Franklin, OH",
"caseNumber": "2025-TX-004521",
"owner": "John A. Smith",
"propertyAddress": "1234 Main St, Columbus, OH 43215",
"filingType": "Tax Lien",
"filingAmount": 12450.00,
"currentAmount": 13200.50,
"filingDate": "2025-03-15",
"filingHolder": "Franklin County Treasurer",
"geocodedLatitude": 39.9612,
"geocodedLongitude": -82.9988,
"propertyClassification": "residential",
"categories": ["residential"],
"propertyType": "SFR",
"bedrooms": 3,
"bathrooms": 2,
"squareFootage": 1850,
"lotSizeAcres": 0.25,
"yearBuilt": 1965,
"estimatedValue": 185000,
"homeEquityEstimate": 78550,
"lastSaleDate": "2018-06-20",
"lastSalePrice": 145000,
"foreclosureStatus": null,
"standardizedAddress": "1234 Main St, Columbus, OH 43215",
"aiSummary": "Tax lien filed against residential property..."
},
"meta": {
"request_id": "req_abc123",
"tier": "pro",
"rate_limit_remaining": 4822
}
}

Response Fields by Tier

TierFields Included
Free~16 core fields including filing details, property address, owner name, and amounts.
ProAll Free fields plus enriched property data: property characteristics, valuations, equity estimates, and geographic coordinates.
EnterpriseAll Pro fields plus skip trace contact information: phone numbers, emails, and owner details.

Error Responses

Status CodeDescription
404Filing with the specified ID was not found.
401Missing or invalid API key.
{
"success": false,
"error": {
"code": "not_found",
"message": "Filing with id 99999 not found"
},
"meta": {
"request_id": "req_abc123"
}
}