{ "openapi": "3.0.1", "info": { "title": "NAIC Insurance Lookup [$0.50💰] | Producer License Data", "description": "Verify insurance producer licenses via the NAIC State Based Systems lookup. Search by NPN, name, license number or FEIN across 30+ US jurisdictions. Returns license status, types, dates, lines of authority and contact data for compliance and due diligence.", "version": "0.1", "x-build-id": "yHeXEnshGuWYHAN5H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~naic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-naic-scraper", "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/ahmed_jasarevic~naic-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-naic-scraper", "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/ahmed_jasarevic~naic-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-naic-scraper", "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", "required": [ "state" ], "properties": { "state": { "title": "State / Jurisdiction", "type": "string", "description": "Jurisdiction to search (2-letter code like \"MO\" or full name like \"Missouri\"). Only jurisdictions participating in the NAIC external lookup are supported (e.g. AL AK AZ AR CT DE DC GU HI ID IL IA KS MD MA MO MT NE NH NJ NM NC ND OK OR PR RI SC SD TN VI VT WV WI). Texas, California and New York are NOT available." }, "searchType": { "title": "Search Type", "enum": [ "individual", "business" ], "type": "string", "description": "Whether to search individual producers or business entities (companies).", "default": "individual" }, "lastName": { "title": "Last Name", "type": "string", "description": "Producer last name (individual search). Optional but recommended - searches return at most 25 records each, so narrow them down." }, "firstName": { "title": "First Name", "type": "string", "description": "Producer first name (individual search). Optional - narrows results." }, "middleName": { "title": "Middle Name", "type": "string", "description": "Producer middle name (individual search). Optional." }, "npn": { "title": "NPN (National Producer Number)", "type": "string", "description": "Most precise lookup - returns a single producer record." }, "licenseNumber": { "title": "License Number", "type": "string", "description": "State license number to narrow the search (individual or business)." }, "businessName": { "title": "Business / Company Name", "type": "string", "description": "Company name for business-entity searches (or entity name for Business Entity producer lookups)." }, "fein": { "title": "FEIN", "type": "string", "description": "Federal Employer Identification Number. Optional." }, "licenseStatus": { "title": "License Status (advanced)", "enum": [ "", "Active", "Inactive", "Expired", "Cancelled", "Revoked", "Surrendered" ], "type": "string", "description": "Optional license status filter. Values vary by state (e.g. Active). Leave empty for all." }, "licenseType": { "title": "License Type (advanced)", "type": "string", "description": "Optional license type filter exactly as named by the state (e.g. \"Insurance Producer\"). Leave empty for all." }, "residentLicense": { "title": "Resident License Only", "type": "boolean", "description": "When checked, only resident license records are returned (individual searches).", "default": false }, "autoExpand": { "title": "Auto-expand past the 25-result cap", "type": "boolean", "description": "The NAIC API returns at most 25 records per query. When enabled, broad searches that hit the cap are automatically split into A-Z sub-queries (by last/company name) and merged, so you get far more records. Ignored when you provide an explicit name/NPN/license filter.", "default": true }, "expandDepth": { "title": "Expansion Depth", "minimum": 1, "maximum": 2, "type": "integer", "description": "How deep capped sub-queries may be split further: 1 = A-Z (up to ~26 requests per capped query), 2 = AA, AB, ... (up to hundreds of requests - much slower). Only used with Auto-expand.", "default": 1 }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of records to extract (hard cap 1000). Free users are limited to 10.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy used for all requests. If you see HTTP 403 errors, switch to the Apify RESIDENTIAL proxy group here.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }