# Florida DFS Insurance License Scraper (`ws_tony/florida-dfs-insurance-license`) Actor Search Florida DFS insurance license records by name or license number, or bulk-download the full statewide dataset. No proxy needed. - **URL**: https://apify.com/ws\_tony/florida-dfs-insurance-license.md - **Developed by:** [Tony](https://apify.com/ws_tony) (community) - **Categories:** Lead generation - **Stats:** 3 total users, 1 monthly users, 75.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 license\_searches This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Florida Insurance License Lookup — FL DFS Producer & Appointment Verifier Instantly verify Florida insurance licenses and producer appointments directly from the **Florida Department of Financial Services** ([licenseesearch.fldfs.com](https://licenseesearch.fldfs.com/)). Search any Florida-licensed agent, adjuster, or agency by name, NPN, license number, or email — or bulk-download the complete statewide dataset of 350,000+ licensed producers in a single run. **No proxy required. No login. No CAPTCHA.** Public government data, updated daily by FL DFS. **Last verified working:** May 25, 2026. --- ### Why Use This Actor? Manually checking producer licenses on the FL DFS portal is slow, one-at-a-time work. This actor automates the full verification workflow — from spot-checking a single NPN to auditing your entire Florida producer book — and delivers structured, integration-ready data directly to your Apify dataset. - **Carriers:** Verify agent appointments and license status before binding a policy in Florida - **MGAs & wholesalers:** Onboard new producers faster — confirm active FL license, qualifying appointment, and CE compliance in one API call - **Compliance & licensing teams:** Run quarterly audits of your Florida producer book; flag anyone with an expiring appointment or incomplete CE hours - **Insurtech platforms:** Enrich your producer CRM with live FL DFS data — license type, NPN, expiration dates, appointing carrier names, and contact info --- ### What It Returns **Search mode** looks up individual producers by last name, firm name, FL license number, NPN, or email address. For each match it fetches the full FL DFS detail page and returns a normalized record with: - License number, NPN, full name, and license type - Active / inactive status and license issue date - All active appointments — carrier name, appointment type, issue date, and expiration date - `appointment_expiring_soon` flag — `true` if any appointment expires within 60 days - `has_qualifying_appointment` — the key compliance gate for binding authority in Florida - CE due date and compliance status - Business and mailing addresses split into individual fields - Email address and business phone **Bulk mode** streams the complete statewide CSV files published by the Florida CFO's office — up to 1 million+ records — without ever loading the full file into memory. Ideal for building a local mirror of FL producer data or enriching a large CRM dataset. --- ### Search Inputs | Field | Description | |---|---| | `lastName` | Individual last name (min 3 characters) | | `firstName` | Optional first name to narrow results | | `firmName` | Agency or firm name search | | `licenseNumber` | Direct FL license number lookup (e.g. `A245935`) | | `npnNumber` | National Producer Number — the universal agent ID | | `emailAddress` | Email address on file with FL DFS — useful for CRM matching | | `licenseStatus` | `1` = valid only (default), `2` = invalid only, `3` = both | | `licenseCategory` | Filter by P&C, Life, Health, Adjuster, Title, etc. (see table below) | | `residentStatus` | Resident, Non-Resident, or both | | `maxResults` | Cap the result count; `0` = unlimited | --- ### Example Input **Verify a specific producer (NPN lookup):** ```json { "mode": "search", "npnNumber": "592200" } ```` **Audit all active P\&C agents named Johnson:** ```json { "mode": "search", "lastName": "Johnson", "licenseCategory": "15", "licenseStatus": "1", "maxResults": 500 } ``` **Find all active Brightway Insurance agencies:** ```json { "mode": "search", "firmName": "Brightway Insurance", "licenseStatus": "1" } ``` **Bulk download — all valid individual FL licenses:** ```json { "mode": "bulk", "bulkDataset": "individual_licenses", "maxResults": 0 } ``` *** ### Example Output **Search mode** — one enriched record per producer: ```json { "license_number": "A245935", "full_name": "SMITH - PRENITZER, CAROL A", "first_name": "CAROL A", "last_name": "SMITH - PRENITZER", "npn_number": "592200", "license_status": "Active", "license_type": "TITLE (0410)", "license_issue_date": "1/3/2005", "has_qualifying_appointment": true, "expiration_date": "5/31/2026", "appointment_expiring_soon": true, "active_appointments": [ { "license_type": "TITLE (0410)", "company_name": "DOMA TITLE INSURANCE, INC.", "issue_date": "11/14/2013", "exp_date": "5/31/2026" }, { "license_type": "TITLE (0410)", "company_name": "FIRST AMERICAN TITLE INSURANCE COMPANY", "issue_date": "4/28/2022", "exp_date": "5/31/2026" } ], "ce_due_date": "5/31/2026", "ce_status": "Compliant", "email_address": "CAPRENITZER@GMAIL.COM", "business_phone": "(561) 289-8088", "business_address1": "FIRST AMERICAN TITLE INSURANCE COMPANY 2580 S. VOLUSIA AVENUE #102", "business_city": "ORANGE CITY", "business_state": "FL", "business_zip": "32763", "business_county": "Volusia", "mailing_address": "2085 PACKARD AVENUE", "mailing_city": "OVIEDO", "mailing_state": "FL", "mailing_zip": "32785", "source_url": "https://licenseesearch.fldfs.com/Licensee/296004", "scraped_at": "2026-05-25T12:00:00.000Z" } ``` **Bulk mode** — one record per CSV row, column names normalized to `snake_case`: ```json { "license_number": "A183305", "full_name": "MOORE, JAMES SCOTT", "first_name": "JAMES SCOTT", "last_name": "MOORE", "npn_number": "501707", "residency_type": "Resident", "ae_name": "RLI INSURANCE COMPANY", "eob_status": "ACTIVE", "email_address": "SCOTT@8FLAGS.COM", "business_phone": "9043106515", "business_city": "FERNANDINA BEACH", "business_state": "FL", "business_zip": "320343093", "business_county": "Nassau", "source_url": "https://www.myfloridacfo.com/downloads/AAS/LicenseeSearch/ExchangeOfBusinessRegistrations.csv", "scraped_at": "2026-05-25T12:00:00.000Z" } ``` *** ### Pricing **$0.005 per record** — pay only for what you pull. No subscription, no minimum. | Use case | Records | Estimated cost | |---|---|---| | Single producer spot-check | 1 | $0.005 | | Onboard 100 new agents | 100 | $0.50 | | Full state individual license file | ~350,000 | ~$1.75 | | Full appointment file (A–G) | ~1,000,000+ | ~$5.00 | *** ### License Category Codes Filter results to a specific line of business using the `licenseCategory` field. | Code | Line of Business | |---|---| | *(blank)* | All Categories | | `1` | Adjuster | | `2` | Bail Bonds | | `3` | Company / MGA Service Staff | | `4` | Customer Representative | | `5` | Debit Agent | | `6` | Health | | `7` | Insurance Agency | | `8` | Legal Expense | | `9` | Life & Annuity | | `10` | Limited Lines | | `11` | Mediator | | `12` | MGA | | `13` | Navigator | | `14` | Neutral Evaluator | | `15` | Property & Casualty | | `16` | Reinsurance | | `17` | Surplus Lines | | `18` | Title | | `19` | Warranty | | `50` | Adjusting Firm | *** ### Key Output Fields Explained | Field | What it means | |---|---| | `appointment_expiring_soon` | `true` if any active appointment expires within 60 days of the run date — use this to build automated renewal watchlists | | `has_qualifying_appointment` | `true` if the producer holds a qualifying appointment — the binding authority gate in Florida | | `active_appointments` | Complete array of current carrier appointments; always present (empty `[]` when none) | | `ce_status` | `"Compliant"`, `"In Progress"` (hours not yet met this cycle), or `null` | | `license_status` | `"Active"` if at least one valid license exists; `"Inactive"` otherwise | | `business_county` | Populated for FL residents; typically `null` for non-resident producers | *** ### Bulk Dataset Reference The Florida CFO publishes these files daily. Each is a complete snapshot of that data category. | Dataset key | Contents | File size | |---|---|---| | `individual_licenses` | All valid FL licenses for individual producers — license number, name, NPN, type, issue date, residency, address, email | 320 MB | | `business_licenses` | Same schema for agencies, adjusting firms, and MGAs | 25 MB | | `ce_required` | All licensees with a CE requirement — due date, hours required, hours completed | 156 MB | | `appointments_individual_ag` | Active appointments for producers A–G — producer name, NPN, carrier name, type, status date | 374 MB | | `appointments_individual_ho` | Same for H–O | 310 MB | | `appointments_individual_pz` | Same for P–Z | 336 MB | | `appointments_business` | Active appointments held by agencies and MGAs | 18 MB | | `county_appointments` | Active appointments by Florida county — for geographic carrier distribution analysis | 243 MB | | `exchange_registrations` | Exchange of Business registrations — appointing entity, EOB status, issue date, full contact details | 107 KB | *** ### Pairs Well With [DBPR Florida License Verification](https://apify.com/ws_tony/dbpr-florida-license-verification) — if your compliance workflow covers more than insurance (contractors, real estate agents, CPAs, medical professionals), the DBPR actor covers those license types. Run both for a complete Florida professional license verification stack. *** ### Known Limitations - Name search requires at least 3 characters — this limit is enforced server-side by FL DFS - Search mode makes one HTTP request per result for detail-page enrichment; for 500+ records, run time increases proportionally — use `maxResults` to sample first - `business_county` is only populated for FL resident producers - `business_address1` for title agents may include the company name as a prefix — this reflects how FL DFS stores the address - Bulk CSV column names flow through from the state's published format (normalized to `snake_case`) — if the state changes its column structure, those changes pass through automatically *** ### FAQ **Can I verify a list of 500 producers in one run?** The most efficient approach is bulk mode — download the full individual license file and filter it by your producer list. For real-time verification of a small list, run search mode with `maxResults` capped per producer. A multi-query batch feature is on the roadmap. **Can I search by email address?** Yes — pass `emailAddress`. Useful for cross-referencing a CRM where you have the producer's contact email but not their FL license number. **Can I check whether an agent can legally bind business in Florida?** Yes — `has_qualifying_appointment: true` is the signal. An active license alone is not sufficient to bind in FL; the producer also needs a qualifying appointment from a carrier licensed in Florida. **Can I search by NPN?** Yes — `npnNumber` in search mode does a direct NPN lookup against FL DFS. **What does `appointment_expiring_soon` mean?** It is `true` when at least one active appointment expires within 60 days of the run date. Build a scheduled actor run to sweep your producer book weekly and alert on any `true` values. **How fresh is the data?** Search mode hits the live FL DFS portal on every run — data is as current as FL DFS's own system. Bulk files are refreshed by the state typically once per day. # Actor input Schema ## `mode` (type: `string`): search = look up by name or license number (returns individual records). bulk = download a full statewide CSV dataset (hundreds of thousands of records). ## `lastName` (type: `string`): Individual last name to search. Minimum 3 characters. Partial matches are supported. Leave blank if searching by license number. ## `firstName` (type: `string`): Optional. Filters results to matching first name. Leave blank to return all matching last names. ## `firmName` (type: `string`): Optional. Search by agency or firm name instead of (or in addition to) a personal name. ## `licenseNumber` (type: `string`): Optional. Up to 7 characters. If provided, bypasses name search and does a direct lookup. ## `npnNumber` (type: `string`): Optional. National Producer Number. Numeric, up to 9 digits. ## `emailAddress` (type: `string`): Optional. Search by the email address on file with FL DFS. Useful for matching producers from a CRM. Partial matches supported (begins-with). ## `licenseStatus` (type: `string`): Filter by license validity. Defaults to Valid only. ## `licenseCategory` (type: `string`): Optional. Filter by license category (e.g. Life & Annuity, Property & Casualty, Adjuster). Leave blank for all categories. ## `residentStatus` (type: `string`): Optional. Filter to Florida residents or non-residents only. ## `bulkDataset` (type: `string`): Which CSV file to download. Only used in bulk mode. Individual license files are the largest (~320 MB). Appointment files are split A-G / H-O / P-Z by last name. ## `maxResults` (type: `integer`): Maximum records to return. Search mode default: 1,000. Bulk mode default: 1,000 (safe test size). Set to 0 for unlimited — but note that bulk files can contain 350,000+ records, so only use 0 when you intend a full download. ## Actor input object example ```json { "mode": "search", "licenseStatus": "1", "licenseCategory": "", "residentStatus": "", "bulkDataset": "individual_licenses", "maxResults": 1000 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("ws_tony/florida-dfs-insurance-license").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("ws_tony/florida-dfs-insurance-license").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call ws_tony/florida-dfs-insurance-license --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ws_tony/florida-dfs-insurance-license", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Florida DFS Insurance License Scraper", "description": "Search Florida DFS insurance license records by name or license number, or bulk-download the full statewide dataset. No proxy needed.", "version": "0.1", "x-build-id": "3x3WnTQi9cx4J29aK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ws_tony~florida-dfs-insurance-license/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ws_tony-florida-dfs-insurance-license", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ws_tony~florida-dfs-insurance-license/runs": { "post": { "operationId": "runs-sync-ws_tony-florida-dfs-insurance-license", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ws_tony~florida-dfs-insurance-license/run-sync": { "post": { "operationId": "run-sync-ws_tony-florida-dfs-insurance-license", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "search", "bulk" ], "type": "string", "description": "search = look up by name or license number (returns individual records). bulk = download a full statewide CSV dataset (hundreds of thousands of records).", "default": "search" }, "lastName": { "title": "Last Name", "type": "string", "description": "Individual last name to search. Minimum 3 characters. Partial matches are supported. Leave blank if searching by license number." }, "firstName": { "title": "First Name", "type": "string", "description": "Optional. Filters results to matching first name. Leave blank to return all matching last names." }, "firmName": { "title": "Agency / Firm Name", "type": "string", "description": "Optional. Search by agency or firm name instead of (or in addition to) a personal name." }, "licenseNumber": { "title": "FL License Number", "type": "string", "description": "Optional. Up to 7 characters. If provided, bypasses name search and does a direct lookup." }, "npnNumber": { "title": "NPN Number", "type": "string", "description": "Optional. National Producer Number. Numeric, up to 9 digits." }, "emailAddress": { "title": "Email Address", "type": "string", "description": "Optional. Search by the email address on file with FL DFS. Useful for matching producers from a CRM. Partial matches supported (begins-with)." }, "licenseStatus": { "title": "License Status", "enum": [ "1", "2", "3" ], "type": "string", "description": "Filter by license validity. Defaults to Valid only.", "default": "1" }, "licenseCategory": { "title": "License Category", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "50" ], "type": "string", "description": "Optional. Filter by license category (e.g. Life & Annuity, Property & Casualty, Adjuster). Leave blank for all categories.", "default": "" }, "residentStatus": { "title": "Resident Status", "enum": [ "", "1", "0" ], "type": "string", "description": "Optional. Filter to Florida residents or non-residents only.", "default": "" }, "bulkDataset": { "title": "Bulk Dataset", "enum": [ "individual_licenses", "business_licenses", "ce_required", "appointments_individual_ag", "appointments_individual_ho", "appointments_individual_pz", "appointments_business", "county_appointments", "exchange_registrations" ], "type": "string", "description": "Which CSV file to download. Only used in bulk mode. Individual license files are the largest (~320 MB). Appointment files are split A-G / H-O / P-Z by last name.", "default": "individual_licenses" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum records to return. Search mode default: 1,000. Bulk mode default: 1,000 (safe test size). Set to 0 for unlimited — but note that bulk files can contain 350,000+ records, so only use 0 when you intend a full download.", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```