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
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | The 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
| Tier | Fields Included |
|---|---|
| Free | ~16 core fields including filing details, property address, owner name, and amounts. |
| Pro | All Free fields plus enriched property data: property characteristics, valuations, equity estimates, and geographic coordinates. |
| Enterprise | All Pro fields plus skip trace contact information: phone numbers, emails, and owner details. |
Error Responses
| Status Code | Description |
|---|---|
404 | Filing with the specified ID was not found. |
401 | Missing or invalid API key. |
{
"success": false,
"error": {
"code": "not_found",
"message": "Filing with id 99999 not found"
},
"meta": {
"request_id": "req_abc123"
}
}