Florida UCC APIfloridaucc.com ↗
Search and retrieve Florida Secured Transaction Registry UCC filings by debtor name or filing number, including parties, dates, and amendment history.
What is the Florida UCC API?
The Florida UCC API gives developers programmatic access to the Florida Secured Transaction Registry through 3 endpoints covering debtor name search, filing number lookup, and full amendment history retrieval. The search_filings endpoint returns paginated debtor records with UCC numbers, addresses, and statuses, while get_filing_details surfaces the complete chain of filing events including continuations and amendments for any UCC number.
curl -X GET 'https://api.parse.bot/scraper/e4bafb86-001c-4bc4-9dcc-8dec9555cc68/search_filings?name=WALMART&sub_option=FiledCompactDebtorNameList&search_type=OrganizationDebtorName&search_category=Exact' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace floridaucc-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Florida UCC filing search — bounded, re-runnable."""
from parse_apis.floridaucc_com_api import FloridaUcc, SearchType, SearchCategory, InputNotFound
client = FloridaUcc()
# Search for organization debtor records matching a name.
for debtor in client.debtors.search(
name="WALMART",
search_type=SearchType.ORGANIZATION,
search_category=SearchCategory.EXACT,
limit=5,
):
print(debtor.name, debtor.ucc_number, debtor.city, debtor.state)
# Drill into the first match to get full filing details (parties, history).
hit = client.debtors.search(name="WALMART", limit=1).first()
if hit is not None:
filing = client.debtors.details(ucc_number=hit.ucc_number)
print(filing.ucc_number, filing.status, filing.document_type)
print("filed:", filing.file_date, "expires:", filing.expiration_date)
for party in filing.debtors:
print(" debtor:", party.name, party.address, party.city, party.state)
for party in filing.secured_parties:
print(" secured:", party.name, party.city, party.state)
# Walk amendment history when present.
if filing.filing_history:
for event in filing.filing_history:
print(" event:", event.document_number, event.type, event.date)
# Point lookup by filing number (e.g. from an external reference).
try:
direct = client.filings.lookup(filing_number="202107875591")
print(direct.ucc_number, direct.status, direct.file_image_exists)
except InputNotFound:
print("filing not found")
print("exercised: debtors.search / debtors.details / filings.lookup")
Search Florida UCC filings by debtor name (organization or individual). Returns a paginated list of matching debtor records with filing numbers, addresses, and statuses. Each page returns up to 20 results. Use row_number from the next_row_number field of a previous response to retrieve the next page of results. The search_category parameter (Standard for proximity search, Exact for standard search logic) applies only when search_type is OrganizationDebtorName and sub_option is a Compact name list; for Individual or Actual name lists it is ignored.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Debtor name to search for. For organization searches, enter the organization name (e.g. 'WALMART'). For individual searches, enter as 'LASTNAME FIRSTNAME' (e.g. 'SMITH JOHN'). |
| row_number | string | Pagination cursor from next_row_number or previous_row_number of a prior response. Omit for the first page. |
| sub_option | string | Search sub-option controlling which name list to search and whether to include filed, lapsed, or both. Compact lists use the state's compact name matching algorithm; Actual lists match the exact filed name. |
| search_type | string | Type of debtor name search. |
| search_category | string | Search matching mode. Only applies when search_type is OrganizationDebtorName and sub_option is a Compact name list. Omitted for Individual and Actual name list searches. |
{
"type": "object",
"fields": {
"debtors": "array of debtor records, each with rowNumber, name, uccNumber, address, city, zipCode, state, and status",
"next_row_number": "integer cursor for the next page, or null if no more results",
"previous_row_number": "integer cursor for the previous page, or null",
"total_exact_matches": "integer count of exact matches when available (only for Exact organization searches), otherwise null"
},
"sample": {
"data": {
"debtors": [
{
"city": "BENTONVILLE",
"name": "WALMART",
"state": "AR",
"status": "Filed",
"address": "702 SW 8TH ST",
"zipCode": "72712",
"rowNumber": 6075196,
"uccNumber": "202107875591"
},
{
"city": "BENTONVILLE",
"name": "WALMART INC",
"state": "AR",
"status": "Filed",
"address": "702 SW 8TH ST",
"zipCode": "72716",
"rowNumber": 7113558,
"uccNumber": "202501371222"
}
],
"next_row_number": null,
"previous_row_number": null,
"total_exact_matches": 2
},
"status": "success"
}
}About the Florida UCC API
What the API Covers
The API exposes filings recorded in the Florida Secured Transaction Registry (UCC filings). Each filing record includes the UCC number, the original UCC-1 number, document type (UCC1 or UCC3), file date, expiration date, current status (Filed or Lapsed), debtor party details, and secured party details. The search_by_filing_number endpoint also returns a filing_events_count integer indicating how many amendments or continuations exist, and a file_image_exists boolean.
Searching Filings
The search_filings endpoint accepts a name string and optional parameters to control matching behavior. The search_type parameter distinguishes organization debtor searches from individual debtor searches. The sub_option parameter controls which name list is searched and whether to include active filings, lapsed filings, or both. For organization searches, the search_category parameter selects the matching mode (e.g., exact or compact). Results are paginated at 20 records per page; use the next_row_number field from a response as the row_number input on the next call to walk forward through results.
Filing Detail and History
get_filing_details accepts a ucc_number (obtained from search_filings results) and returns the full filing record plus a filing_history array. Each element in that array includes a document_number, event type, date, pages, file_image_exists, and an actions array. When no amendments exist the history array is empty. search_by_filing_number accepts a 12-character filing_number directly and returns the same core fields without the extended history array, making it useful for quick status checks when you already have the document number.
The Florida UCC API is a managed, monitored endpoint for floridaucc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when floridaucc.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official floridaucc.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Verify the lien status of a Florida business before a commercial transaction by checking its UCC filings by debtor name
- Monitor a portfolio of existing UCC filings for expiration by tracking
expiration_datefields across filing number lookups - Build a due-diligence tool that maps all secured parties attached to a debtor's active filings
- Audit amendment chains on long-running financing arrangements using the
filing_historyevents returned byget_filing_details - Identify lapsed filings that may indicate a creditor released a security interest on a specific debtor
- Aggregate debtor address data from UCC records to enrich business contact databases
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does floridaucc.com offer an official developer API?+
What does `get_filing_details` return that `search_by_filing_number` does not?+
get_filing_details includes a filing_history array with every amendment and continuation event on record — each entry has a document_number, event type, date, pages, file_image_exists, and an actions array. search_by_filing_number returns only a filing_events_count integer rather than the full history, making it faster for status checks but unsuitable when you need the complete amendment chain.How does pagination work in `search_filings`?+
next_row_number and previous_row_number field. Pass the value of next_row_number as the row_number input on your next request to retrieve the following page of up to 20 debtor records. When next_row_number is null, you have reached the last page. The total_exact_matches count is only populated for exact organization name searches; it is null for all other search types.Does the API return the actual filing document images?+
file_image_exists boolean indicates whether an image is on record for a given filing or history event, but the API does not return or link to the document image itself. The API covers filing metadata, party details, dates, statuses, and amendment history. You can fork this API on Parse and revise it to add an endpoint that retrieves or links to the image file if that capability is needed.