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/coverage first. 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

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

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

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.

VerdictMeaning
activeRegistered and in good standing, or still active with a status flag listed in flags.
inactiveThe state record shows the entity dissolved, revoked, withdrawn, merged or otherwise no longer active.
possible_matchA 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_foundNo matching record in the covered Illinois data. not_found does not mean the business is fake.
unknownA 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.

ValueMeaning
officeCounty of the business's principal office, taken from the office ZIP code (LLCs).
registered_agentCounty of the registered agent, because the state publishes no office address for corporations. Approximate: the business may be elsewhere.
county_filingCounty 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:

Data sources

Each source's data date is also on /health.

SourceWhat it isRecordsFiling datesData as ofRefresh
ilsos_corpIllinois Secretary of State corporation file (for-profit and not-for-profit corporations).1,990,4521839-02-22 to 2026-11-192026-11-19Refreshed by the operator from the state's free bulk files, typically within a few days of the state's run date.
ilsos_llcIllinois Secretary of State limited liability company file.1,524,8161994-01-01 to 2026-11-192026-11-19Refreshed by the operator from the state's free bulk files, typically within a few days of the state's run date.
will_dbaWill County Clerk assumed-name (DBA) filings.6672024-01-02 to 2026-10-292026-11-10Monthly. 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.

  1. Send the request with no key. The server answers 402 Payment Required. The PAYMENT-REQUIRED header holds the payment requirements (x402 v2). The JSON body gives the price, network and receiving address.
  2. Sign the payment. Your x402 client signs a USDC payment for that price on the network above.
  3. Send the same request again with the signed payment in the PAYMENT-SIGNATURE header. You get the data and a receipt in the PAYMENT-RESPONSE header.

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

PlanPriceCallsBuy
Starter$29.00 per month2,000 calls per month
Pro$99.00 per month10,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

Errors are JSON in this shape: {"error": {"code": "…", "message": "…"}}.

StatusCodeWhat it means
400invalid_requestThe input is wrong. Nothing is charged or counted.
401invalid_api_keyThe X-API-Key is unknown, malformed, revoked or cancelled. Check it, or remove the header to pay per call.
402payment_requiredNo 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.
429rate_limitedToo many calls. Wait for the number of seconds in Retry-After.
502facilitator_unavailableThe payment service could not be reached. No payment was taken and no data was delivered. Retry shortly.
503service_pausedThe service is paused for maintenance. Nothing is charged or counted. Retry after Retry-After.
503payments_not_configuredPay 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].