Tennessee Contractor License Lookup & Verify

Search Tennessee's official Department of Commerce and Insurance (TDCI) public registry for general Contractor licenses. Search by business name, individual last name, or license number and return the official status, expiration date, classification, monetary limit, public location summary, and direct record link.

The Actor reads the public search at search.cloud.commerce.tn.gov. The Tennessee Board for Licensing Contractors links consumers to the public verification tool, which says search results are updated daily. TDCI remains the authoritative source for current licensing decisions.

What the Actor returns

Field	Description
licenseeName, entityType	Business or individual name and organization/individual type shown by TDCI
licenseNumber, licenseType, boardProgram	Official identifier and licensing program
status, expirationDate, originalLicensureDate	Source status and dates; expiration uses YYYY-MM-DD
appearsActiveAndUnexpired	Convenience check that the displayed status is Active and the date has not passed as of the source retrieval date
classificationCodes, monetaryLimitUsd, publicModifiers	Contractor classifications and monetary limit when the detail record shows them
city, state, postalCode, county	Public location summary. The source view does not show a street address, phone, or email
sourceRetrievedAt, checkedAt	Portal retrieval time and this Actor's UTC check time
sourceDetailUrl, sourceUrl	Direct official detail record and TDCI search page
sourceResultCount, sourcePageRecordCount, sourceResultsTruncated	Portal match count, records rendered on its first page, and whether either the Actor or portal limited output

The appearsActiveAndUnexpired flag is not legal advice or a determination that a contractor may bid on a particular project. TDCI advises users to consider both status and expiration; an Active status with an expired date is not treated as current. Open the official detail link for the latest record and consult TDCI when a licensing decision matters.

Search scope

This Actor searches the Contractor license type under TDCI's Contractors and Ltd Licensed Plumbers program. It does not search Home Improvement Contractor, Limited Licensed Electrician, Limited Licensed Plumber, or other professional boards. It reads the first result page only and opens at most maxResults detail pages. Broad search terms can match many records; use a distinctive company name or an exact license number for focused verification.

The official portal exposes current search results, not a downloadable contractor directory. It may render fewer first-page records than the total match count. The summary and every output item make truncation visible; run a narrower search or verify further records directly on TDCI's site.

Input

Field	Values	Default / limit
searchType	business_name, license_number, individual_last_name	business_name
query	One business name, license number, or last name	Doe; 2–100 characters
firstName	Optional first-name filter for an individual search	Empty
maxResults	Maximum detail records to open and return	10; 1–25

Example: search a business name.

{
  "searchType": "business_name",
  "query": "Doe",
  "maxResults": 10
}

Example: verify a known license number.

{
  "searchType": "license_number",
  "query": "85359",
  "maxResults": 1
}

Example: find an individual's contractor license.

{
  "searchType": "individual_last_name",
  "query": "Doe",
  "firstName": "John",
  "maxResults": 5
}

Output example

{
  "licenseeName": "DOE RIVER CONSTRUCTION, INC.",
  "entityType": "Organization",
  "licenseNumber": "85359",
  "licenseType": "Contractor",
  "boardProgram": "Contractors and Ltd Licensed Plumbers",
  "status": "Active",
  "expirationDate": "2028-03-31",
  "originalLicensureDate": "2026-03-19",
  "appearsActiveAndUnexpired": true,
  "classificationCodes": ["BC-A"],
  "monetaryLimitUsd": 125000,
  "city": "BUTLER",
  "state": "Tennessee",
  "postalCode": "37640",
  "county": "Carter",
  "sourceDetailUrl": "https://search.cloud.commerce.tn.gov/search/C2952503/detail",
  "detailAvailable": true
}

The record above is an example of the source shape; live values can change. The source detail page may omit classifications, monetary limits, dates, or location components for some records. When the list card is valid but a detail page cannot be read, the Actor preserves the card data, sets unavailable detail fields to null, and records the issue in OUTPUT.

Pricing

One run has an automatic start event and each default-dataset record has one automatic result event. There is no second custom charge for the same record. These prices were read back from the live private Actor's PPE configuration; platform usage is not passed through as a separate user charge. The creator still pays the platform usage cost from event revenue.

Event	FREE	BRONZE	SILVER	GOLD	PLATINUM	DIAMOND
Actor start	$0.005	$0.005	$0.005	$0.005	$0.005	$0.005
Contractor record	$0.010	$0.00975	$0.00950	$0.008	$0.008	$0.008

An empty run costs one start event ($0.005 at every tier). A one-record run costs $0.015 FREE, $0.01475 BRONZE, $0.01450 SILVER, or $0.013 GOLD, PLATINUM, and DIAMOND in event charges. A five-record run costs $0.055 FREE, $0.05375 BRONZE, $0.05250 SILVER, or $0.045 GOLD, PLATINUM, and DIAMOND. maxTotalChargeUsd has a $0.015 minimum, enough to cover a start plus one FREE-tier record. The Actor's default result cap is 10, and a verified free-plan run delivers at most 5 records.

Reliability and limits

• The Actor uses the public TDCI search and record-detail screens. It does not log in, solve a CAPTCHA, or bypass access controls.
• Searches are sequential, with one browser and at most 25 detail pages per run. Free-plan runs are capped at five delivered records before each write.
• If TDCI presents a challenge, denies access, or changes its public form, the Actor reports BLOCKED or FAILED with zero fabricated records.
• If the query is valid but no record matches, the Actor reports EMPTY and writes no result record.
• Valid partial records are retained if a detail page fails; unavailable detail fields stay null and the run summary records the warning.
• OUTPUT and SUMMARY store machine-readable run diagnostics separately from the license-record dataset.

Legal and data-use note

This Actor is an independent convenience tool, not a Tennessee government service. It processes public professional and business license information. Use it for legitimate license verification, respect TDCI's public search and applicable terms, and avoid high-volume or disruptive searches. Do not use the result as the sole basis for a legal or contracting decision. The official Board page describes its mission and points to the public verification search: Tennessee Board for Licensing Contractors. TDCI's public search guidance is available from Contractor Help & Support.