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 ' { "url": "https://www.equipmentshare.com", "company_id": [ "NHGFIAZYQ8FVARFFA9PCRD", "VMFUMBRGWGXCBNBEVKM5QU" ], "secured_party_company_id": [ "NHGFIAZYQ8FVARFFA9PCRD", "VMFUMBRGWGXCBNBEVKM5QU" ], "debtor_type": [ "Individual", "Organization" ], "phone": [ "123-456-7890", 987654321 ], "name": [ "Example Company", "John West Auto Body Shop" ], "secured_party_name": [ "John Deere", "Wells Fargo" ], "address": "123 Main St, Austin, TX 78701", "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, "sort_by": "date_filed_unix:desc", "sort_order": "desc", "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_company_id": "7KXRMB4DWQPCSXZNT9HJYF", "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": 50, "total_pages": 1859, "total_records": 464570 }

Authorizations

X-API-Key

string

header

required

Body

application/json

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]

name

Debtor company name(s). Accepts a single string or a list of strings. Comma-separated strings are split automatically.

Example:

[
  "Example Company",
  "John West Auto Body Shop"
]

secured_party_name

Secured-party company name(s) to combine with debtor filters. Use this to cross-filter debtor results by the secured party's name.

Example:

["John Deere", "Wells Fargo"]

address

string | null

Full street address or any part of it

Example:

"123 Main St, Austin, TX 78701"

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)

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:50

Number of results per page. Maximum is 50.

Required range: x <= 50

Example:

50

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"

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)

Example:

["12345678", "2005-2120595-61"]

one_filing_per_debtor

boolean | null

deprecated

Deprecated. This parameter is no longer supported and will be ignored. Results are now always grouped by 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

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

Show child attributes

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

Getting Started

Endpoints

Field References

Guides

Authorizations

Body

Response

Getting Started

Endpoints

Field References

Guides

Documentation Index

Authorizations

Body

Response