Signal taxonomy
What we detect, and what it takes.
A signal is a change in an official public record, found by comparing each new snapshot with the one before it. Here is every event type we track, what triggers it, and the source fields it needs.
14 of 21 event types are derived today.
Sample Agency 072, Inc.
Houston, TX · Detected yesterday
What changedSource fact
- Administrator
- M. Samplechanged toT. Example
Texas licensing record (sample) · retrieved 2026-10-04
Effective 2026-10-04 · Real signals show the source's update cadence and our check frequency.
Intent scoreHomeCareIntent interpretation
Contributing signals
- New license
- Administrator change
- Multiple recent signals
Derived where the source supports it
An event type is active in a state only when that state's source publishes the fields it needs. Otherwise it shows as “Not available from this source,” never as zero.
No signals from the first snapshot
The first ingestion of a source sets the baseline. Records already present are not reported as new, unless the source publishes an issue date inside the lookback window.
Facts first, interpretation labeled
Each signal stores the old and new values from the record. Anything we add about why it may matter is marked as HomeCareIntent interpretation.
Licensing
Licenses that appear, renew, expire or change status in the official record.
New agency
NEW_AGENCYWhat triggers it
A license appeared for an organization not previously seen in any tracked source.
Required source fields
Stable license or facility ID, legal or DBA name, address, and a prior snapshot to compare against
Derived todayPublic Market IndexNew license
NEW_LICENSEWhat triggers it
A license record appeared in the official source (or, on a baseline run, has an issue date inside the lookback window).
Required source fields
Stable license ID and license status; issue date when the source publishes one
Derived todayPublic Market IndexNew license application
NEW_APPLICATIONWhat triggers it
A license application appeared in the official source (status PENDING). Leading indicator: the agency is not licensed yet.
Required source fields
Source publishes pending applications with an ID and a pending status
Derived todayPaid feed onlyLicense renewal
LICENSE_RENEWALWhat triggers it
The license expiration date moved later.
Required source fields
License expiration date
Derived todayLicense expiring
LICENSE_EXPIRINGWhat triggers it
An active license's expiration date falls inside the expiring window.
Required source fields
License expiration date and status (the 60-day window is our derivation)
Derived todayLicense status change
LICENSE_STATUS_CHANGEWhat triggers it
The canonical license status changed, or the record was removed from the source.
Required source fields
License status, or the record's presence in the source
Derived todayPublic Market IndexName change
NAME_CHANGEWhat triggers it
The legal or DBA name on the license changed.
Required source fields
Legal or DBA name on the license
Derived today
Locations
Agencies that add, move or close locations.
New location
NEW_LOCATIONWhat triggers it
An existing organization gained a license at an address not previously associated with it.
Required source fields
License ID and address, linked to an organization already in the source
Derived todayPublic Market IndexLocation closed
LOCATION_CLOSEDWhat triggers it
A license for one location became inactive or left the source while the organization keeps other active licenses.
Required source fields
License status or removal, for an organization that keeps other active licenses
Derived todayPublic Market IndexAddress change
ADDRESS_CHANGEWhat triggers it
The normalized address on the license changed.
Required source fields
Street address on the license
Derived todayPublic Market Index
Leadership and control
Changes to the administrator, licensee or owner named on the license.
Administrator change
ADMINISTRATOR_CHANGEWhat triggers it
The administrator named on the license changed. Only for sources that publish an administrator.
Required source fields
Administrator name on the license
Derived todayPublic Market IndexLicensee change
LICENSEE_CHANGEWhat triggers it
The licensee named on the license changed.
Required source fields
Licensee name on the license
Derived todayPublic Market IndexOwnership change
OWNERSHIP_CHANGEWhat triggers it
The owner named on the license changed. Only for sources that publish an owner.
Required source fields
Owner name on the license, only where the source publishes owners (source-declared, never inferred)
Derived today
Contact data
Changes to published contact details. Useful context; rarely a reason to call on their own.
Phone change
PHONE_CHANGEWhat triggers it
The phone number on the license changed.
Required source fields
Phone number on the license
Derived today
Enrichment
Signals from third-party business data providers, labeled with provider and date.
Domain discovered
DOMAIN_DISCOVEREDWhat triggers it
A business domain was attributed to the organization by an enrichment provider.
Required source fields
A configured enrichment provider that returns a business domain
Not yet derivedWebsite discovered
WEBSITE_DISCOVEREDWhat triggers it
A live website was attributed to the organization by an enrichment provider.
Required source fields
A configured enrichment provider that returns a live website
Not yet derivedDecision maker found
DECISION_MAKER_FOUNDWhat triggers it
A public decision maker was attributed to the organization by an enrichment provider.
Required source fields
A configured enrichment provider that returns a public business contact
Not yet derivedHiring activity
HIRING_ACTIVITYWhat triggers it
Public job postings attributed to the organization.
Required source fields
A configured provider of public job postings
Not yet derived
Regulatory
Inspection, citation and complaint records published by regulators.
Inspection
INSPECTION_EVENTWhat triggers it
An official inspection or survey record.
Required source fields
A regulator source that publishes inspection or survey records
Not yet derivedCitation
CITATION_EVENTWhat triggers it
An official citation or deficiency record.
Required source fields
A regulator source that publishes citations or deficiencies
Not yet derivedComplaint
COMPLAINT_EVENTWhat triggers it
An official complaint investigation record.
Required source fields
A regulator source that publishes complaint investigations
Not yet derived
“Derived today” means our event engine produces the signal from official source data. Whether it appears in a given state depends on that state's source. See which states are live on the coverage page and how each signal is scored on the product page.