Mississippi Contractor License Lookup & Leads Scraper (MSBOC)

Pain points

• MSBOC publishes no download file: its public search pages through results 25 at a time by default, and the active roster alone is 13,186 licences (2026-10-07).
• Classifications, expiry and first-issue dates and officers are not in the search results at all — each sits on a separate detail page, one licence at a time.
• A search that matches exactly one licence jumps straight to that licence's page instead of a list, and the licence number alone is not unique (a residential and a commercial licence can share digits), so naive copying double-counts or drops rows.

What we solve

• Run once with no filters and get the whole active roster, or narrow it with MSBOC's own status, licence type, classification, county, city, ZIP and name filters, all sent to MSBOC itself.
• Each licence's detail page is fetched for you to add classifications, qualifying names, officers, first-issue and expiry dates, fax, minority flag and county.
• Rows are keyed on licence type plus licence number, the page's own total is checked on every page, and a licence matched by two of your searches is returned and billed once.

Summary

Pull the Mississippi State Board of Contractors roster as a spreadsheet-ready dataset. Leave every filter empty for every active licence in the state, commercial and residential, or narrow it by status (active, expired, inactive, revoked, suspended, unlicensed), licence type, classification (Electrical Work, Residential Builder, Roofing and the rest of MSBOC's 133 classes), county, city, ZIP or business name. Each row carries the business name, licence number and type, street address, city, state, ZIP and phone, and — with details on — the licence's classifications, qualifying names, officers, first-issue and expiry dates, fax, minority flag and Mississippi county, plus a link to the licence's own MSBOC page. Pay only per licence returned.

Who it's for

• Sales teams selling materials, equipment, insurance or software to contractors across Mississippi
• Bonding and insurance agents who need every licensed contractor with an expiry date
• General contractors and owners checking a sub's MSBOC classifications before awarding work
• Compliance and data teams keeping a CRM in sync with the state licence roster

How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

{
  "county": "Hinds",
  "classification": "E"
}

See Inputs below for every available field.

What you get

One row per record:

Field	Description
business_name	Company name as licensed by MSBOC
license_number	MSBOC licence number (commercial numbers carry a suffix such as -MC or -SC)
license_type	Commercial or Residential
status	The status searched, e.g. 'Licensed - Active'
classifications	Classes the licence holds, e.g. ELECTRICAL WORK, RESIDENTIAL BUILDER (details on)
qualifying_names	Qualifying person(s) for those classes (details on)
officers	Officers as 'NAME (TITLE)' (details on)
issue_date	First issue date, MM/DD/YYYY (details on)
expiration_date	Expiry date, MM/DD/YYYY (details on)
phone	Phone number on file, as MSBOC prints it
address	Street address or PO box on file
city	City of the address
address_state	State of the address — MS, or another state for out-of-state firms
zip_code	ZIP code of the address
county	Mississippi county of the address (details on), or the county searched; null for out-of-state firms on a statewide run
fax	Fax number, when MSBOC lists one (details on)
minority	MSBOC's minority flag, Yes or No (details on)
details_status	ok, failed or skipped_time_budget for the detail fields; null when details are off
source_url	The licence's own page on search.msboc.us

Sample:

{
  "business_name": "LEFLORE CONSTRUCTION LLC",
  "license_number": "19113-MC",
  "license_type": "Commercial",
  "status": "Licensed - Active",
  "classifications": [
    "BUILDING CONSTRUCTION",
    "ELECTRICAL WORK",
    "HIGHWAY, STREET AND BRIDGE CONSTRUCTION",
    "MECHANICAL WORK"
  ],
  "qualifying_names": [
    "MARCO LEFLORE"
  ],
  "officers": [
    "KERRY LEFLORE (PRESIDENT)",
    "MARCO LEFLORE (VICE-PRESIDENT)"
  ],
  "issue_date": "09/07/2011",
  "expiration_date": "09/29/2027",
  "phone": "601-214-0125",
  "address": "4670 MCWILLIE DRIVE",
  "city": "JACKSON",
  "address_state": "MS",
  "zip_code": "39206",
  "county": "Hinds",
  "state": "MS",
  "minority": "Yes",
  "details_status": "ok",
  "source_url": "https://search.msboc.us/Detail.cfm?ContractorID=22467&ContractorType=Commercial&varDataSource=BOC"
}

Inputs

Field	Required	Type	Default	Description
status	no	string	"active"	Which licences to export. 'Active' is every currently licensed contractor (13,186 on 2026-10-07). 'Expired' is the lapsed list (24,033), useful for win-back or compliance checks.
licenseType	no	string	"any"	Commercial (Board of Contractors commercial licences) or Residential (residential builders, remodelers and trades). 'Any' returns both.
classification	no	string	—	An MSBOC classification by code or name, e.g. 'E' (Electrical Work), 'S123' (Residential Roofing), 'Building Construction', 'Residential Builder'. An exact class name picks that class; otherwise every class with a word starting with what you typed is searched ('roof' finds both Residential ROOFING and Commercial ROOFING,SHEETMETAL AND SIDING). Leave empty for every classification. A value that matches no class is dropped (logged), never searched as 'all'.
classifications	no	array	[]	Several classifications in ONE run. Combined with 'Classification' if you fill both. A licence returned by two searches is returned (and billed) once.
county	no	string	—	Mississippi county, e.g. 'Hinds', 'DeSoto County', 'harrison'. MSBOC assigns the county from the ZIP of the licensee's address, so out-of-state firms are not under any county. Leave empty for the whole state.
counties	no	array	[]	Several counties in ONE run, e.g. Hinds, Madison and Rankin. Combined with 'County' if you fill both.
city	no	string	—	City of the licensee's address. MSBOC matches the start of the city name ('JACK' matches JACKSON).
cities	no	array	[]	Several cities in ONE run.
zipCode	no	string	—	A 5-digit ZIP code of the licensee's address.
zipCodes	no	array	[]	Several 5-digit ZIP codes in ONE run. Anything that is not 5 digits is dropped (logged).
businessName	no	string	—	Part of the company name, e.g. 'ELECTRIC' or 'Smith'. MSBOC matches it anywhere in the name.
businessNames	no	array	[]	Several company-name searches in ONE run.
includeDetails	no	boolean	true	Fetch each licence's MSBOC detail page to add its classifications, qualifying names, officers, first-issue and expiry dates, fax, minority flag and (for Mississippi addresses) county. Turn off for a faster export of name, licence number, address and phone only. Same price either way.
maxResults	no	integer	500	Cap on licences returned PER search (each county x classification x city x ZIP x name combination), so adding a county never truncates the ones after it. The whole active roster is about 13,200; set 100000 to take everything a search matches.
proxyConfiguration	no	object	{"useApifyProxy": false}	Optional. MSBOC answers direct requests; enable a proxy only if runs come back with a 'blocked' notice.

Pricing (Pay Per Event)

You pay per result (dataset-item) — no charge for empty runs. Example: 13186 every active Mississippi contractor licence at $0.004/result ≈ $52.74.

The default run (no filters, 500 licences) costs $2.00. Apify platform usage is billed separately.

Use cases

• Statewide prospect list — export all active licences once, with phone and street address, and load them into your CRM.
• Trade territory — pull every Electrical Work or Residential Builder licence in Hinds, Madison and Rankin counties in one run.
• Renewal and win-back outreach — sort by expiry date, or run the expired list (24,033 licences on 2026-10-07) for lapsed contractors.
• Verification — confirm a contractor's classes, qualifying names, officers and expiry straight from the licence's MSBOC page.

Why this actor

• Phone on 13,148 of the 13,186 active licences and a street address, city and ZIP on all of them (measured 2026-10-07).
• The whole active roster in one run with maxResults 100000: 13,186 licences in about 7 minutes, with classifications and expiry date on all 13,186 and officers on 10,870 (measured 2026-10-07).
• Every filter is MSBOC's own, sent to MSBOC — nothing is filtered after the fact, and an unrecognised value is dropped and logged instead of quietly widening your search.
• Each row links to the licence's own MSBOC page, so any record can be checked at the source.
• Pay per licence returned; a licence found by two of your searches is billed once.

Limitations & updates

Covers licences on the Mississippi State Board of Contractors' public search; one status per run. No email is published. Detail fields (classifications, dates, officers, fax, minority, county) come from a separate page per licence and are best-effort: a row whose page could not be read is still returned and says so in details_status. County is MSBOC's ZIP-based county, empty for out-of-state addresses. Phone numbers are passed through in MSBOC's own formats. If MSBOC does not answer, the run returns a free row saying so instead of an empty dataset.

FAQ

Where does the data come from?

From the Mississippi State Board of Contractors' public search at search.msboc.us — the results list and each licence's detail page.

How many licences are there?

Counted on MSBOC's search 2026-10-07: 13,186 active (8,043 commercial, 5,143 residential), 24,033 expired, 541 inactive, 1,096 unlicensed, 65 revoked and 24 suspended. 7,397 of the active licensees have a Mississippi address.

Does it return email addresses?

No. MSBOC does not publish email on its search or detail pages, so no row carries one. You get phone, street address, and with details on, fax, officers and qualifying names.

What does 'Include classifications, dates and officers' do?

It fetches each licence's MSBOC detail page, which is the only place classifications, first-issue and expiry dates, officers, fax, the minority flag and the county appear. It is on by default and the price is the same either way; turn it off for a faster export of name, licence, address and phone. If a detail page cannot be read, the row is still returned with details_status 'failed'.

Why is county empty on some rows?

MSBOC assigns a county from the ZIP of a Mississippi address, so out-of-state firms have none. When you search by county, every row carries the county you searched.

How do I name a classification?

By MSBOC code ('E', 'S123', 'B') or by name ('Electrical Work', 'Residential Builder'). An exact name picks that class; otherwise every class with a word starting with what you typed is searched ('roof' finds both roofing classes). The code 'B' is Building Construction on commercial licences and Residential Builder on residential ones, so it searches both unless you set the licence type.

How am I charged?

One event per licence returned ($0.004). A row explaining a source problem or an unusable input is free. maxResults caps each search, so the default run of 500 licences costs $2.00 and the whole active roster costs about $52.74.

Which actor to choose

Part of the contractor-license suite — pick the one that fits your goal:

• Virginia Contractor License Lookup (DPOR Bulk) — You need the same bulk statewide licence export for Virginia, with email.
• Arkansas Contractor License Lookup & Verify (ACLB) — You need Arkansas contractor licences.
• Tennessee Contractor License Lookup & Verify (TN DOCI) — You need Tennessee contractor licences.
• Iowa Contractor Registration Lookup & Leads Scraper (DIAL) — You need Iowa contractors — every active DIAL registration statewide, with phone and email, filtered by trade, county, city or ZIP.
• Ohio Contractor License Lookup & Leads Scraper (OCILB) — You need Ohio electrical, HVAC, plumbing, hydronics or refrigeration contractors — the full OCILB roster, by trade and county.
• Nebraska Contractor Registration Lookup & Leads Scraper (NDOL) — You need Nebraska contractors — every current NDOL registration, by service and county, with phone on request.
• Delaware Contractor License Lookup & List Scraper (DOR + DPR) — You need Delaware contractors — DOR business licences plus DPR electrical, plumbing and HVACR licences, by city or ZIP.
• DC Contractor License Lookup & List Scraper (DLCP) — You need contractors licensed in Washington, DC — every active DLCP general contractor, home improvement and asbestos licence, by address state, ZIP or ward.
• Arizona Contractor License Lookup & Leads Scraper (ROC) — You need Arizona contractors — one ROC licence by number or name, or every active licence statewide with phone, by class and city.
• West Virginia Contractor License Lookup & Leads Scraper (WVCLB) — You need West Virginia contractors — every current WVCLB licence with phone and mailing address, by county or classification.
• Colorado Electrical & Plumbing License Lookup & List Scraper — You need Colorado electrical or plumbing licences — contractors, masters and journeymen statewide, with status and public disciplinary actions.
• Maryland Contractor License Lookup & List Scraper (MHIC) — You need Maryland home improvement contractors — every active MHIC licence with street address and expiry, by city or ZIP.
• New Jersey Contractor License Lookup & Export (DCA) — You need New Jersey contractors — active DCA home improvement, electrical, master plumber and HVACR licences statewide or by city, with street address and owner for home improvement firms.

Guides & use cases

Written up on scrapebench.dev — the bench that runs and verifies this actor against the live source every night:

• How-to: How to run Mississippi Contractor License Lookup & Leads Scraper (MSBOC)
• Use case: List Electrical Contractors in Hinds County, Mississippi

More actors, coverage and nightly verification results: scrapebench.dev

Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the MCP tab on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

"List the actively licensed commercial electrical contractors in Hinds County, Mississippi, with their phone numbers and licence expiry dates."

Hinds County with classification 'E' returned 29 active licences on 2026-10-07; each row links to the licence's own MSBOC page. Runs started this way bill exactly like any other run.