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 ' { "sort_by": "date_filed_unix:desc", "sort_order": "desc", "saved_search_list_id": "abc123-client", "saved_search_field": "name", "url": "https://www.starionbank.com", "company_id": [ "NHGFIAZYQ8FVARFFA9PCRD", "VMFUMBRGWGXCBNBEVKM5QU" ], "secured_party_company_id": [ "NHGFIAZYQ8FVARFFA9PCRD", "VMFUMBRGWGXCBNBEVKM5QU" ], "debtor_type": [ "Individual", "Organization" ], "name": [ "Starion Bank", "Wells Fargo" ], "debtor_name": [ "Construction", "ABC Builders" ], "address": "123 Bank St, Fargo, ND 58102", "city": [ "Philadelphia", "Fargo" ], "state": [ "ND", "MN" ], "state_filing": "ND", "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

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:

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

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

string | null

Secured-party address

Example:

"123 Bank St, Fargo, ND 58102"

city

Secured-party city name(s)

Example:

["Philadelphia", "Fargo"]

state

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

Example:

["ND", "MN"]

state_filing

string | null

State where UCC was filed (2-letter abbreviation)

Example:

"ND"

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

Getting Started

Endpoints

Field References

Guides

Authorizations

Body

Response

Getting Started

Endpoints

Field References

Guides

Documentation Index

Authorizations

Body

Response