Fetch secured-party UCC records

curl --request POST \
  --url https://api.example.com/v1/ucc/secured_party \
  --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": "secured_party_name",
  "url": "https://www.starionbank.com",
  "company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "secured_party_company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "debtor_type": [
    "Individual",
    "Organization"
  ],
  "secured_party_name": [
    "Starion Bank",
    "Wells Fargo"
  ],
  "debtor_name": [
    "Construction",
    "ABC Builders"
  ],
  "address": [
    "123 Bank St, Fargo, ND 58102",
    "456 Main St, Philadelphia, PA 19103"
  ],
  "city": [
    "Philadelphia",
    "Fargo"
  ],
  "state": [
    "ND",
    "MN"
  ],
  "state_filing": [
    "ND",
    "MN"
  ],
  "secured_party_class": [
    "Equipment",
    "Bank"
  ],
  "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,
  "filing_number": [
    "2005-2120595-61",
    "20244455771A"
  ],
  "company_filing_count": 3,
  "secured_party_naics_code": [
    "523110",
    541330
  ],
  "secured_party_naics_description": [
    "Investment Banking and Securities Dealing",
    "Commercial Banking"
  ],
  "secured_party_eight_digit_sic_code": [
    "61410103",
    12345678
  ],
  "secured_party_eight_digit_sic_description": [
    "Financing: automobiles, furniture, etc., not a deposit bank",
    "Other description"
  ],
  "secured_party_four_digit_sic_code": [
    "6141",
    1234
  ],
  "secured_party_four_digit_sic_description": [
    "Personal credit institutions",
    "Commercial banking"
  ],
  "secured_party_two_digit_sic_code": [
    "61",
    62
  ],
  "secured_party_two_digit_sic_description": [
    "Nondepository Credit Institutions",
    "Commercial Banking"
  ],
  "secured_party_industry": [
    "Banking",
    "Financial Services"
  ],
  "industry": [
    "Banking",
    "Financial Services"
  ],
  "one_filing_per_debtor": true,
  "modified_date": "2023-01-31",
  "date_filed": "2023-01-31",
  "date_expired": "2024-01-31",
  "page": 1,
  "per_page": 50,
  "annual_revenue": 5000000,
  "number_employees": 50,
  "time_in_business": 3
}
'

{
  "success": true,
  "records": [
    {
      "address": "205 Airport Road",
      "address_raw": "205 Airport Road, West Point, MS 39773",
      "amendments": [],
      "base_url": "fab-supply.com",
      "city": "West Point",
      "company_id": "NHGFIAZYQ8FVARFFA9PCRD",
      "company_name": "FABRICATOR'S SUPPLY, LLC",
      "continuation_count": 0,
      "date_expired": "2029-11-07 00:00:00.000000",
      "date_expired_unix": 1888704000000,
      "date_filed": "2024-11-07 00:00:00.000000",
      "date_filed_unix": 1730937600000,
      "eight_digit_sic_code": "33150000",
      "eight_digit_sic_description": "Steel wire and related products",
      "four_digit_sic_code": "3315",
      "four_digit_sic_description": "Steel wire and related products",
      "has_amendments": false,
      "has_continuation": false,
      "industry": "Transportation, Logistics, Supply Chain and Storage",
      "modified_date": 1759945390119,
      "naics_code": "423510",
      "naics_description": "Metal Service Centers and Other Metal Merchant Wholesalers",
      "phones": [
        "6624920550"
      ],
      "record_id": "hAUqYUrJG6LTfyvCRQd6EV",
      "secured_party": "LEAF Capital Funding, LLC and/or Its Assigns",
      "secured_party_address": "2005 Market Street",
      "secured_party_address_raw": "2005 Market Street, Philadelphia, PA 19103",
      "secured_party_base_url": "leafnow.com",
      "secured_party_city": "Philadelphia",
      "secured_party_class": "Equipment",
      "secured_party_eight_digit_sic_code": "61410103",
      "secured_party_eight_digit_sic_description": "Financing: automobiles, furniture, etc., not a deposit bank",
      "secured_party_four_digit_sic_code": "6141",
      "secured_party_four_digit_sic_description": "Personal credit institutions",
      "secured_party_industry": "Banking",
      "secured_party_naics_code": "522220",
      "secured_party_naics_description": "Sales Financing",
      "secured_party_state": "PA",
      "secured_party_two_digit_sic_code": "61",
      "secured_party_two_digit_sic_description": "Nondepository Credit Institutions",
      "secured_party_zip_code": "19103",
      "state": "MS",
      "state_db": "MS",
      "two_digit_sic_code": "33",
      "two_digit_sic_description": "Primary Metal Industries",
      "ucc_id": "20244455771A-MS",
      "ucc_number": "20244455771A",
      "ucc_type": "UCC1",
      "zip_code": "39773"
    }
  ],
  "page_number": 1,
  "per_page": 250,
  "total_pages": 42,
  "total_records": 10345
}

UCC

Fetch secured-party UCC records

Search liens by secured-party (i.e., lender/creditor) attributes, such as URL, secured_party_name, address, secured-party class, and collateral/assets description. Supports filtering by presence of collateral, assets, continuation, amendments, and website, as well as modification date.

You must provide at least one of the following filter parameters:

url
company_id
secured_party_company_id
debtor_type (Individual or Organization; omitted defaults to both)
secured_party_name
debtor_name
address
city
zip_code
near_zip_code with radius (radius_unit defaults to mi)
secured_party_class
collateral
collateral_match_mode (or default; set to and for all collateral terms; alias: collateral_contains_operator)
assets
has_collateral
has_assets
has_continuation
has_amendment
has_website
has_contacts
modified_date
date_filed
date_expired
company_filing_count
industry
secured_party_naics_code
secured_party_naics_description
secured_party_eight_digit_sic_code
secured_party_eight_digit_sic_description
secured_party_four_digit_sic_code
secured_party_four_digit_sic_description
secured_party_two_digit_sic_code
secured_party_two_digit_sic_description
secured_party_industry

Sorting is available with sort_by and optional sort_order. Supported sort fields are date_filed_unix, date_expired_unix, company_name, and secured_party. For example: sort_by: secured_party:asc.

For relative date filters, date_expired supports forwards and backwards direction keywords (default is backwards), e.g. <= 1 year forwards.

If you provide multiple filters, only records that match all of them will be returned. The response includes paginated UCC lien records that match the provided criteria.

Pagination uses cursorless offset paging with page and per_page (1-250). Responses include page_number, per_page, total_pages, and total_records, so you can iterate through results.

The response includes a records array of matching liens, each with detailed fields. The total_records field specifies the number of matches returned. See the Field References section of the documentation for a breakdown of each field returned in the response.

POST

ucc

secured_party

Fetch secured-party UCC records

curl --request POST \
  --url https://api.example.com/v1/ucc/secured_party \
  --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": "secured_party_name",
  "url": "https://www.starionbank.com",
  "company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "secured_party_company_id": [
    "NHGFIAZYQ8FVARFFA9PCRD",
    "VMFUMBRGWGXCBNBEVKM5QU"
  ],
  "debtor_type": [
    "Individual",
    "Organization"
  ],
  "secured_party_name": [
    "Starion Bank",
    "Wells Fargo"
  ],
  "debtor_name": [
    "Construction",
    "ABC Builders"
  ],
  "address": [
    "123 Bank St, Fargo, ND 58102",
    "456 Main St, Philadelphia, PA 19103"
  ],
  "city": [
    "Philadelphia",
    "Fargo"
  ],
  "state": [
    "ND",
    "MN"
  ],
  "state_filing": [
    "ND",
    "MN"
  ],
  "secured_party_class": [
    "Equipment",
    "Bank"
  ],
  "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,
  "filing_number": [
    "2005-2120595-61",
    "20244455771A"
  ],
  "company_filing_count": 3,
  "secured_party_naics_code": [
    "523110",
    541330
  ],
  "secured_party_naics_description": [
    "Investment Banking and Securities Dealing",
    "Commercial Banking"
  ],
  "secured_party_eight_digit_sic_code": [
    "61410103",
    12345678
  ],
  "secured_party_eight_digit_sic_description": [
    "Financing: automobiles, furniture, etc., not a deposit bank",
    "Other description"
  ],
  "secured_party_four_digit_sic_code": [
    "6141",
    1234
  ],
  "secured_party_four_digit_sic_description": [
    "Personal credit institutions",
    "Commercial banking"
  ],
  "secured_party_two_digit_sic_code": [
    "61",
    62
  ],
  "secured_party_two_digit_sic_description": [
    "Nondepository Credit Institutions",
    "Commercial Banking"
  ],
  "secured_party_industry": [
    "Banking",
    "Financial Services"
  ],
  "industry": [
    "Banking",
    "Financial Services"
  ],
  "one_filing_per_debtor": true,
  "modified_date": "2023-01-31",
  "date_filed": "2023-01-31",
  "date_expired": "2024-01-31",
  "page": 1,
  "per_page": 50,
  "annual_revenue": 5000000,
  "number_employees": 50,
  "time_in_business": 3
}
'

{
  "success": true,
  "records": [
    {
      "address": "205 Airport Road",
      "address_raw": "205 Airport Road, West Point, MS 39773",
      "amendments": [],
      "base_url": "fab-supply.com",
      "city": "West Point",
      "company_id": "NHGFIAZYQ8FVARFFA9PCRD",
      "company_name": "FABRICATOR'S SUPPLY, LLC",
      "continuation_count": 0,
      "date_expired": "2029-11-07 00:00:00.000000",
      "date_expired_unix": 1888704000000,
      "date_filed": "2024-11-07 00:00:00.000000",
      "date_filed_unix": 1730937600000,
      "eight_digit_sic_code": "33150000",
      "eight_digit_sic_description": "Steel wire and related products",
      "four_digit_sic_code": "3315",
      "four_digit_sic_description": "Steel wire and related products",
      "has_amendments": false,
      "has_continuation": false,
      "industry": "Transportation, Logistics, Supply Chain and Storage",
      "modified_date": 1759945390119,
      "naics_code": "423510",
      "naics_description": "Metal Service Centers and Other Metal Merchant Wholesalers",
      "phones": [
        "6624920550"
      ],
      "record_id": "hAUqYUrJG6LTfyvCRQd6EV",
      "secured_party": "LEAF Capital Funding, LLC and/or Its Assigns",
      "secured_party_address": "2005 Market Street",
      "secured_party_address_raw": "2005 Market Street, Philadelphia, PA 19103",
      "secured_party_base_url": "leafnow.com",
      "secured_party_city": "Philadelphia",
      "secured_party_class": "Equipment",
      "secured_party_eight_digit_sic_code": "61410103",
      "secured_party_eight_digit_sic_description": "Financing: automobiles, furniture, etc., not a deposit bank",
      "secured_party_four_digit_sic_code": "6141",
      "secured_party_four_digit_sic_description": "Personal credit institutions",
      "secured_party_industry": "Banking",
      "secured_party_naics_code": "522220",
      "secured_party_naics_description": "Sales Financing",
      "secured_party_state": "PA",
      "secured_party_two_digit_sic_code": "61",
      "secured_party_two_digit_sic_description": "Nondepository Credit Institutions",
      "secured_party_zip_code": "19103",
      "state": "MS",
      "state_db": "MS",
      "two_digit_sic_code": "33",
      "two_digit_sic_description": "Primary Metal Industries",
      "ucc_id": "20244455771A-MS",
      "ucc_number": "20244455771A",
      "ucc_type": "UCC1",
      "zip_code": "39773"
    }
  ],
  "page_number": 1,
  "per_page": 250,
  "total_pages": 42,
  "total_records": 10345
}

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 secured-party search list id.

Example:

"abc123-client"

saved_search_field

enum<string> | null

Search field to use from the saved secured-party search list.

Available options:

name,

url,

address,

secured_party_industry,

secured_party_naics_code,

secured_party_naics_description,

secured_party_eight_digit_sic_code,

secured_party_eight_digit_sic_description,

secured_party_four_digit_sic_code,

secured_party_four_digit_sic_description,

secured_party_two_digit_sic_code,

secured_party_two_digit_sic_description

Example:

"secured_party_name"

url

Secured-party URL(s)

Example:

"https://www.starionbank.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"]

secured_party_name

Secured-party company name(s)

Example:

["Starion Bank", "Wells Fargo"]

debtor_name

Debtor company name(s) to combine with secured-party filters

Example:

["Construction", "ABC Builders"]

address

Secured-party address(es)

Example:

[
  "123 Bank St, Fargo, ND 58102",
  "456 Main St, Philadelphia, PA 19103"
]

city

Secured-party city name(s)

Example:

["Philadelphia", "Fargo"]

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"]

secured_party_class

Secured-party class(es)

Example:

["Equipment", "Bank"]

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

Only UCCs with collateral

Example:

true

has_assets

boolean | null

Only UCCs with assets

Example:

true

has_continuation

boolean | null

Only UCCs with continuation

Example:

true

has_amendment

boolean | null

Only UCCs with amendments

Example:

true

has_website

boolean | null

Only UCCs with websites

Example:

true

has_contacts

boolean | null

Only UCCs with matched contacts

Example:

true

filing_number

Filing number(s)

Example:

["2005-2120595-61", "20244455771A"]

company_filing_count

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

Example:

3

secured_party_naics_code

NAICS code(s)

Example:

["523110", 541330]

secured_party_naics_description

NAICS description(s)

Example:

[
  "Investment Banking and Securities Dealing",
  "Commercial Banking"
]

secured_party_eight_digit_sic_code

Secured Party 8-digit SIC Code(s)

Example:

["61410103", 12345678]

secured_party_eight_digit_sic_description

Secured Party 8-digit SIC Code Description(s)

Example:

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

secured_party_four_digit_sic_code

Secured Party 4-digit SIC Code(s)

Example:

["6141", 1234]

secured_party_four_digit_sic_description

Secured Party 4-digit SIC Code Description(s)

Example:

[
  "Personal credit institutions",
  "Commercial banking"
]

secured_party_two_digit_sic_code

Secured Party 2-digit SIC Code(s)

Example:

["61", 62]

secured_party_two_digit_sic_description

Secured Party 2-digit SIC Code Description(s)

Example:

[
  "Nondepository Credit Institutions",
  "Commercial Banking"
]

secured_party_industry

Secured Party industry/industries

Example:

["Banking", "Financial Services"]

industry

Debtor company industry/industries

Example:

["Banking", "Financial Services"]

one_filing_per_debtor

boolean | null

Return only one filing per debtor

Example:

true

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)). Relative direction can be specified with 'forwards' or 'backwards' (e.g., '1 year forwards'); default is backwards.

Example:

"2023-01-31"

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)). Relative direction can be specified with 'forwards' or 'backwards' (e.g., '1 year forwards'); default is backwards.

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"

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

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 April 3, 2026

Fetch debtor UCC records Fetch a UCC company by company_id

⌘I