Creditor Search

Springstreet's Secured Party Search API allows users to retrieve a paginated list of UCC filings associated with a specific creditor (secured party) within a given state.

Endpoint

This endpoint retrieves all UCC lien data where the specified creditor is a secured party.

• Method: POST

• URL: https://api.springstreet.io/creditor

---

Headers

The following headers are required to properly authenticate and request data from Springstreet's API.

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 require the following fields to successfully search the API. Failure to include required details will result in an error.

Field	Type	Required	Description
secured_party_name	string	Yes	The full legal name of the secured party 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").
pagination_token	integer	No	The page number to retrieve. Defaults to 1 if not provided.

---

Example Request

The following request highlights the fields required to make a successful request to the Secured Party Search API.

{
  "secured_party_name": "JPMORGAN CHASE BANK NA",
  "jurisdiction_state": "UT",
  "pagination_token": 1
}

---

Example Response

A successful request will return a 200 OK status code with a JSON body containing the following structure.

{
    "primary_creditor": {
        "name": "JPMORGAN CHASE BANK NA"
    },
    "ucc_liens": [
        {
            "initial_financing_number": "464329201544",
            "initial_financing_date": "2015-03-03 00:00:00",
            "jurisdiction_state": "UT",
            "involved_parties": {
                "debtor_parties": [
                    {
                        "name": "ABC NUTRITION INC",
                        "type": "Organization",
                        "category": "Health & Wellness",
                        "address": {
                            "street1": "81 MAIN WAY DR",
                            "city": "OREM",
                            "state": "UT",
                            "zip_code": "84058-5117",
                            "country": "USA",
                            "maps_url": "https://www.google.com/maps/search/81 MAIN WAY DR,+OREM,+UT"
                        }
                    }
                ],
                "secured_parties": [
                    {
                        "name": "JPMORGAN CHASE BANK NA",
                        "type": "Secured Party",
                        "category": "Bank",
                        "address": {
                            "street1": "1 BANK ST",
                            "city": "LOUISVILLE",
                            "state": "KY",
                            "zip_code": "40232-3035",
                            "country": "USA",
                            "maps_url": "https://www.google.com/maps/search/1 BANK ST,+LOUISVILLE,+KY"
                        }
                    }
                ]
            },
            "amendments": []
        }
    ],
    "response_metadata": {
        "timestamp": "2025-06-29T21:45:00.123456Z",
        "request_id": "b4a3c2d1-e5f6-7890-1234-abcdef123456",
        "next_pagination_token": 2
    }
}

---

Response Definitions

The following section highlights the fields that are part of the API response.

---

primary_creditor

An object containing the name of the secured party that was searched for.

Field	Type	Description
name	string	The name of the secured party provided in the request.

---

ucc_liens

A top-level array where each object represents a single UCC financing statement that the primary creditor is associated with.

Field	Type	Description
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.
jurisdiction_state	string	The two-letter code for the state where the lien was filed.
involved_parties	object	An object containing arrays of all debtor and secured parties associated with this lien.
amendments	array	An array of amendment objects filed against the initial financing statement.

---

involved_parties

An array of associated creditor and debtors

Field	Type	Description
debtor_parties	array	An array of all debtor party objects on the filing.
secured_parties	array	An array of all secured party objects on the filing.

---

Party Object (Debtor & Secured)

The structure for objects within the debtor_parties and secured_parties arrays.

Field	Type	Description
name	string	The full name of the party.
type	string	The party's entity type (e.g., "Organization", "Individual").
category	string	The party's business category (e.g., "Bank", "Construction").
address	object	An object containing the party's address details.

---

amendments

An array of objects, where each object represents an amendment filing.

Field	Type	Description
amendment_financing_number	string	The filing number of the amendment itself.
amendment_financing_date	string	The date and time (ISO 8601 format) the amendment was filed.

---

response_metadata

An object containing metadata about the API response.

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.
next_pagination_token	integer	The page number for the next set of results. If this value is null, you have reached the last page.