What it returns
Professional, occupational and contractor licenses issued by Illinois (Department of Financial and Professional Regulation), Colorado (Department of Regulatory Agencies), Texas (Department of Licensing and Regulation), Connecticut (Department of Consumer Protection), Delaware (Division of Professional Regulation), New York (real estate, appearance enhancement businesses, elevator licenses), Oregon (Construction Contractors Board, Building Codes Division) and Washington (Labor and Industries contractors, Department of Health care credentials), in one schema: state, license type and category, license number, licensee, business name, city, state and ZIP, status, issue, renewal and expiration dates, and disciplinary actions or status reasons where the state publishes them.
Verify a license by number or name, find licensed electricians, nurses, plumbers, cosmetologists or contractors in a city or ZIP, list licenses expiring soon, or count licenses by type, status, city or year. Street addresses and phone numbers are not included.
Colorado license types read as name plus DORA code, for example "Registered Nurse (RN)"; licenseType matches either. Washington health care credentials carry no address, so city and ZIP filters skip them. Illinois marks licenses that were ever disciplined; Delaware lists each action with its dates.
Source: each state's open-data portal, rebuilt weekly.
Charged per license or group returned.
New York and the Oregon contractor board publish active licenses only.
Request
POST https://api.pushbuild.com/state-professional-licenses/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
states | list of strings | CO, TX, CT, WA. |
name | string | Contains; people are listed Last, First. |
businessName | string | Contains. |
licenseNumbers | list of strings | Exact license or credential numbers. |
licenseType | string | Contains, e.g. Nurse, Electrician, Plumber, Real Estate, Contractor. |
category | string | Subcategory or specialty, contains. |
status | string | Contains, e.g. Active, Expired, Revoked. |
city | string | Contains. |
zips | list of strings | Five-digit ZIP codes. |
activeOnly | boolean | Only active, unexpired licenses. |
disciplinedOnly | boolean | Only licenses with a recorded disciplinary action or status reason. |
issuedFrom | string | YYYY-MM-DD. |
issuedTo | string | YYYY-MM-DD. |
expiresFrom | string | YYYY-MM-DD. |
expiresTo | string | YYYY-MM-DD. |
sort | string: name, expiringSoon, newest | name (default), expiringSoon or newest. |
groupBy | string: state, licenseType, category, status, city, zip, issuedYear, expiresYear | Counts by state, licenseType, category, status, city, zip, issuedYear or expiresYear. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/state-professional-licenses/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"states": ["CO"], "licenseType": "Electrician", "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 records. No charge for errors or empty searches.
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/state-professional-licenses. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comBuilding a list of businesses to approach? Lead list building