Debtor Search
Springstreet's Debtor Search API users to retrieve existing, lapsed, and terminated UCC filings for Debtors. Additional metadata is calculated for each search to provide additional insight & context.
Endpoint
This endpoint retrieves all UCC lien data for a specified debtor.
Method:
POSTURL:
https://api.springstreet.io/debtor
Headers
The following headers are required to properly authenticate and request data from Springstreet's API. For more information regarding Authentication, please refer to our documentation.
Key
Value
Description
Content-Type
application/json
Specifies the request body format.
x-api-key
Your API Key
Required. Your unique key for authenticating with the API.
Request Body
Requests will require two fields in order to successfully search Springstreet's API. Failure to include these details will result in an error. If you receive an error, please refer to our Error documentation
search_primary_debtor
string
Yes
The full legal name of the debtor entity you wish to search for.
jurisdiction_state
string
Yes
The two-letter postal code for the state where the search should be performed (e.g., "CT", "TX").
Example Request
The following request highlights the fields required in order to make a success requst to Springstreet's Debtor Search API.
{
"search_primary_debtor": "ABC Corporation",
"jurisdiction_state": "CT"
}Example Response
A successful request will return a 200 OK status code with a JSON body containing the following structure.
{
"primary_debtor": {
"name": "ABC Corporation",
"type": "Business",
"category": "General Services",
"sos_profile_url": "https://www.sos.ct.gov/..."
},
"ucc_liens_summary": {
"total_financing_statements_active": 1,
"total_financing_statements_found": 2,
"total_financings_with_masked_secured_party": 0,
"total_financings_with_equipment_party": 1,
"total_financings_with_bank_party": 1,
"total_financings_with_government_party": 0,
"total_financing_with_other_party": 0
},
"ucc_lien_activity": {
"activity_level": "Active Borrower",
"filed_last_3_months": 0,
"filed_last_6_months": 1,
"filed_last_12_months": 0,
"filed_last_24_months": 0,
"filed_last_60_months": 1
},
"ucc_liens": [
{
"initial_financing_number": "2024031500789",
"initial_financing_date": "2024-03-15T11:45:00",
"estimated_lien_lapse_date": "2029-03-15",
"estimated_lien_status": "Active",
"jurisdiction_state": "CT",
"search_url": "https://search.ct.gov/...",
"involved_parties": {
"debtor_parties": [
{
"name": "ABC Corporation",
"type": "Organization",
"category": "General Services",
"address": {
"street1": "123 Business Rd",
"city": "Anytown",
"state": "CT",
"zip_code": "06101",
"country": "USA",
"maps_url": "https://maps.google.com/..."
}
}
],
"secured_parties": [
{
"name": "Regional Bank",
"type": "Organization",
"category": "Bank",
"address": { ... }
}
]
},
"amendments": []
},
{
"initial_financing_number": "2021072200321",
"initial_financing_date": "2021-07-22T09:00:00",
"estimated_lien_lapse_date": "2026-07-22",
"estimated_lien_status": "Active",
"jurisdiction_state": "CT",
...
}
],
"response_metadata": {
"timestamp": "2025-06-28T22:45:48.123456Z",
"request_id": "a1b2c3d4-e5f6-7890-1234-abcdef123456",
"data_source_last_updated": "2025-06-27T18:00:00",
"api_version": "1.10"
}
}Response Definitions
The following section highlights the fields & calculations that are part of the API response. Details regarding the calculations, classification, and definitions of each field are listed below.
primary_debtor
Details of the debtor that was searched for.
name
string
Full name of the debtor.
type
string
The entity type, e.g., "Business".
category
string
The business category of the debtor.
sos_profile_url
string
A Search URL to the debtor's profile on the OpenCorporates
ucc_liens_summary
A high-level summary of all financing statements found.
total_financing_statements_active
integer
The total count of UCC financing statements that are not terminated or lapsed.
total_financing_statements_found
integer
The total count of unique initial financing statements found for the debtor.
total_financings_with_masked_secured_party
integer
The count of unique financings involving a secured party with the category "Masked/Representative".
total_financings_with_equipment_party
integer
The count of unique financings involving a secured party with the category "Equipment Financing".
total_financings_with_bank_party
integer
The count of unique financings involving a secured party with the category "Bank".
total_financing_with_other_party
integer
The count of unique financings involving a secured party with the category not related to banks, equipment, or government, or masked parties.
ucc_lien_activity
Calculated fields wich determine the recency of borrowing activity.
activity_level
string
A calculated status of the borrower's activity. See Activity Level Definitions below.
filed_last_3_months
integer
The number of initial filings in the last 0-3 months.
filed_last_6_months
integer
The number of initial filings in the last 3-6 months.
filed_last_12_months
integer
The number of initial filings in the last 6-12 months.
filed_last_24_months
integer
The number of initial filings in the last 12-24 months.
filed_last_60_months
integer
The number of initial filings in the last 24-60 months.
Activity Level Definitions
The following list is a classification of a borrower's activity, based on their ucc_lien_activity results.
Active Borrower
string
The debtor has had at least one initial financing filed within the last 12 months.
Semi Active Borrower
string
The most recent initial financing was filed between 12 and 24 months ago.
Inactive Borrower
string
The most recent initial financing was filed between 24 and 60 months ago.
Dormant Borrower
string
All initial financings are older than 60 months, or no financings were found.
ucc_liens
An array of UCC lien objects. Each object represents a single initial financing statement and contains all related details.
initial_financing_number
string
The unique filing number of the original financing statement.
initial_financing_date
string
The date and time (ISO 8601 format) the original statement was filed.
estimated_lien_lapse_date
string
A calculated date (ISO 8601 format) when the lien is expected to lapse. The date is extended by non-termination amendments.
estimated_lien_status
string
A calculated status of the lien. See Lien Status Definitions below.
jurisdiction_state
string
The two-letter code for the state where the lien was filed.
search_url
string
A direct URL to the filing on the jurisdiction's website, if available.
involved_parties
object
An object containing arrays of all debtor and secured parties associated with this lien.
amendments
array
An array of objects, where each object represents an amendment to the initial filing.
estimated_lien_status
Calculated fields which identify the current status of any initial financing.
Active
string
The UCC has not been terminated and has yet to lapse
Lapsed
string
The UCC was not terminated or continued and has expired.
Terminated
string
An amendment has been filed to terminate the UCC position.
response_metadata
Information about the API response itself.
timestamp
string
The UTC timestamp (ISO 8601 format) of when the response was generated.
request_id
string
The unique ID for this specific API request, useful for debugging.
data_source_last_updated
string
A timestamp indicating when the underlying data source was last refreshed.
api_version
string
The version of the API that served the request.
Last updated