Illinois Business Signals
An API and an MCP server that answer two questions from public Illinois records: is this business registered and active, and which businesses were newly registered in an Illinois county? It is for developers building AI agents, and for sales and lead-generation teams that check lists of businesses. Every answer cites its source and the date the data was pulled.
Base URL: https://api.blackdialsolutions.net · Terms of service · Coverage (free, JSON)
Before you pay
- Illinois only. Every answer covers Illinois businesses and Illinois counties.
- Call
GET /v1/coveragefirst. It is free and needs no key. It lists what is covered, how fresh each source is, and the known gaps. - not_found does not mean the business is fake. Insurers, banks and other entities chartered outside the Secretary of State, and sole proprietors and general partnerships outside Will County, are not in the data.
Endpoints
Examples use curl. A paid endpoint answers 402 Payment Required without a key or a payment; see How to pay per call and Monthly plans.
GET /v1/verify_business
Is this Illinois business registered and active? Returns a verdict, filing status, the best match with up to 3 alternatives, and a confidence score.
Price: $0.02 per call, or one unit of a monthly key.
Inputs
name: required, 2 to 200 charactersstate: required; only Illinois (IL) is coveredcity: optional, up to 100 characters; used to pick between businesses with the same name, and to confirm a match on a similar (not identical) namezip: optional, five digits or ZIP+4 (the first five are used); like city, it picks between same-named businesses. Only a ZIP confirms a similar-name match: such a match is verdict possible_match until the ZIP agrees with the record (a city alone does not confirm, and corporations have no ZIP on record, so they always stay possible_match)
curl "https://api.blackdialsolutions.net/v1/verify_business?name=Maple%20Street%20Bakery%20LLC&state=IL&zip=60435"
POST /v1/verify_batch
The same check for up to 100 businesses in one call; a bad item returns an error object in its own slot.
Price: $1.00 per call (flat), or one unit per valid business with a monthly key. Under 50 names, single verify_business calls are cheaper. An invalid item gets an error in its slot and is not counted; a batch with no valid item is refused (400) and is not charged. JSON body.
Inputs
businesses: required, array of 1 to 100 objects with name, state and optional city and zip (five digits or ZIP+4); each item takes the same rules as verify_business
curl -X POST "https://api.blackdialsolutions.net/v1/verify_batch" -H "Content-Type: application/json" -d '{"businesses":[{"name":"Maple Street Bakery LLC","state":"IL","zip":"60435"},{"name":"Sample Hardware Co","state":"IL"}]}'
GET /v1/new_filings
New business registrations (corporations, LLCs, and Will County assumed names) in one county, newest first.
Price: $0.05 per call, or one unit with a monthly key.
Inputs
county: required, an Illinois county name such as Will, DuPage or St. Clair (case and the word County are ignored)industry: optional, text matched against the industry_guess labelsince: optional, YYYY-MM-DD, at most 90 days before today; default 30 days before todaylimit: optional, 1 to 50; default 20include_foreign: optional, true or false; default true. False leaves out companies formed in another state that registered in Illinois (each record says foreign: true or false)
Newest first. At most 90 days back and at most 50 records per call; the default window is 30 days and the default limit is 20.
curl "https://api.blackdialsolutions.net/v1/new_filings?county=Will&since=2026-11-01&limit=5"
GET /v1/coverage
This page: what the service covers, how fresh it is, its prices and its known gaps.
Price: Free, no key.
curl "https://api.blackdialsolutions.net/v1/coverage"
GET /health
Service status and the age of each data source. Always 200 while the database can be read.
Price: Free, no key.
curl "https://api.blackdialsolutions.net/health"
Planned: signals
Building permits, liquor licences and event permits. Planned for a later stage; not available.
Verdicts
A status check returns one of five verdicts at the top level.
| Verdict | Meaning |
|---|---|
active | Registered and in good standing, or still active with a status flag listed in flags. |
inactive | The state record shows the entity dissolved, revoked, withdrawn, merged or otherwise no longer active. |
possible_match | A record with a similar, not identical, name exists. Its status is in match.record_verdict. Confirm with the business's ZIP code, or by comparing the returned name, before relying on it. A similar-name match to a corporation always stays possible_match, because the state publishes no address for corporations. |
not_found | No matching record in the covered Illinois data. not_found does not mean the business is fake. |
unknown | A record exists but the data cannot say whether it still operates (Will County DBA filings, or an unrecognised status). |
No matching record in the covered Illinois data. not_found does not mean the business is fake.
county_source
Each record says where its county came from.
| Value | Meaning |
|---|---|
office | County of the business's principal office, taken from the office ZIP code (LLCs). |
registered_agent | County of the registered agent, because the state publishes no office address for corporations. Approximate: the business may be elsewhere. |
county_filing | County that received the filing (Will County assumed-name filings). |
Coverage and known gaps
All 102 Illinois counties. Records the state files give no county for are not returned by county queries.
County filings: Will County only, for assumed-name (DBA) filings.
Known gaps:
- not_found does not mean the business is fake. Insurers, banks and other entities chartered outside the Secretary of State, and sole proprietors and general partnerships outside Will County, are not in this data.
- Sole proprietors and general partnerships outside Will County are not covered.
- Corporations have no street address: the state does not publish one. Their county is the registered agent's county.
- Businesses chartered outside the Secretary of State (for example some insurers and banks) are absent.
- LLC industry labels, and most corporation industry labels, are guesses from the business name.
- No websites.
- No data about private individuals: no owner, manager or officer names, and registered agents only when the agent is a company.
Data sources
Each source's data date is also on /health.
| Source | What it is | Records | Filing dates | Data as of | Refresh |
|---|---|---|---|---|---|
ilsos_corp | Illinois Secretary of State corporation file (for-profit and not-for-profit corporations). | 1,990,452 | 1839-02-22 to 2026-11-19 | 2026-11-19 | Refreshed by the operator from the state's free bulk files, typically within a few days of the state's run date. |
ilsos_llc | Illinois Secretary of State limited liability company file. | 1,524,816 | 1994-01-01 to 2026-11-19 | 2026-11-19 | Refreshed by the operator from the state's free bulk files, typically within a few days of the state's run date. |
will_dba | Will County Clerk assumed-name (DBA) filings. | 667 | 2024-01-02 to 2026-10-29 | 2026-11-10 | Monthly. Published about 7 days after the paying-client feed, so every filing is at least 7 days old. |
How to pay per call (x402)
Network: Base mainnet (base, eip155:8453). Payment is in USDC.
- Send the request with no key. The server answers
402 Payment Required. ThePAYMENT-REQUIREDheader holds the payment requirements (x402 v2). The JSON body gives the price, network and receiving address. - Sign the payment. Your x402 client signs a USDC payment for that price on the network above.
- Send the same request again with the signed payment in the
PAYMENT-SIGNATUREheader. You get the data and a receipt in thePAYMENT-RESPONSEheader.
A failed call is not charged. If the answer is 402 with error code settlement_pending and a Retry-After header, the payment may still be settling: retry with the same payment and do not sign a new one.
Example, without a payment:
$ curl -i "https://api.blackdialsolutions.net/v1/verify_business?name=Maple%20Street%20Bakery%20LLC&state=IL"
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64 payment requirements>
Content-Type: application/json
{
"error": {
"code": "payment_required",
"message": "This call costs $0.02 (USDC on base). Pay with an x402 client, or send an X-API-Key."
},
"price_usd": 0.02,
"network": "base",
"network_id": "eip155:8453",
"pay_to": "0x… (the receiving address)",
"endpoint": "GET /v1/verify_business",
"payment_requirements": "See the PAYMENT-REQUIRED response header (x402 v2); retry with a PAYMENT-SIGNATURE header.",
"coverage": "https://api.blackdialsolutions.net/v1/coverage",
"test_mode": false
}
Monthly plans
| Plan | Price | Calls | Buy |
|---|---|---|---|
| Starter | $29.00 per month | 2,000 calls per month | |
| Pro | $99.00 per month | 10,000 calls per month |
After you pay, the success page shows your API key once. Save it. Send it as the X-API-Key header. Each successful call uses one unit; a batch uses one unit per valid business; failed calls are not counted. When a key's monthly calls run out, further calls are paid per call at the prices above. Rate limit: 60 calls a minute per key or paying wallet.
Connect over MCP
MCP endpoint: https://api.blackdialsolutions.net/mcp (Streamable HTTP, stateless). Five tools: verify_business, verify_batch and new_filings (paid), and coverage and health (free).
Client configuration. Field names differ between MCP clients, so check your client's notes on remote servers. Put your own key in place of YOUR_API_KEY:
{
"mcpServers": {
"illinois-business-signals": {
"url": "https://api.blackdialsolutions.net/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
Pay per tool call instead: leave out the header. A paid tool then returns an error result with the x402 payment requirements; retry the same call with the signed payment in the call's _meta field, under x402/payment. Free tools need no key and no payment. The tool descriptions:
verify_business
Is this business registered in Illinois, and is it still active? Illinois only.
Inputs: name (2-200 chars), state (IL or Illinois), optional city (max 100), optional zip (5 digits or ZIP+4).
Price: $0.02 per call, paid per call with x402. A monthly API key also works (one unit per call). Call coverage first (free).
Verdicts:
- active: Registered and in good standing, or still active with a status flag listed in flags.
- inactive: The state record shows the entity dissolved, revoked, withdrawn, merged or otherwise no longer active.
- possible_match: A record with a similar, not identical, name exists. Its status is in match.record_verdict. Confirm with the business's ZIP code, or by comparing the returned name, before relying on it. A similar-name match to a corporation always stays possible_match, because the state publishes no address for corporations.
- not_found: No matching record in the covered Illinois data. not_found does not mean the business is fake.
- unknown: A record exists but the data cannot say whether it still operates (Will County DBA filings, or an unrecognised status).
county_source says where county came from: office, registered_agent or county_filing. registered_agent means the county is the registered agent's county, so it is approximate (this applies to every corporation).
possible_match is confirmed only by a matching ZIP, never by city alone. not_found does not mean the business is fake: insurers, banks and other entities chartered outside the Secretary of State, and sole proprietors and general partnerships outside Will County, are not covered. Every record cites source_url and pulled_at.
Example call: {"name":"Maple Street Bakery LLC","state":"IL","zip":"60435"}
Example response: {"verdict":"active","confidence":1,"flags":["annual_report_current"],"match":{"name":"Maple Street Bakery LLC","record_verdict":"active","county":"Will","county_source":"office","source_url":"https://...","pulled_at":"2026-11-14T06:00:00.000Z"},"alternatives":[]}verify_batch
The same status check as verify_business for 1 to 100 Illinois businesses in one call. Use it for lead lists. A bad item returns an error object in its own slot and is not counted; a batch with no valid item is refused and costs nothing.
Inputs: businesses, an array of {name, state, optional city, optional zip}, same limits as verify_business.
Price: $1.00 flat per call with x402. Under 50 names, single verify_business calls are cheaper. A monthly API key also works: one unit per valid business. Call coverage first (free).
Verdicts:
- active: Registered and in good standing, or still active with a status flag listed in flags.
- inactive: The state record shows the entity dissolved, revoked, withdrawn, merged or otherwise no longer active.
- possible_match: A record with a similar, not identical, name exists. Its status is in match.record_verdict. Confirm with the business's ZIP code, or by comparing the returned name, before relying on it. A similar-name match to a corporation always stays possible_match, because the state publishes no address for corporations.
- not_found: No matching record in the covered Illinois data. not_found does not mean the business is fake.
- unknown: A record exists but the data cannot say whether it still operates (Will County DBA filings, or an unrecognised status).
county_source says where county came from: office, registered_agent or county_filing. registered_agent means the county is the registered agent's county, so it is approximate (this applies to every corporation).
possible_match is confirmed only by a matching ZIP, never by city alone. not_found does not mean the business is fake: insurers, banks and other entities chartered outside the Secretary of State, and sole proprietors and general partnerships outside Will County, are not covered. Every record cites source_url and pulled_at.
Example call: {"businesses":[{"name":"Maple Street Bakery LLC","state":"IL","zip":"60435"},{"name":"Sample Hardware Co","state":"IL"}]}
Example response: {"results":[{"verdict":"active","match":{"name":"Maple Street Bakery LLC","county_source":"office","source_url":"https://...","pulled_at":"..."}},{"verdict":"not_found","match":null}]}new_filings
Which businesses newly registered in one Illinois county? Newest first, from the Secretary of State files (plus Will County assumed-name filings).
Inputs: county (required, one county per call, e.g. Will or DuPage), optional industry (text matched against industry_guess), optional since (YYYY-MM-DD, at most 90 days back, default 30), optional limit (1 to 50, default 20), optional include_foreign (true or false, default true).
Price: $0.05 per call, paid per call with x402. A monthly API key also works (one unit per call). Call coverage first (free).
county_source says where county came from: office, registered_agent or county_filing. registered_agent means the county is the registered agent's county, so it is approximate (this applies to every corporation).
Caveats: industry_guess is a guess from the business name, with industry_guess_basis saying how; it is often null. Foreign companies (formed in another state, registered in Illinois) are included by default and labelled foreign: true; send include_foreign false to leave them out. Every record cites source_url and pulled_at.
Example call: {"county":"Will","since":"2026-11-01","limit":5}
Example response: {"count":1,"total_matching":1,"records":[{"name":"Maple Street Bakery LLC","entity_type":"LLC","foreign":false,"filing_date":"2026-11-10","county":"Will","county_source":"office","industry_guess":null,"source_url":"https://...","pulled_at":"..."}],"data_as_of":{...},"notes":[]}coverage
Free. Call this first to see what is covered before paying: data sources and how fresh they are, the 102 Illinois counties with record counts, the verdict and county_source meanings, known gaps, prices, and how to authenticate or pay (including this MCP endpoint).
Inputs: none. Price: free, no key needed.
Example call: {}
Example response: {"service":"Illinois Business Signals","endpoints":[...],"sources":[...],"known_gaps":[...],"plans":{...},"mcp":{"path":"/mcp",...}}health
Free. Is the service up, and how fresh is each data source? status is ok, or stale when a source is older than its threshold.
Inputs: none. Price: free, no key needed.
Example call: {}
Example response: {"status":"ok","data_freshness":"2026-11-13","sources":{"ilsos_corp":{"data_as_of":"2026-11-13","age_days":1,"records":0}},"version":"0.1.0"}Rate limits and errors
- 60 calls a minute per key or paying wallet.
- Requests with no key or payment are limited per IP address (240 a minute). Checkout is limited to 20 requests a minute per IP address.
Errors are JSON in this shape: {"error": {"code": "…", "message": "…"}}.
| Status | Code | What it means |
|---|---|---|
| 400 | invalid_request | The input is wrong. Nothing is charged or counted. |
| 401 | invalid_api_key | The X-API-Key is unknown, malformed, revoked or cancelled. Check it, or remove the header to pay per call. |
| 402 | payment_required | No valid key with quota left, and no payment. The body and PAYMENT-REQUIRED header say how to pay. settlement_pending means retry with the same payment. |
| 429 | rate_limited | Too many calls. Wait for the number of seconds in Retry-After. |
| 502 | facilitator_unavailable | The payment service could not be reached. No payment was taken and no data was delivered. Retry shortly. |
| 503 | service_paused | The service is paused for maintenance. Nothing is charged or counted. Retry after Retry-After. |
| 503 | payments_not_configured | Pay per call is not set up on this server. The free routes still work. |
Terms and contact
Terms of service: /terms.
Operator: Black Dial Solutions, LLC.
Contact: [email protected].