Screen a business for credit risk

Use LeadX data to assemble evidence for a business review. Keep the source records and their timestamps so an analyst can understand how the profile was constructed.

LeadX data is an input to your review. It is not a legal opinion, lien-priority determination, credit decision, or substitute for official filing records and your compliance process.

Choose an approach

Call /v1/all-attributes when you want a broad company profile in one response.

curl --fail-with-body "https://api.leadx.com/v1/all-attributes" \
  -H "X-API-KEY: $LEADX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "acmeplumbing.com",
    "exclude": ["contacts"]
  }'

Modular review workflow

Resolve the business

Start with a stable domain, phone number, or LeadX company ID. Return fields that help confirm the legal and operating identity.

curl --fail-with-body "https://api.leadx.com/v1/companies" \
  -H "X-API-KEY: $LEADX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "acmeplumbing.com",
    "include_fields": [
      "company_id",
      "company_name",
      "url",
      "address_full",
      "industry",
      "naics_code",
      "estimated_number_employees",
      "time_in_business"
    ]
  }'

Review UCC financing statements

Retrieve active UCC filings for the resolved company and sort newest first.

curl --fail-with-body "https://api.leadx.com/v1/ucc/debtor" \
  -H "X-API-KEY: $LEADX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "acmeplumbing.com",
    "is_active_filing": true,
    "sort_by": "date_filed_unix:desc",
    "page": 1,
    "per_page": 50
  }'

Review the secured party, filing jurisdiction, dates, status, amendments, and collateral description. A filing does not by itself establish current obligation amount or lien priority.

Search tax liens separately

State and federal tax liens use the tax-liens endpoint rather than the UCC endpoints.

curl --fail-with-body "https://api.leadx.com/v1/tax-liens" \
  -H "X-API-KEY: $LEADX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "acmeplumbing.com",
    "jurisdiction_level": ["state", "federal"],
    "is_active_filing": true,
    "page": 1,
    "per_page": 50
  }'

Add business-source context

Use BBB, D&B, and Google Reviews only when the corresponding source and entitlement are relevant to your policy. Preserve each source separately instead of collapsing all evidence into one undocumented score.

Suggested review record

Store a normalized summary alongside the raw API responses:

{
  "company_id": "EXAMPLECOMPANYID123",
  "reviewed_at": "2026-08-11T22:30:00Z",
  "identity_match": "confirmed",
  "active_ucc_filings": 3,
  "active_tax_liens": 0,
  "latest_ucc_filed_at": "2026-06-18T00:00:00Z",
  "sources_checked": ["companies", "ucc", "tax_liens", "bbb", "dnb"],
  "analyst_notes": "Manual review required"
}

The values above are illustrative. Derive counts from the complete paginated results and record the time of your review.

Continue to Search UCC filings by debtor for collateral, status, geography, lifecycle, and prospecting examples.