Pricing

from $4.25 / 1,000 entity record resolveds

Try for free

Go to Apify Store

Secretary of State Business Entity Search + UCC Liens — KYB

Try for free

Secretary of State (SOS) registry search, 49 states + DC, Florida Sunbiz search. Company registration lookup: look up company registration, registered agent lookup, company officers lookup. Lists by agent/officer (14 states+DC). UCC liens (31 states), UCC search by debtor. KYB business verification

Pricing

from $4.25 / 1,000 entity record resolveds

Rating

0.0

(0)

Developer

Scott Helvick

Actor stats

Bookmarked

142

Total users

Monthly active users

9 minutes ago

Last modified

Categories

Business

Developer tools

Lead generation

Security

Calling this again

reuse

Optional

The parameters for repeating this kind of lookup: the Actor to call, this run's input with names and identifiers replaced by placeholders, where current prices are listed, and the states this search covers. Useful for keeping notes on which tool handles which task. Contains no results.

Type:object

Query

query

Required

The company name that produced this record.

Type:string

Example:

Tesla

Input index

input_index

Required

Zero-based position of the submitted company name in the deduplicated accepted order.

Type:integer

Minimum:0

Example:

Status

status

Required

Resolution status. 'completed' = an entity was found and normalized. 'no_match' = covered state(s) searched but no entity matched the name. 'not_covered' = a requested state is not yet supported. 'failed' = a covered state's registry could not be reached, or the run's Max cost per run was reached first (see error and error_class). 'acknowledged' = the request carried only a note; nothing was searched and no results were charged (see message).

Type:string

Example:

completed

Options:

completedfailednot_coveredno_matchacknowledged

Error class

error_class

Optional

Machine-routable failure class on non-completed records; null when status is 'completed'. RETRY LATER, unchanged: 'source_error' = the official registry could not be reached, a transient upstream outage; 'records_unavailable' = the requested records could not be reached on this run and this is not evidence the entity is absent; 'source_walled' = the registry refused an automated search; 'budget_exhausted' = the run deadline arrived before this company finished, or the run reached its Max cost per run before this company or some of its records could be delivered (nothing was delivered or charged for them; raise Max cost per run first, then re-run OUTPUT.retry_input); 'lien_join_error' = the entity was found but its lien filings could not be retrieved. DO NOT RETRY unchanged: 'malformed_input' = the submitted input could not be used and must be corrected; 'no_match' = the registry answered and no entity matched; 'not_covered' = the requested state is not yet supported; 'internal_error' = the search could not be completed. Branch on this field rather than on the prose in 'error'.

Type:string | null

Example:

source_error

Options:

source_errorrecords_unavailablesource_walledlien_join_errorinternal_errorbudget_exhaustedmalformed_inputno_matchnot_coverednull

Retry advice

retry

Optional

Machine-readable retry guidance for this record, derived from error_class. Null when the record is a result. 'never' = the source answered, or we do not cover this target: re-running the same input returns the same answer, do not re-run. 'with_changes' = the input for this record must change (see error for what): do not re-run unchanged. 'later' = a transient fault on the source or our side, or the run's budget/deadline ran out before this record: re-run the same input after a short delay.

Type:string | null

Example:

later

Options:

laterwith_changesnevernull

State

state

Required

Two-letter US state code the entity is registered in. On 'no_match' this lists the states searched; null when unresolved.

Type:string | null

Example:

Legal name

legal_name

Required

The entity's legal / registered name as published by the state. Null on non-completed records.

Type:string | null

Example:

Tesla Electric Company LLC

Entity ID

entity_id

Required

The state's registration / filing / account number for the entity. Null on non-completed records.

Type:string | null

Example:

20141524018

Same record as

same_record_as

Optional

Set when this record is the same registry record already returned for an earlier name in this run; it is returned again for this name at no additional charge. The value is that earlier query string; null otherwise.

Type:string | null

Example:

Publix Super Markets

Entity type

entity_type

Required

Legal form as classified by the state (e.g. LLC, business corporation, nonprofit). Verbatim from the source; codes vary by state. Null when not published.

Type:string | null

Example:

DLLC

Entity status

entity_status

Required

Registration status verbatim from the state (e.g. Good Standing, Active, Delinquent, Dissolved, Forfeited). Some registries publish only currently-active entities; see field_notes. Null when not published.

Type:string | null

Example:

Good Standing

Formation / registration date

formation_date

Required

Date the entity was formed or first registered in the state (ISO 8601 YYYY-MM-DD). Null when not published.

Type:string | null

Example:

2014-08-27

Jurisdiction of formation

jurisdiction

Required

The state/country where the entity was originally formed (may differ from the state of registration for foreign entities). Null when not published.

Type:string | null

Example:

Registered agent name

registered_agent_name

Required

The entity's registered agent for service of process, as published by the state (a person or a commercial agent company). Null when the state's dataset does not publish it.

Type:string | null

Example:

The Corporation Company

Registered agent address

registered_agent_address

Required

Mailing address of the registered agent. Null when not published.

Type:string | null

Example:

1700 Broadway, Denver, CO, 80290

Principal address

principal_address

Required

The entity's principal office / mailing address on file with the state. Null when not published.

Type:string | null

Example:

9750 Hilldale Dr, Morrison, CO, 80465

Mailing address

mailing_address

Required

The entity's mailing address on file where published separately from the principal address. Null when not published.

Type:string | null

Example:

PO Box 1234, Hartford, CT, 06103

Officers / principals

officers

Required

Officers or principals where the state's dataset publishes them. Empty array when not published. Each entry: {name, title, address}.

Type:object[]

Example:

[
  {
    "name": "JANE SMITH",
    "title": "Chief Executive Officer / Chairman",
    "address": "1 Main St, Albany, NY, 12207"
  }
]

Status date

status_date

Optional

Date the current entity_status took effect (ISO 8601 YYYY-MM-DD), where the state publishes it. Absent on rows from states that publish no lifecycle fields; null when not published.

Type:string | null

Example:

2026-04-13

Inactive date

inactive_date

Optional

Date the entity was dissolved, terminated or otherwise closed (ISO 8601 YYYY-MM-DD), where the state publishes it. Null for an entity that is still active or when not published.

Type:string | null

Example:

2006-08-01

Status reasons

status_reasons

Optional

Every reason the state lists for the entity's status, verbatim. Present only when it says more than entity_status (which carries the primary reason); null otherwise.

Type:string[] | null

Example:

In Good Standing,Pending Resubmission

Annual reports

annual_reports

Optional

Annual report record where the state publishes it: {last_filed_year, years_filed (newest first, each year once), next_due (ISO 8601 date or null)}, plus forfeiture_date (ISO 8601 date or null) where the state sets the date an entity is forfeited for an unfiled report. Null when not published.

Type:object | null

Example:

[object Object]

Filing history

filing_history

Optional

The entity's filings on record with the state, newest first, where the state publishes them: {filing_number, filing_type, filed_date, effective_date, status} (dates ISO 8601: YYYY-MM-DD, or YYYY-MM / YYYY where the state publishes only the month or year; any key the state does not publish is null). Null when not published or not read (see field_notes); an empty array means the state lists none.

Type:object[] | null

Example:

[object Object]

Liens checked

liens_checked

Required

Whether this run attempted a UCC / lien search against a covered source for the entity. Independent of whether any filing was found or the source errored; inspect lien_coverage for the outcome and field_notes for details.

Type:boolean

Example:

true

Lien coverage

lien_coverage

Required

Explicit lien-join outcome on completed entity records: 'joined' = searched and attached, 'no_lien_source' = entity found but this state has no lien join, 'unavailable' = the lien source errored at request time, 'not_requested' = no lien search ran for this record: includeLiens was false, the record is a list row, or the state's lien search runs only when the state is named in states. Null on non-completed records.

Type:string | null

Example:

joined

Options:

joinedno_lien_sourceunavailablenot_requestednull

UCC / lien filings

ucc_filings

Required

The differentiator: UCC / secured-transaction (lien) filings recorded against this entity, matched by debtor legal name. Empty array when none are found or when the state's UCC is not yet integrated. Each entry: {filing_number, filing_type, status, filed_date, lapse_date, secured_party, collateral, debtor_name, source_url, secured_party_source, secured_party_confidence}. secured_party_source "filing_image" marks a secured party read from the filing image (Missouri), with its confidence. With securedParty set, each entry also carries secured_party_filter; individual-debtor rows add debtor_kind and debtor_kind_basis. No address of an individual debtor is ever returned.

Type:object[]

Example:

[
  {
    "filing_number": "20212029405",
    "filing_type": "UCC financing statement",
    "status": "active",
    "filed_date": "2021-03-30",
    "lapse_date": "2026-03-30",
    "secured_party": "U.S. Small Business Administration",
    "collateral": "All assets",
    "debtor_name": "TESLA ELECTRIC COMPANY LLC",
    "source_url": "https://www.coloradosos.gov/biz/ucc/UCCSearchCriteria.do",
    "secured_party_source": null,
    "secured_party_confidence": null
  }
]

UCC summary

ucc_summary

Required

Quick lien counts for this entity: {total, active, filings_truncated}. Null unless lien_coverage is 'joined'.

Type:object | null

Example:

[object Object]

Status as of

status_as_of

Optional

due_diligence only: the source's own timestamp for entity_status (ISO 8601 UTC) — the run time for a registry read at run time, the publication time for an open-data register, the snapshot date for a bulk register. Absent on standard runs; null when the source publishes no timestamp.

Type:string | null

Example:

2026-10-16T12:00:05Z

Status source type

status_source_type

Optional

due_diligence only: how entity_status was obtained — live_portal (read from the registry at run time), open_data (the state's published open-data register), bulk_index (a periodic bulk copy of the register). Absent on standard runs.

Type:string | null

Example:

live_portal

Options:

live_portalopen_databulk_indexnull

Status is current

status_current

Optional

due_diligence only: true when a status was returned and status_as_of is within 24 hours of the run (48 hours for Illinois's daily register, counted from the start of the file's date). Absent on standard runs.

Type:boolean | null

Example:

true

Normalized standing

standing

Optional

due_diligence only: entity_status mapped to active / not_in_good_standing / inactive / unknown by a per-state table. A status the table does not list is unknown, never guessed; entity_status keeps the registry's own wording. Absent on standard runs.

Type:string | null

Example:

active

Options:

activenot_in_good_standinginactiveunknownnull

Recent financing summary

ucc_stacking

Optional

due_diligence only: from the joined UCC filings — {window_start, active_filings_12mo, distinct_secured_parties_12mo, lower_bound, null_reason}. Counts original financing statements filed since window_start that are not shown as terminated (amendments are not new filings). A count the source cannot support is null with null_reason, never 0. lower_bound is true when the filing list was cut short. Absent on standard runs; null when no lien join ran.

Type:object | null

Example:

[object Object]

Sanctions-list screen

sanctions_screen

Optional

due_diligence only, and only on a record whose status is current: {screened_at, lists:[{list, list_date}], potential_matches:[{name, matched_alias, uid, list, programs, score, link}], summary}. The legal name is screened against the entity entries (names and aliases) of the U.S. Treasury SDN list and consolidated non-SDN list, each as of its own publication date. Every similar name is reported as a potential match with a score from 0.85 to 1.0 for the caller to review; an empty list means no potential matches against the lists of those dates. Absent on standard runs.

Type:object | null

Example:

[object Object]

Recorded liens

lien_bundle

Optional

due_diligence only, and only on a record whose status is current. recorder: {coverage, jurisdiction, filings, liens_filed_by_company, types_unavailable, results_truncated, note} from one party search for the company's legal name in the county recorder of the registry's principal-office ZIP code; coverage is searched, not_covered (no ZIP, or the county is not covered) or unavailable (the recorder failed or did not answer in time). A filing is listed only when the lien is against this company, as established for that county and lien type; each is {kind (lien or release), lien_type (federal_tax_lien, state_tax_lien, mechanics_lien, judgment, lis_pendens, other_lien), document_type_raw (the recorder's own wording), recording_date, instrument_number, jurisdiction, creditors, source_url}. Creditors are named as filed. liens_filed_by_company counts liens the company holds against others (not listed). types_unavailable lists lien types found whose debtor side that recorder's records do not establish, with counts and a reason. state_filings (California): tax liens carried by the state's UCC index, which is searched by debtor name. fl_federal_lien_registry (Florida companies): federal liens filed with the Florida Department of State against the company, searched by debtor name; each {kind, lien_type federal_lien, filing_number, status (active, lapsed or terminated), status_raw, debtor_city, creditors}. md_court_judgments (Maryland companies): money judgments against the company in the Maryland circuit-court judgment index, kept apart from recorded liens: {coverage (searched, partial or unavailable), source, filings, outstanding, excluded {expired, criminal}, cases_not_read, results_truncated, note}. A judgment is listed only when the company is named as debtor by its exact name; each is {lien_type (judgment, or state_tax_lien when the creditor is the Comptroller of Maryland (any office or division), the Comptroller of the Treasury or the State of Maryland Central Collection Unit), case_number, court, county, creditors, debtor, entry_date, amount, status, status_date, standing (outstanding, resolved or unrecognized), expiration_date, expiration_raw, source}. Judgments past their expiration date and criminal cases are left out. District Court judgments recorded in a circuit court are not marked as such. partial means the index listed more rows than were read or some cases could not be read, so the list may be incomplete. Every section that is unavailable carries a note saying why. Absent on standard runs.

Type:object | null

Example:

[object Object]

Due diligence check

due_diligence

Optional

due_diligence only: {available, reason, reason_code, matched_on}. available=true means this record is a due diligence check (identity confirmed, status confirmed current at run time, screened against the sanctions lists) and bills as one; false means it is the standard record at the standard price, reason says why and how to fix it. reason_code: identity_unconfirmed, identity_ambiguous, confirmation_mismatch, confirmation_uncheckable, billed_as_standard, status_not_current, not_screened, or null. matched_on: confirmed_entity_number, confirmed_address, confirmed_officer, legal_name_exact, bare_name, name_without_legal_form, name_variant or ambiguous. Absent on standard runs.

Type:object | null

Example:

[object Object]

Financing positions (90 days and 12 months)

financing_positions

Optional

due_diligence only: original financing statements from the UCC join over last_90_days and last_12_months (from 90 days, or 12 calendar months, before the run date, inclusive), each {window_start, active_filings, distinct_secured_parties, filing_agent_filings, null_reason}, plus lower_bound (the filing list was cut short). Filings shown as ended or past their lapse date are not counted. Filing agents and representatives (a secured party listed "as representative") are not counted as secured parties; filing_agent_filings counts the filings that name no other secured party. A count that cannot be made is null with null_reason, never 0. Absent on standard runs.

Type:object | null

Example:

[object Object]

Time in business

time_in_business

Optional

due_diligence only: {months, as_of, date_used, date_basis, null_reason}: whole months from the record's formation_date to the run date. date_basis is formation, or in_state_registration for a foreign filing (the date it registered in this state); null when the record does not say. Null with null_reason when no full formation date is published. Absent on standard runs.

Type:object | null

Example:

[object Object]

Match role

match_role

Optional

Reverse search: why this company is on the list - its registered agent, officer or address matched the search. 'ucc_debtor' = a row of UCC search by an individual debtor's name: the person searched is in matched_name and the entity fields are null. Absent on company-search rows.

Type:string | null

Example:

registered_agent

Options:

registered_agentofficeraddressucc_debtornull

Matched name / street

matched_name

Optional

Reverse search only: the registered-agent name, officer name or street line that matched, explaining why this company is on the list; on an individual-debtor row, the person searched (LAST, FIRST MIDDLE). Absent on company-search rows; null when not supplied.

Type:string | null

Example:

EXAMPLE AGENT SERVICES LLC

Matched officer title

matched_title

Optional

Reverse search only: the matching officer's title as filed in the state register. Null when no officer title matched; absent on company-search rows.

Type:string | null

Example:

Matched address kinds

matched_address_kinds

Optional

Reverse address search only: which of the company's addresses matched (principal, mailing, registered_agent). Null for other roles; absent on company-search rows.

Type:string[] | null

Example:

principal,mailing

Resume cursor

resume_cursor

Optional

Reverse search only: an opaque cursor present only where a list stopped early. Pass it as resumeCursor with the same search settings to continue without repeating delivered companies. Otherwise null or absent.

Type:string | null

Example:

eyJ2IjoxLCJmIjoiZXhhbXBsZSIsInMiOnt9fQ

Source

source

Required

The official registry the entity record was sourced from. Null on non-completed records.

Type:string | null

Example:

Colorado Secretary of State (Business Entities)

Source URL

source_url

Required

Public URL of the state's business-search portal for verification. Null on non-completed records.

Type:string | null

Example:

https://www.coloradosos.gov/biz/BusinessEntityCriteriaExt.do

Fetched at

fetched_at

Required

ISO 8601 UTC timestamp of when the record was retrieved. Null on non-completed records.

Type:string | null

Example:

2026-07-09T14:03:11Z

Source data as of

source_as_of

Optional

When the record was read from a published copy of the state's register, the ISO 8601 UTC time that copy's data was published; null when the record was read live from the registry or the copy's date is unknown.

Type:string | null

Example:

2026-10-21T12:32:46Z

Error

error

Required

Why this record is not a result, on no_match/failed/not_covered records. Readable prose where a caller needs to act on it (a failed lookup, or a state whose registry no longer exposes a search), otherwise a short token such as 'no-entity-found' or 'state-not-covered'. Route on error_class, which is the stable machine contract; this field may be reworded. Null on completed records.

Type:string | null

Example:

state-not-covered

Message

message

Optional

Human-readable explanation and retry guidance. Free text; route on error_class, the stable machine contract. Note acknowledgements and guidance for unanswered lookups; omitted or null when not applicable.

Type:string | null

Field notes

field_notes

Required

Explanations for fields that are structurally absent (not just missing) on this record. Each entry is {fields, reason, detail}: 'reason' is 'omitted_by_law' (not part of the public record) or 'not_in_source' (public elsewhere but not on this state's dataset — e.g. registered agent, or UCC not yet integrated for the state). 'temporarily_unavailable' means a normally published field could not be retrieved at request time. 'possible_individual' marks filings whose debtor name reads as an individual with the same name as the company: they are kept in a standard search and left out of a due_diligence check. Empty array when everything was sourced normally.

Type:object[]

Example:

[
  {
    "fields": [
      "ucc_filings"
    ],
    "reason": "not_in_source",
    "detail": "UCC / lien filings are not yet integrated for this state; the entity record is returned without a lien join."
  }
]

Entity results truncated

results_truncated

Required

True when maxRecordsPerCompany dropped one or more matching entity candidates for this query.

Type:boolean

Example:

false

Name match

name_match

Optional

How a completed record's legal name answered the query: 'match_mode' = matched under the requested matchMode as submitted; 'abbreviation' = matched only after expanding standard abbreviations in the submitted name (ST = STREET, HLDG = HOLDINGS, RE = REAL ESTATE, …) and reading its last word as possibly cut short, as assessor-roll owner names are. Every submitted word still had to appear, in order. Also an exact-mode name whose words were shortened by dropping their vowels (e.g. RSTRTN = RESTORATION), matched to the one registered entity with the same words, word count and legal form; 'truncated_name_prefix' = an exact-mode name that looks cut short by a property roll's fixed-width owner field (e.g. 'DAS PROPERTIES INTERNATIONAL L') matched the one registered entity whose legal name starts with it. 'name_unverified' = an individual-debtor row whose filings are the filing office's own name matches, not confirmed against the exact name because the office publishes no debtor names (Michigan); each filing then carries name_unverified true. Null on non-completed records.

Type:string | null

Example:

match_mode

Options:

match_modeabbreviationtruncated_name_prefixname_unverifiednull

Near matches

near_matches

Optional

On a no_match only (exact or starts mode; in any mode, a name with a practice wrapper such as 'Law Office of' or a trailing services list after '/', '|' or ' - ' is also searched by its core name, and a 2-3 word name without spaces where the state's register supports it; when none of those finds anything, a name of two or more words is also searched by its leading words where the state's register supports it): up to 3 close entries from the state register (a name that differs only by its legal-form suffix first), each {legal_name, entity_id, state, kind}. kind says how the entry was found: 'name' (a close spelling of the submitted name), 'suffix' (differs only in how the legal form is spelled), 'spacing' (differs only in spacing or punctuation), 'vowelless' (the name read with its vowels back in), 'abbrev' (abbreviations spelled out), 'wrapper' / 'descriptor' (the name inside a practice wrapper / before a services list), 'glued' (the words written together), 'fewer_words' (contains the name's leading words only, e.g. without a trailing town or service). Re-run with one of these names, or with matchMode 'contains'. In reverse search (registeredAgent, officer, address), kind 'not_entity' lists up to 10 matched records that are not companies (trade or assumed names, name reservations, sole proprietorships, agent or landlord designations), each with its entity_type, on the state's no_match row or, when companies were also found, on the state's last returned row. These are hints, not records: they are not delivered as results and not charged. Empty array on every other record.

Type:object[]

Example:

[
  {
    "legal_name": "Tesla, Inc.",
    "entity_id": "20121234567",
    "state": "CO",
    "kind": "name"
  }
]

Secretary of State Business Entity Search - KYB, 50 + DC

clearpath/us-business-entity-search

KYB company lookup across the official business registries of all 50 states and DC. Returns the full entity record, not the search-result row: status, type, formation date, registered agent, officers with addresses, filing and name history, and UCC liens where published.

ClearPath

103

California Business & UCC Lien Search - bizfileOnline

dz_omar/california-bizfile-scraper

Search the official California Secretary of State bizfileOnline registers. Look up business entities (status, standing, type, registered agent) or UCC liens (financing statements, judgment liens, state and federal tax liens). Filter by type, status and date. No state API key needed.

FlowExtract API

Delaware Corporations Search — DE Entity Data API

nexgendata/delaware-corporations-search-scraper

Search the Delaware Division of Corporations entity registry. Partial-match name search returns matching DE entities — file_number + entity_name. KYC, AML, VC sourcing, M&A.

NexGenData

Secretary of State Business Entity Search (KYB)

whetstonetools/secretary-of-state-business-search

Search official US Secretary of State business registries across 25 states by company name. Returns normalized entity records — name, type, status, registration date, registered agent, officers/directors, jurisdiction, filing ID — for KYB and due diligence. No API keys.

Griffin

193

US Business Entity Search - Bulk Multi-State KYB Registry API

pink_comic/us-business-entity-search

Bulk US business entity search: 16 no-key SOS registries + optional CA. KYB/merchant/vendor checks — status, agents, officers, addresses. $0.002/result. Related: texas-business-leads, new-york-business-leads, sunbiz-florida-business-leads, nppes-npi-registry, whois-domain-lookup.

Ava Torres

239

Propwire.com [From $0.75💰] Leads Scraper

memo23/propwire-leads-scraper

Get comprehensive property data: estimated equity, foreclosure status (auction dates/lenders), mortgage and transfer history, owner portfolios, and tax assessments. Access detailed building specs like SF and year built, plus motivated seller lead types, including pre-foreclosures and high equity.

Muhamed Didovic

353

5.0

(7)

County Property Records API — County Assessor & Property Tax

shelvick/county-property-records

County property records, property tax records: who owns this property? Property owner lookup by address, parcel lookup by ID, parcel API, real estate owner search, LLC property ownership, property appraisal, assessed value, sales history. Tax assessor data and assessor search in 2,100+ US counties.

Scott Helvick

185

Florida UCC Lien Search - Debtors & Secured Parties

scrapers_lat/florida-ucc-liens-scraper

Search Florida UCC-1 lien filings: every debtor and secured party with full address, filed/lapsed status, filing and expiration dates, the UCC-3 amendment chain (continuation, termination, assignment) and document images. Filter by state, city, ZIP, lender and dates. JSON, CSV, Excel.

Scrapers Lat

Wyoming Business Entity Scraper

parseforge/wyoming-business-scraper

Scrapes Wyoming Secretary of State business filings by name or filing ID. Returns entity name, filing ID, status, and standing, with an optional deep-detail pass for registered agent, principal office, and annual report fields.

ParseForge

UCC Lien Search by Debtor Name — 19 Official State Sources

whetstonetools/ucc-lien-search

Search 19 official state UCC registries by organization debtor name. Normalized lien records: secured party, filing number/type, filing & lapse dates, status, collateral where published, official source URL. Pre-lending due diligence. No API keys.

Griffin