Skip to main content
POST
/
v1
/
ucc
/
debtor
Fetch debtor UCC records
curl --request POST \
  --url https://api.example.com/v1/ucc/debtor \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "zip_code": [
    "90210",
    "10001"
  ],
  "near_zip_code": "90210",
  "radius": 25,
  "radius_unit": "mi",
  "sort_by": "date_filed_unix:desc",
  "sort_order": "desc",
  "saved_search_list_id": "abc123-client",
  "saved_search_field": "company_name",
  "url": "https://www.equipmentshare.com",
  "company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "secured_party_company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "debtor_type": [
    "Individual",
    "Organization"
  ],
  "phone": [
    "123-456-7890",
    987654321
  ],
  "company_name": [
    "Example Company",
    "John West Auto Body Shop"
  ],
  "secured_party_name": [
    "John Deere",
    "Wells Fargo"
  ],
  "address": [
    "123 Main St, Austin, TX 78701",
    "456 Oak Ave, Crescent Springs, KY"
  ],
  "city": [
    "Austin",
    "Crescent Springs"
  ],
  "state": [
    "ND",
    "MN"
  ],
  "state_filing": [
    "ND",
    "MN"
  ],
  "collateral": [
    "furniture",
    "equipment"
  ],
  "collateral_match_mode": "or",
  "assets": [
    "inventory",
    "accounts receivable"
  ],
  "has_collateral": true,
  "has_assets": true,
  "has_continuation": true,
  "has_amendment": true,
  "has_website": true,
  "has_contacts": true,
  "page": 1,
  "per_page": 50,
  "naics_code": [
    "523110",
    541330
  ],
  "naics_description": [
    "Investment Banking and Securities Dealing",
    "Commercial Banking"
  ],
  "eight_digit_sic_code": [
    "61410103",
    12345678
  ],
  "eight_digit_sic_description": [
    "Financing: automobiles, furniture, etc., not a deposit bank",
    "Other description"
  ],
  "four_digit_sic_code": [
    "6141",
    1234
  ],
  "four_digit_sic_description": [
    "Personal credit institutions",
    "Commercial banking"
  ],
  "two_digit_sic_code": [
    "61",
    62
  ],
  "two_digit_sic_description": [
    "Nondepository Credit Institutions",
    "Commercial Banking"
  ],
  "industry": [
    "Banking",
    "Financial Services"
  ],
  "secured_party_industry": [
    "Banking",
    "Financial Services"
  ],
  "filing_number": [
    "12345678",
    "2005-2120595-61"
  ],
  "one_filing_per_debtor": true,
  "company_filing_count": 3,
  "modified_date": "2023-01-31",
  "exclude": {
    "phone": [
      "9876543210"
    ],
    "url": [
      "https://exclude.com"
    ]
  },
  "date_filed": "2023-01-31",
  "date_expired": "2024-01-31",
  "annual_revenue": 5000000,
  "number_employees": 50,
  "time_in_business": 3
}
'
{
  "success": true,
  "records": [
    {
      "address": "2617 Anderson Road",
      "address_raw": "2617  ANDERSON RD CRESCENT SPRINGS KY 41017",
      "amendments": [],
      "base_url": "elementshairstudio.net",
      "city": "Crescent Springs",
      "collateral": "All of the following property now owned or existing or hereafter acquired by the Debtor (or by the Debtor with spouse), wherever located: all accounts; inventory; equipment; fixtures; instruments; documents; chattel paper; investment property; deposit accounts; letter of credit rights and all accessions to, replacements of and substitutions for and all supporting obligations, products and proceeds of any of the foregoing (in whatever form); and all books, records and data relating to any of the foregoing (in whatever form); together with Debtor’s right title and interest in and to all software required to utilize, create, maintain and process such records or data on electronic media. Other than the sale or lease of inventory in the ordinary course of Debtor’s business, the purchase by or pledge to another person of any of described collateral violates the rights of the Secured Party. Any receipts of proceeds of the collateral by a subordinate secured party violated the rights of the Secured Party.",
      "company_id": "VMFUMBRGWGXCBNBEVKM5QU",
      "company_name": "ELEMENTS HAIR STUDIO LLC",
      "continuation_count": 0,
      "date_expired": "2026-04-26 14:22:00.000000",
      "date_expired_unix": 1777213320000,
      "date_filed": "2021-04-26 14:22:00.000000",
      "date_filed_unix": 1619446920000,
      "eight_digit_sic_code": "72310100",
      "eight_digit_sic_description": "Cosmetology and personal hygiene salons",
      "four_digit_sic_code": "7231",
      "four_digit_sic_description": "Beauty shops",
      "has_amendments": false,
      "has_collateral": true,
      "has_continuation": false,
      "industry": "Design Services",
      "modified_date": 1760044766633,
      "naics_code": "812113",
      "naics_description": "Nail Salons",
      "phones": [
        "8594265222"
      ],
      "record_id": "R8dJWrGz678BX58u95nytK",
      "secured_party": "U.S. BANK NATIONAL ASSOCIATION",
      "secured_party_address": "PO Box 3427",
      "secured_party_address_raw": "PO BOX 3427 OSHKOSH WI 54903",
      "secured_party_base_url": "usbank.com",
      "secured_party_city": "Oshkosh",
      "secured_party_class": "Bank",
      "secured_party_eight_digit_sic_code": "65319903",
      "secured_party_eight_digit_sic_description": "Fiduciary, real estate",
      "secured_party_four_digit_sic_code": "6531",
      "secured_party_four_digit_sic_description": "Real estate agents and managers",
      "secured_party_industry": "Banking",
      "secured_party_naics_code": "531390",
      "secured_party_naics_description": "Other Activities Related to Real Estate",
      "secured_party_processed": false,
      "secured_party_state": "WI",
      "secured_party_two_digit_sic_code": "65",
      "secured_party_two_digit_sic_description": "Real Estate",
      "secured_party_zip_code": "54903",
      "state": "KY",
      "state_db": "KY",
      "two_digit_sic_code": "72",
      "two_digit_sic_description": "Personal Services",
      "ucc_id": "2021-3143984-07-KY",
      "ucc_number": "2021-3143984-07",
      "ucc_type": "UCC1",
      "ucc_url_pdf": "https://api.leadx.io/v1/presign/ky/VMFUMBRGWGXCBNBEVKM5QU_2021-3143984-07-KY_2021-3143984-07.pdf",
      "zip_code": "41017"
    }
  ],
  "page_number": 1,
  "per_page": 250,
  "total_pages": 1859,
  "total_records": 464570
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
zip_code

Debtor ZIP code(s) for exact ZIP filtering. When radius is supplied without near_zip_code, a single zip_code is used as the radius anchor.

Example:
["90210", "10001"]
​
near_zip_code

Anchor ZIP code for radius search against debtor address coordinates.

Example:

"90210"

​
radius
number | null

Radius distance for geo search around near_zip_code.

Required range: x > 0
Example:

25

​
radius_unit
enum<string>
default:mi

Units for radius.

Available options:
mi,
km
Example:

"mi"

​
sort_by

Optional result sort. Supported fields: date_filed_unix, date_expired_unix, company_name, and secured_party. Add :asc or :desc, for example date_filed_unix:desc.

Example:

"date_filed_unix:desc"

​
sort_order
enum<string> | null

Default sort order when sort_by does not include :asc or :desc.

Available options:
asc,
desc
Example:

"desc"

​
saved_search_list_id
string | null

Previously saved debtor search list id.

Example:

"abc123-client"

​
saved_search_field
enum<string> | null

Search field to use from the saved debtor search list.

Available options:
name,
url,
phone,
address,
industry,
naics_code,
naics_description,
eight_digit_sic_code,
eight_digit_sic_description,
four_digit_sic_code,
four_digit_sic_description,
two_digit_sic_code,
two_digit_sic_description
Example:

"company_name"

​
url

Debtor URL(s)

Example:

"https://www.equipmentshare.com"

​
company_id

Debtor company_id value(s)

Example:
[
  "NHGFIAZYQ8FVARFFA9PCRD",
  "VMFUMBRGWGXCBNBEVKM5QU"
]
​
secured_party_company_id

Secured-party company_id value(s)

Example:
[
  "NHGFIAZYQ8FVARFFA9PCRD",
  "VMFUMBRGWGXCBNBEVKM5QU"
]
​
debtor_type

Debtor type(s). Allowed values: Individual, Organization. When omitted, both are included.

Example:
["Individual", "Organization"]
​
phone

Company phone number(s)

Example:
["123-456-7890", 987654321]
​
company_name

Debtor company name(s)

Example:
[
  "Example Company",
  "John West Auto Body Shop"
]
​
secured_party_name

Secured-party company name(s) to combine with debtor filters

Example:
["John Deere", "Wells Fargo"]
​
address

Full street address(es) or any part of them

Example:
[
  "123 Main St, Austin, TX 78701",
  "456 Oak Ave, Crescent Springs, KY"
]
​
city

Debtor city name(s)

Example:
["Austin", "Crescent Springs"]
​
state

Secured-party state(s) (2-letter abbreviation)

Example:
["ND", "MN"]
​
state_filing

State where UCC was filed (2-letter abbreviation). Alias: state_db.

Example:
["ND", "MN"]
​
collateral

Collateral description(s)

Example:
["furniture", "equipment"]
​
collateral_match_mode
enum<string>
default:or

How multiple collateral terms are combined. 'or' matches any provided term (default). 'and' requires all provided terms.

Available options:
or,
and
Example:

"or"

​
assets

Assets description(s)

Example:
["inventory", "accounts receivable"]
​
has_collateral
boolean | null

Filter for UCCs that include collateral

Example:

true

​
has_assets
boolean | null

Filter for UCCs that include assets

Example:

true

​
has_continuation
boolean | null

Filter for UCCs that include continuation filings

Example:

true

​
has_amendment
boolean | null

Filter for UCCs that include amendments

Example:

true

​
has_website
boolean | null

Filter for UCCs that include websites

Example:

true

​
has_contacts
boolean | null

Filter for UCCs that include matched contacts

Example:

true

​
page
integer
default:1

Page number of results to return. Must be greater than or equal to 1.

Required range: x >= 1
Example:

1

​
per_page
integer
default:30

Number of results per page. Maximum is 50.

Required range: x <= 50
Example:

50

​
naics_code

NAICS code(s)

Example:
["523110", 541330]
​
naics_description

NAICS description(s)

Example:
[
  "Investment Banking and Securities Dealing",
  "Commercial Banking"
]
​
eight_digit_sic_code

8-digit SIC Code(s)

Example:
["61410103", 12345678]
​
eight_digit_sic_description

8-digit SIC Code Description(s)

Example:
[
  "Financing: automobiles, furniture, etc., not a deposit bank",
  "Other description"
]
​
four_digit_sic_code

4-digit SIC Code(s)

Example:
["6141", 1234]
​
four_digit_sic_description

4-digit SIC Code Description(s)

Example:
[
  "Personal credit institutions",
  "Commercial banking"
]
​
two_digit_sic_code

2-digit SIC Code(s)

Example:
["61", 62]
​
two_digit_sic_description

2-digit SIC Code Description(s)

Example:
[
  "Nondepository Credit Institutions",
  "Commercial Banking"
]
​
industry

Industry/industries

Example:
["Banking", "Financial Services"]
​
secured_party_industry

Secured-party industry/industries

Example:
["Banking", "Financial Services"]
​
filing_number

Filing number(s). Alias: ucc_number.

Example:
["12345678", "2005-2120595-61"]
​
one_filing_per_debtor
boolean | null

Return only one filing per debtor

Example:

true

​
company_filing_count

Company filing count filter. Accepts number, [min,max], or {'min':x,'max':y}.

Example:

3

​
modified_date
string | null

Date when record was last modified. Supports absolute formats (e.g., YYYY-MM-DD, MM-DD-YYYY, YYYY/MM/DD, MM/DD/YYYY) or relative durations (e.g., 1 day(s), 2 week(s), 3 month(s), 4 year(s)).

Example:

"2023-01-31"

​
exclude
Exclude · object | null

Exclude specific values from the search results. Allowed fields: url, phone.

Example:
{
  "phone": ["9876543210"],
  "url": ["https://exclude.com"]
}
​
date_filed
string | null

Date when the filing was made. Supports absolute formats (e.g., YYYY-MM-DD, MM-DD-YYYY, YYYY/MM/DD, MM/DD/YYYY) or relative durations (e.g., 1 day(s), 2 week(s), 3 month(s), 4 year(s)).

Example:

"2023-01-31"

​
date_expired
string | null

Date when the filing will expire. Supports absolute formats (e.g., YYYY-MM-DD, MM-DD-YYYY, YYYY/MM/DD, MM/DD/YYYY) or relative durations (e.g., 1 day(s), 2 week(s), 3 month(s), 4 year(s)). For relative dates, direction can be specified with 'forwards' or 'backwards' (e.g., '1 year forwards'); default is backwards.

Example:

"2024-01-31"

​
annual_revenue

Annual revenue range (USD). Accepts number, [min,max], or {'min':x,'max':y}.

Example:

5000000

​
number_employees

Employee count range. Accepts number, [min,max], or {'min':x,'max':y}.

Example:

50

​
time_in_business

Time in business range (years). Accepts number, [min,max], or {'min':x,'max':y}.

Example:

3

Response

Successful Response

Last modified on March 23, 2026