> ## Documentation Index > Fetch the complete documentation index at: https://docs.leadx.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml post /v1/ucc/secured_party openapi: 3.1.0 info: title: LeadX API version: 0.1.0 servers: [] security: [] tags: - name: All Attributes description: Aggregate and correlate data about companies and their associated records. - name: Better Business Bureau description: >- Retrieve Better Business Bureau (BBB) ratings and accreditation status for businesses. - name: Companies description: Enrich company data by URL, name, address, or phone. - name: Contacts description: Enrich data about contacts. - name: email description: Validate company email addresses. - name: Google Reviews description: Retrieve Google Reviews and ratings for businesses. - name: Mobile Number description: Enrich mobile phone numbers. - name: UCC description: Search across to the U.S. Uniform Commercial Code (UCC) lien filings. paths: /v1/ucc/secured_party: post: tags: - UCC Secured Party summary: Fetch secured-party UCC records description: >- 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. operationId: secured_party_post_api_v1_ucc_secured_party_post requestBody: content: application/json: schema: $ref: '#/components/schemas/SecuredPartyRequest' required: true responses: '200': description: Successful Response content: application/json: schema: {} example: 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 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] - HTTPBearer: [] components: schemas: SecuredPartyRequest: properties: zip_code: anyOf: - type: string - items: type: string type: array - type: 'null' title: Zip Code description: >- 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. examples: - - '90210' - '10001' - '90210' near_zip_code: anyOf: - type: string - items: type: string type: array - type: 'null' title: Near Zip Code description: >- Anchor ZIP code for radius search against debtor address coordinates. example: '90210' radius: anyOf: - type: number exclusiveMinimum: 0 - type: 'null' title: Radius description: Radius distance for geo search around `near_zip_code`. example: 25 radius_unit: type: string enum: - mi - km title: Radius Unit description: Units for `radius`. default: mi example: mi sort_by: anyOf: - type: string - items: anyOf: - type: string - additionalProperties: true type: object type: array - additionalProperties: true type: object - type: 'null' title: Sort By description: >- 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`. examples: - date_filed_unix:desc - field: company_name order: asc sort_order: anyOf: - type: string enum: - asc - desc - type: 'null' title: Sort Order description: >- Default sort order when `sort_by` does not include `:asc` or `:desc`. example: desc saved_search_list_id: anyOf: - type: string - type: 'null' title: Saved Search List Id description: Previously saved secured-party search list id. example: abc123-client saved_search_field: anyOf: - type: string enum: - 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 - type: 'null' title: Saved Search Field description: Search field to use from the saved secured-party search list. example: secured_party_name url: anyOf: - type: string - items: type: string type: array - type: 'null' title: Url description: Secured-party URL(s) example: https://www.starionbank.com company_id: anyOf: - type: string - items: type: string type: array - type: 'null' title: Company Id description: Debtor company_id value(s) examples: - - NHGFIAZYQ8FVARFFA9PCRD - VMFUMBRGWGXCBNBEVKM5QU - NHGFIAZYQ8FVARFFA9PCRD secured_party_company_id: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Company Id description: Secured-party company_id value(s) examples: - - NHGFIAZYQ8FVARFFA9PCRD - VMFUMBRGWGXCBNBEVKM5QU - NHGFIAZYQ8FVARFFA9PCRD debtor_type: anyOf: - type: string - items: type: string type: array - type: 'null' title: Debtor Type description: >- Debtor type(s). Allowed values: `Individual`, `Organization`. When omitted, both are included. examples: - - Individual - Organization - Individual - Organization secured_party_name: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Name description: Secured-party company name(s) examples: - - Starion Bank - Wells Fargo - Starion Bank debtor_name: anyOf: - type: string - items: type: string type: array - type: 'null' title: Debtor Name description: Debtor company name(s) to combine with secured-party filters examples: - - Construction - ABC Builders - Construction address: anyOf: - type: string - items: type: string type: array - type: 'null' title: Address description: Secured-party address(es) examples: - - 123 Bank St, Fargo, ND 58102 - 456 Main St, Philadelphia, PA 19103 - 123 Bank St, Fargo, ND 58102 city: anyOf: - type: string - items: type: string type: array - type: 'null' title: City description: Secured-party city name(s) examples: - - Philadelphia - Fargo - Philadelphia state: anyOf: - type: string - items: type: string type: array - type: 'null' title: State description: Secured-party state(s) (2-letter abbreviation) examples: - - ND - MN - ND state_filing: anyOf: - type: string - items: type: string type: array - type: 'null' title: State Filing description: 'State where UCC was filed (2-letter abbreviation). Alias: state_db.' examples: - - ND - MN - ND secured_party_class: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Class description: Secured-party class(es) examples: - - Equipment - Bank - Masked collateral: anyOf: - type: string - items: type: string type: array - type: 'null' title: Collateral description: Collateral description(s) examples: - - furniture - equipment - furniture collateral_match_mode: type: string enum: - or - and title: Collateral Match Mode description: >- How multiple collateral terms are combined. 'or' matches any provided term (default). 'and' requires all provided terms. default: or example: or assets: anyOf: - type: string - items: type: string type: array - type: 'null' title: Assets description: Assets description(s) examples: - - inventory - accounts receivable - inventory has_collateral: anyOf: - type: boolean - type: 'null' title: Has Collateral description: Only UCCs with collateral example: true has_assets: anyOf: - type: boolean - type: 'null' title: Has Assets description: Only UCCs with assets example: true has_continuation: anyOf: - type: boolean - type: 'null' title: Has Continuation description: Only UCCs with continuation example: true has_amendment: anyOf: - type: boolean - type: 'null' title: Has Amendment description: Only UCCs with amendments example: true has_website: anyOf: - type: boolean - type: 'null' title: Has Website description: Only UCCs with websites example: true has_contacts: anyOf: - type: boolean - type: 'null' title: Has Contacts description: Only UCCs with matched contacts example: true filing_number: anyOf: - type: string - type: integer - items: anyOf: - type: string - type: integer type: array - type: 'null' title: Filing Number description: Filing number(s) examples: - - 2005-2120595-61 - 20244455771A - 2005-2120595-61 company_filing_count: anyOf: - type: integer - type: number - type: string - items: anyOf: - type: integer - type: number - type: string type: array - prefixItems: - anyOf: - type: integer - type: number - type: string - anyOf: - type: integer - type: number - type: string type: array maxItems: 2 minItems: 2 - additionalProperties: anyOf: - type: integer - type: number - type: string - type: 'null' type: object - type: 'null' title: Company Filing Count description: >- Company filing count filter. Accepts number, [min,max], or {'min':x,'max':y}. examples: - 3 - - 2 - 10 - max: 10 min: 2 secured_party_naics_code: anyOf: - type: string - type: integer - items: anyOf: - type: string - type: integer type: array - type: 'null' title: Secured Party Naics Code description: NAICS code(s) examples: - - '523110' - 541330 - '523110' - 523110 secured_party_naics_description: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Naics Description description: NAICS description(s) examples: - - Investment Banking and Securities Dealing - Commercial Banking - Investment Banking and Securities Dealing secured_party_eight_digit_sic_code: anyOf: - type: string - type: integer - items: anyOf: - type: string - type: integer type: array - type: 'null' title: Secured Party Eight Digit Sic Code description: Secured Party 8-digit SIC Code(s) examples: - - '61410103' - 12345678 - '61410103' - 61410103 secured_party_eight_digit_sic_description: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Eight Digit Sic Description description: Secured Party 8-digit SIC Code Description(s) examples: - - 'Financing: automobiles, furniture, etc., not a deposit bank' - Other description - 'Financing: automobiles, furniture, etc., not a deposit bank' secured_party_four_digit_sic_code: anyOf: - type: string - type: integer - items: anyOf: - type: string - type: integer type: array - type: 'null' title: Secured Party Four Digit Sic Code description: Secured Party 4-digit SIC Code(s) examples: - - '6141' - 1234 - '6141' - 6141 secured_party_four_digit_sic_description: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Four Digit Sic Description description: Secured Party 4-digit SIC Code Description(s) examples: - - Personal credit institutions - Commercial banking - Personal credit institutions secured_party_two_digit_sic_code: anyOf: - type: string - type: integer - items: anyOf: - type: string - type: integer type: array - type: 'null' title: Secured Party Two Digit Sic Code description: Secured Party 2-digit SIC Code(s) examples: - - '61' - 62 - '61' - 61 secured_party_two_digit_sic_description: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Two Digit Sic Description description: Secured Party 2-digit SIC Code Description(s) examples: - - Nondepository Credit Institutions - Commercial Banking - Nondepository Credit Institutions secured_party_industry: anyOf: - type: string - items: type: string type: array - type: 'null' title: Secured Party Industry description: Secured Party industry/industries examples: - - Banking - Financial Services - Banking industry: anyOf: - type: string - items: type: string type: array - type: 'null' title: Industry description: Debtor company industry/industries examples: - - Banking - Financial Services - Banking one_filing_per_debtor: anyOf: - type: boolean - type: 'null' title: One Filing Per Debtor description: Return only one filing per debtor example: true modified_date: anyOf: - type: string - type: 'null' title: Modified Date description: >- 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: anyOf: - type: string - type: 'null' title: Date Filed description: >- 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: anyOf: - type: string - type: 'null' title: Date Expired description: >- 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: type: integer minimum: 1 title: Page description: >- Page number of results to return. Must be greater than or equal to 1. default: 1 example: 1 per_page: type: integer maximum: 50 title: Per Page description: Number of results per page. Maximum is 50. default: 30 example: 50 annual_revenue: anyOf: - type: integer - type: number - type: string - items: anyOf: - type: integer - type: number - type: string type: array - prefixItems: - anyOf: - type: integer - type: number - type: string - anyOf: - type: integer - type: number - type: string type: array maxItems: 2 minItems: 2 - additionalProperties: anyOf: - type: integer - type: number - type: string - type: 'null' type: object - type: 'null' title: Annual Revenue description: >- Annual revenue range (USD). Accepts number, [min,max], or {'min':x,'max':y}. examples: - 5000000 - - 5000000 - 20000000 - max: 20000000 min: 5000000 number_employees: anyOf: - type: integer - type: number - type: string - items: anyOf: - type: integer - type: number - type: string type: array - prefixItems: - anyOf: - type: integer - type: number - type: string - anyOf: - type: integer - type: number - type: string type: array maxItems: 2 minItems: 2 - additionalProperties: anyOf: - type: integer - type: number - type: string - type: 'null' type: object - type: 'null' title: Number Employees description: >- Employee count range. Accepts number, [min,max], or {'min':x,'max':y}. examples: - 50 - - 10 - 250 - max: 250 min: 10 time_in_business: anyOf: - type: integer - type: number - type: string - items: anyOf: - type: integer - type: number - type: string type: array - prefixItems: - anyOf: - type: integer - type: number - type: string - anyOf: - type: integer - type: number - type: string type: array maxItems: 2 minItems: 2 - additionalProperties: anyOf: - type: integer - type: number - type: string - type: 'null' type: object - type: 'null' title: Time In Business description: >- Time in business range (years). Accepts number, [min,max], or {'min':x,'max':y}. examples: - 3 - - 1 - 10 - max: 10 min: 1 additionalProperties: false type: object title: SecuredPartyRequest HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key HTTPBearer: type: http scheme: bearer ````