New York State Tax Warrants - Business Tax Liens

The New York State Department of Taxation and Finance files tax warrants - the state's recorded lien for unpaid tax - with the NYS Department of State, and publishes the register as open data. This actor turns it into a charged-per-record lookup and screening tool.

Built for: KYB and vendor-risk screening - checking whether a business or individual carries an unpaid New York State tax lien, sizing the exposure, and confirming whether a lien has been satisfied or vacated. Used for credit and underwriting decisions, M&A and title diligence, and accounts-receivable risk.

What it covers

667,922 warrant records (open data, continuously refreshed):

Status	Meaning	Records
Added	warrant filed	424,333
Closed	satisfied or vacated	243,398
Updated	amended	191

Each record carries the warrant id, the status (and its meaning), up to four named debtors with their address, city, state, ZIP, county and country, the filed amount, and the full lifecycle of dates: filed, satisfaction, vacate, amend and expiration. Dates come through as clean ISO (YYYY-MM-DD).

Two things this file is, and one it is not. It is the business / tax debtor register - unpaid income, sales and corporate tax warrants recorded as public liens, the record a credit or KYB screen runs against. It is a windowed feed (the state's published dataset begins 7/1/2025), so it carries recent filings rather than the complete historical lien book. And because the file records the lifecycle event, the same warrant can appear more than once as its status changes - warrant_id is not unique per row; the status is what tells you whether the lien is live (Added) or cleared (Closed).

It is not NY's child-support warrant file - a different table of individuals' family-support debt that this actor deliberately does not carry.

Typical questions

• "Does this company or person have an unpaid New York tax lien?"
• "Show every added (live) warrant for this debtor name."
• "Which warrants have been satisfied or vacated?"
• "List warrants filed in the last 90 days."
• "Find warrants of $100,000 or more for a name."
• "How are NY tax warrants distributed by debtor state and filing year?"

Inputs

Input	What it does
debtorName	substring match across all four named debtor columns
statusCode	Added = filed (live lien), Closed = satisfied/vacated, Updated = amended
state / city / countyCode / countryCode	debtor location
minAmount / maxAmount	warrant filed-amount range (USD)
filedFrom / filedTo	warrant filed-date window (YYYY-MM-DD)
recentDays	warrants filed within the last N days (0 = off)
mode / groupBy	rows for records, or aggregate for one row per group (status / state / county / year)
maxResults	cap records (default 50)

Default run = the newest filings. Add a debtorName filter or a date window to narrow; or set mode=aggregate for a whole-register rollup.

Example inputs

Screen a debtor name - matches any of the four named debtors.

{ "debtorName": "CONSTRUCTION LLC", "maxResults": 10 }

Only live liens - statusCode=Added returns warrants that have been filed and not yet cleared.

{ "statusCode": "Added", "maxResults": 10 }

Large, recent warrants - filings of $100,000+ in the last 90 days.

{ "minAmount": 100000, "recentDays": 90, "maxResults": 10 }

The status mix - one summary row per status, across the register.

{ "mode": "aggregate", "groupBy": "statusCode" }

Low cost

From $0.00005 per record, down to $0.00003 at Gold. Pay only for the records you actually receive - the whole register stays queryable, you are never billed for the scan behind it.

The warrant register is a 667,922-row statewide filing record, and a name screen has to reach every one of the four named debtors on a warrant, not just the first. Every pull is integrity-checked against the register's known shape (a total-count floor, a freshness probe on the newest filed timestamp, key-column coverage), so a degraded or schema-changed source fails loudly instead of returning bad rows.

Example output

debtorName=CONSTRUCTION - one matching warrant:

{
 "platform": "ny-tax-warrants",
 "source": "ny-tax-warrants",
 "dataState": "NY",
 "mode": "rows",
 "recordType": "warrant",
 "warrantId": "E-064113702-W001-9",
 "statusCode": "Added",
 "statusMeaning": "Added",
 "debtorName1": "CONSTRUCTION RESOURCES CORP. OF NEW YORK",
 "debtorName2": "",
 "debtorName3": "",
 "debtorName4": "",
 "debtorAddress1": "",
 "debtorAddress2": "221 HUNTER AVE",
 "city": "STATEN ISLAND",
 "state": "NY",
 "zipCode": "103063445",
 "countyCode": "RICHMOND",
 "countryCode": "US",
 "filedAmount": "51767.54",
 "filedDate": "2026-09-30",
 "satisfactionDate": "",
 "vacateDate": "",
 "amendDate": "",
 "expirationDate": "",
 "filedTimestamp": "2026-09-30",
 "sourceUrl": "https://www.tax.ny.gov/warrants/lookup.html?document=e-064113702-w001.pdf",
 "sourceUpdatedAt": "2026-10-05",
 "groupKey": "",
 "groupCount": "",
 "groupBy": ""
}

mode=aggregate, groupBy=state - warrants by debtor state (top):

NY    579,590
NJ     22,880
FL     11,417
CA      7,021
CT      6,059

Source

• New York State Tax Warrants - Open Data - the official public dataset this actor reads (NYS Dept. of Taxation and Finance, filed with the NYS Dept. of State).