Illinois IDFPR License Scraper

Search and verify Illinois professional licenses issued by the Illinois Department of Financial & Professional Regulation (IDFPR) — nurses, physicians, real estate agents/brokers, cosmetologists, accountants (CPAs), engineers, architects, roofing contractors, veterinarians, social workers, and 60+ other license types in one unified tool. Look up by name, license number, license type/board, city, county, or state, and browse disciplinary/enforcement actions. No auth, no cookies, no proxy required.

What this actor does

• Three modes: search, byLicenseNumbers, disciplinaryActions
• 63 license types / boards covering nearly every profession IDFPR regulates
• 31 license statuses — Active, Expired, Revoked, Suspended, Probation, and more
• Name search — first name, last name, and business/entity name (prefix match, case-insensitive)
• Location filters — city, county, state, ZIP code
• License sub-type filter — narrow within a license type by IDFPR's own description field (e.g. REGISTERED PROFESSIONAL NURSE within NURSING BOARD)
• Full-text keyword search across all fields
• Disciplinary history — case number, action taken, discipline dates and reason, when on record
• Empty fields are omitted — every record only contains fields IDFPR actually reported

Output per license

• fullName, firstName, middleName, lastName, namePrefix, nameSuffix, professionalTitle (individuals; professionalTitle is a credential like MD, DO, DDS, DVM, OD when IDFPR has one on file)
• businessName, businessDba, isBusiness (business/entity licenses)
• licenseNumber, licenseType, description (specific license sub-type), licenseStatus
• originalIssueDate, effectiveDate, expirationDate, lastModifiedDate (ISO YYYY-MM-DD)
• city, state, zipCode, county
• specialtyQualifier, controlledSubstanceSchedule, delegatedControlledSubstance (when applicable, e.g. prescribing licenses)
• everDisciplined — boolean
• caseNumber, disciplineAction, disciplineStartDate, disciplineEndDate, disciplineReason (only present when a license has disciplinary history)
• sourceUrl — direct link to the official record
• recordType: "license", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byLicenseNumbers / disciplinaryActions
lastName	string	Smith	Last name / business name prefix (mode=search)
firstName	string	–	First name prefix
businessName	string	–	Business/entity name prefix
keyword	string	–	Free-text search across all fields
licenseNumbers	array	–	Exact license numbers (mode=byLicenseNumbers)
licenseType	select	Any	One of 63 IDFPR license types / boards
licenseStatus	select	Any	One of 31 license statuses
city	string	–	Exact city match
county	string	–	Exact county match
state	string	–	2-letter state code
zipCode	string	–	5-digit ZIP
description	string	–	License sub-type prefix match, e.g. REGISTERED PROFESSIONAL NURSE
disciplinedOnly	bool	false	Only licenses with disciplinary history
maxItems	int	50	Hard cap (1–5000)

Example: search by name

{
  "mode": "search",
  "lastName": "Smith",
  "licenseType": "NURSING BOARD",
  "maxItems": 50
}

Example: lookup exact license numbers

{
  "mode": "byLicenseNumbers",
  "licenseNumbers": ["225000009", "041363875"]
}

Example: browse disciplinary actions for real estate licenses

{
  "mode": "disciplinaryActions",
  "licenseType": "REAL ESTATE",
  "maxItems": 100
}

Use cases

• Employers / HR — verify a candidate's or contractor's professional license before hiring
• Healthcare credentialing — confirm nurse, physician, or physical-therapist license status
• Real estate — verify a broker's or agent's license and disciplinary history
• Compliance teams — bulk-monitor license expirations across a workforce
• Journalists / researchers — analyze disciplinary trends by profession or county
• Consumer protection — check a contractor, cosmetologist, or auctioneer before doing business

Data source

This actor reads IDFPR's own official open-data publication — the "Professional Licensing" dataset on data.illinois.gov (Illinois's official open-data portal), which IDFPR updates daily and which mirrors every record its interactive "Check a License" tool exposes. IDFPR's interactive lookup tool (online-dfpr.micropact.com) sits behind an AWS WAF bot-management challenge that blocks automated/datacenter access; the open-data API is the same official data without that gate, so results are identical in substance and freshness.

Limitations

• County field is inconsistent upstream. For out-of-state licensees, IDFPR sometimes populates this field with the licensee's home state instead of an Illinois county — this reflects the source data, not an actor bug.
• Older/legacy records may lack a license number (e.g. some pre-1990s deceased/inactive records) — these are still returned with all other available fields, just without licenseNumber/sourceUrl.
• Name search is prefix-match, not fuzzy. lastName: "Smit" matches "Smith", "Smithson", etc. but not "Smyth". Use keyword for a broader full-text pass.

FAQ

Is this actor free to run? Yes — it uses Illinois's public open-data API directly, no residential proxy or paid API key required.

How fresh is the data? IDFPR updates the open-data mirror daily, matching the same cadence as its official interactive lookup tool.

What license types are covered? All 63 IDFPR boards/categories, including Nursing, Medical, Real Estate, Cosmetology, Dental, Pharmacy, Public Accountancy, Professional/Structural Engineering, Architecture, Veterinary, Social Work, Funeral/Embalming, Private Detective/Security, Roofing Contractors, and more. See the licenseType dropdown for the full list.

Can I search across every license type at once? Yes — leave licenseType on "Any license type" and search by name, city, or keyword instead.

What does everDisciplined mean? true if IDFPR's records show the license has ever been subject to a disciplinary action (suspension, revocation, probation, reprimand, etc.), regardless of current status.

Does this cover businesses/entities as well as individuals? Yes — license records for firms, agencies, and corporations (e.g. real estate brokerages, roofing contractors, collection agencies) are included, flagged with isBusiness: true.