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

# Creditor Search

## 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.



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

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

\
