Debtor Keywords

Use the keyword search to find similarly-named debtors for more comprehensive underwriting, or to identify debtors in specific industries.

Use Case

Springstreet's Debtor Keywords API allows users to retrieve a paginated list of distinct debtors that are similar to the keyword searched.

Underwriting & Legal

Users of the Debtor Keywords API can produce a comprehensive review for Underwriting teams to uncover UCC filings that have been filed against similarly named Debtors. This comprehensive keyword search can identify hidden financing relationships (e.g lien filing against "ABC Construction" and "ABC Construction Inc.")

Sales

Sales organizations can leverage Springstreet's Keywords API to identify customer and industry trends. For example, sales organizations can search for "solar", "automotive", "farm" keywords to identify prospecting opportunities.

Endpoint

This endpoint retrieves debtor entities based on a partial name match within a specific state.

• Method: POST

• URL: https://api.springstreet.io/debtor/keyword

---

Headers

The following headers are required to properly authenticate and request data from the 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
search_keyword	string	Yes	The partial or full name of the debtor you wish to search for.
debtor_state	string	Yes	The two-letter postal code for the state where the search should be performed (e.g., "NY", "CA").
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 Debtor Search API.

{
  "search_keyword": "ACME",
  "debtor_state": "TX",
  "pagination_token": 1
}

---

Example Response

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

{
    "debtors": [
        {
            "name": "ACME CORPORATION INC",
            "type": "Organization",
            "category": "Manufacturing",
            "sos_profile_url": "https://sos.state.tx.us/corp/filings/view/12345678",
            "address": {
                "street1": "123 INNOVATION DRIVE",
                "city": "AUSTIN",
                "state": "TX",
                "zip_code": "78701",
                "maps_url": "https://maps.google.com/?q=123+INNOVATION+DRIVE,AUSTIN,TX"
            }
        },
        {
            "name": "ACME LOGISTICS LLC",
            "type": "Organization",
            "category": "Transportation",
            "sos_profile_url": "https://sos.state.tx.us/corp/filings/view/87654321",
            "address": {
                "street1": "456 DISTRIBUTION WAY",
                "city": "HOUSTON",
                "state": "TX",
                "zip_code": "77002",
                "maps_url": "https://maps.google.com/?q=456+DISTRIBUTION+WAY,HOUSTON,TX"
            }
        }
    ],
    "response_metadata": {
        "timestamp": "2025-06-29T22:55:14.987654Z",
        "request_id": "a1b2c3d4-e5f6-7890-1234-abcdef123456",
        "next_pagination_token": 2
    }
}

---

Response Definitions

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

Root Object

The top-level object in the response body.

Field	Type	Description
debtors	array	A top-level array where each object represents a unique debtor matching the search criteria.
response_metadata	object	An object containing metadata about the API response.

Debtor Object

The structure for each object within the debtors array.

Field	Type	Description
name	string	The full name of the debtor party.
type	string	The party's entity type (e.g., "Organization", "Individual").
category	string	The party's business category (e.g., "Services", "Retail").
sos_profile_url	string	A URL to the debtor's profile on the Secretary of State website, if available.
address	object	An object containing the debtor's address details.

Address Object

The structure for the nested address object.

Field	Type	Description
street1	string	The primary street address.
city	string	The city name.
state	string	The two-letter postal code for the state.
zip_code	string	The postal ZIP code.
maps_url	string	A URL to the address location on Google Maps.

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.