Surplus Docket
SURPLUS DOCKET
REST API Reference v1.0
Production REST API Live

Programmatic Public Records API

The Surplus Docket REST API delivers structured, daily-refreshed tax deed surplus and excess proceeds datasets directly to law firm CRMs, legal research software, and custom automated pipelines.

Base Endpoint URL

https://surplusdocket.com/api/v1 HTTPS / JSON

All requests use standard HTTPS GET requests and return structured UTF-8 JSON. Cross-Origin Resource Sharing (CORS) is enabled on all endpoints.

GET /api/v1/feed.json

Returns the master consolidated multi-state public records dataset across all monitored Florida and Texas jurisdictions.

curl -s "https://surplusdocket.com/api/v1/feed.json"
GET /api/v1/florida.json

Returns filtered Florida clerk of court tax deed surplus records governed by Fla. Stat. § 197.582.

curl -s "https://surplusdocket.com/api/v1/florida.json"
GET /api/v1/texas.json

Returns filtered Texas district court registry excess proceeds records governed by Tex. Tax Code § 34.04.

curl -s "https://surplusdocket.com/api/v1/texas.json"
GET /api/v1/health.json

Health check endpoint returning API version, system uptime, and endpoint manifest.

curl -s "https://surplusdocket.com/api/v1/health.json"

Integration Snippets

Python (Pandas / Requests)
import requests
import pandas as pd

# Fetch Master Feed
url = "https://surplusdocket.com/api/v1/feed.json"
response = requests.get(url)
data = response.json()

# Convert records to DataFrame
df = pd.DataFrame(data["records"])
print(f"Total claims indexed: {len(df)}")
print(df[["State", "County", "Case_or_TaxDeed_No", "Surplus_Balance_USD"]].head())