---
description: >-
  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.
---

# Debtor Search

## Endpoint

This endpoint retrieves all UCC lien data for a specified debtor.

* Method: `POST`
* URL: `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](../authentication), please refer to our documentation.&#x20;

| 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](../errors) documentation

<table><thead><tr><th width="221.15234375">Field</th><th width="129.41796875">Type</th><th width="134.4921875">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>search_primary_debtor</code></td><td>string</td><td>Yes</td><td>The full legal name of the debtor entity you wish to search for.</td></tr><tr><td><code>jurisdiction_state</code></td><td>string</td><td>Yes</td><td>The two-letter postal code for the state where the search should be performed (e.g., "CT", "TX").</td></tr></tbody></table>

***

## Example Request

The following request highlights the fields required in order to make a success requst to Springstreet's Debtor Search API.

```json
{
  "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.



```json
{
  "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.

| Field             | Type   | Description                                                |
| ----------------- | ------ | ---------------------------------------------------------- |
| 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.

<table><thead><tr><th width="327.46875">Field</th><th width="130.8515625">Type</th><th>Text</th></tr></thead><tbody><tr><td>total_financing_statements_active</td><td>integer</td><td>The total count of UCC financing statements that are not terminated or lapsed.</td></tr><tr><td>total_financing_statements_found</td><td>integer</td><td>The total count of unique initial financing statements found for the debtor.</td></tr><tr><td>total_financings_with_masked_secured_party</td><td>integer</td><td>The count of unique financings involving a secured party with the category "Masked/Representative".</td></tr><tr><td>total_financings_with_equipment_party</td><td>integer</td><td>The count of unique financings involving a secured party with the category "Equipment Financing".</td></tr><tr><td>total_financings_with_bank_party</td><td>integer</td><td>The count of unique financings involving a secured party with the category "Bank".</td></tr><tr><td>total_financing_with_other_party</td><td>integer</td><td>The count of unique financings involving a secured party with the category not related to banks, equipment, or government, or masked parties.</td></tr></tbody></table>

***

### ucc\_lien\_activity

Calculated fields wich determine the recency of borrowing activity.

| Field                   | Type    | Description                                                                                                          |
| ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| activity\_level         | string  | A calculated status of the borrower's activity. See [Activity Level Definitions](#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](#ucc_lien_activity) results.

<table><thead><tr><th width="244.33984375">Value</th><th width="160.578125">Type</th><th>Defintion</th></tr></thead><tbody><tr><td>Active Borrower</td><td>string</td><td>The debtor has had at least one initial financing filed within the last 12 months.</td></tr><tr><td>Semi Active Borrower</td><td>string</td><td>The most recent initial financing was filed between 12 and 24 months ago.</td></tr><tr><td>Inactive Borrower</td><td>string</td><td>The most recent initial financing was filed between 24 and 60 months ago.</td></tr><tr><td>Dormant Borrower</td><td>string</td><td>All initial financings are older than 60 months, or no financings were found.</td></tr></tbody></table>



\


***

### ucc\_liens

An array of UCC lien objects. Each object represents a single initial financing statement and contains all related details.



| Field                        | Type   | Descripti                                                                                                                   |
| ---------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| 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.&#x20;

<table><thead><tr><th width="181.65625">Value</th><th width="175.359375">Type</th><th>Definition</th></tr></thead><tbody><tr><td>Active</td><td>string</td><td>The UCC has not been terminated and has yet to lapse</td></tr><tr><td>Lapsed</td><td>string</td><td>The UCC was not terminated or continued and has expired.</td></tr><tr><td>Terminated</td><td>string</td><td>An amendment has been filed to terminate the UCC position.</td></tr></tbody></table>



### response\_metadata

Information about the API response itself.

| Field                       | Type   | Description                                                                |
| --------------------------- | ------ | -------------------------------------------------------------------------- |
| 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.                            |

