Get Certificate
Full detail for a single Florida tax certificate by its id — bid rate, holder, redemption, and tax-deed-application state.
GET /api/v1/certificates/{id}
Returns full detail for a single tax certificate by its id (the platform's surrogate key, e.g. cert_7a3f29b1, returned in search results). The detail read carries the complete lifecycle: face amount, winning bid (interest) rate, holder, redemption amount and date, and any tax-deed application. To look certificates up by parcel instead, use Certificates by Parcel.
Authentication
curl -H "X-API-Key: fltc_test_..." \
"https://fltaxcerts.com/api/v1/certificates/cert_7a3f29b1"
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Certificate id (e.g. cert_7a3f29b1). |
Response (200)
Object envelope { data: Certificate, meta } — same row shape as Search Certificates.
{
"data": {
"id": "cert_7a3f29b1",
"certificate_number": "2024-04821",
"county_slug": "polk",
"county_name": "Polk",
"parcel_id": "262813-000000-012345",
"tax_year": 2023,
"status": "redeemed",
"face_amount": 3512.44,
"delinquent_amount": 3284.17,
"interest_rate": 5.25,
"sale_date": "2024-06-01",
"holder_id": "hld_3c19a7",
"holder_name": "MAGNOLIA TAX FUND LLC",
"vendor": "lienhub",
"redeemed": true,
"redeemed_date": "2025-03-18",
"redemption_amount": 3684.92,
"tax_deed_application_date": null,
"owner_name": "DOE JANE",
"site_address_full": "456 ORANGE AVE, LAKELAND FL 33801",
"parcel_url": "https://floridapropertyapi.com/parcels/polk/262813-000000-012345"
},
"meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}
When the certificate is unredeemed, redeemed is false and redeemed_date / redemption_amount are null. When a holder has applied for a tax deed, status is tax_deed_applied and tax_deed_application_date is set.
Error Responses
| Status | Code | Cause |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
404 | not_found | No certificate with that id. |
429 | rate_limited | Rate limit exceeded. |
500 | internal_error | Server error — retry with backoff. |
Search Certificates
Search Florida tax certificates by county, status, tax year, holder, vendor, face-amount range, sale-date range, and redemption flag.
Certificates by Parcel
All tax certificates for a single county parcel id. Returns an empty list (not 404) when the parcel has no certificates or the county is uncovered.