{ "openapi": "3.0.1", "info": { "title": "Iowa Business Entity Search — Active LLCs & Corporations", "description": "Every active Iowa LLC, corporation, partnership and non-profit from the Secretary of State's official file: name, corp number, type, effective date, home office. New-business feed and lookup. Part of NexGen Signal — official-source data products", "version": "0.1", "x-build-id": "VGE2io69lWcAvdKdu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgensignal~iowa-business-entity-records/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgensignal-iowa-business-entity-records", "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/nexgensignal~iowa-business-entity-records/runs": { "post": { "operationId": "runs-sync-nexgensignal-iowa-business-entity-records", "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/nexgensignal~iowa-business-entity-records/run-sync": { "post": { "operationId": "run-sync-nexgensignal-iowa-business-entity-records", "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": { "newWithinDays": { "title": "New in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only entities whose effective date falls in the last N days — the new-business feed. Leave empty for all active entities." }, "effectiveFrom": { "title": "Effective from", "type": "string", "description": "Optional. Only entities effective on or after this date (YYYY-MM-DD)." }, "effectiveTo": { "title": "Effective to", "type": "string", "description": "Optional. Only entities effective on or before this date (YYYY-MM-DD)." }, "corporationTypes": { "title": "Entity types", "type": "array", "description": "Only these entity types, e.g. DOMESTIC LIMITED LIABILITY COMPANY. Leave empty for all.", "items": { "type": "string", "enum": [ "DOMESTIC LIMITED LIABILITY COMPANY", "DOMESTIC PROFIT", "REVISED DOMESTIC NON-PROFIT", "FOREIGN LIMITED LIABILITY COMPANY", "FOREIGN PROFIT", "DOMESTIC LIMITED LIABILITY PARTNERSHIP", "DOMESTIC PROFESSIONAL LIMITED LIABILITY COMPANY", "DOMESTIC PROFESSIONAL", "REVISED FOREIGN NON-PROFIT", "DOMESTIC LIMITED PARTNERSHIP", "MULTIPLE HOUSING ACT", "FOREIGN PROFESSIONAL", "FOREIGN LIMITED PARTNERSHIP", "DOMESTIC LIMITED LIABILITY LIMITED PARTNERSHIP", "FOREIGN PROFESSIONAL LIMITED LIABILITY COMPANY", "DOMESTIC BANKS", "FOREIGN LIMITED LIABILITY PARTNERSHIP", "REVISED UNIFORM UNINCORPORATED NON-PROFIT ASSOCIATION", "CO-OP NON STOCK", "CO-OP STOCK", "INSURANCE COMPANIES", "GENERAL PARTNERSHIP", "DOMESTIC COOPERATIVE", "FOREIGN LIMITED LIABILITY LIMITED PARTNERSHIP", "DOMESTIC SAVINGS & LOAN", "CO-OP STOCK VALUE ADDED" ] }, "default": [] }, "cities": { "title": "Home-office cities", "type": "array", "description": "Only entities whose home office is in these cities, e.g. DES MOINES, CEDAR RAPIDS.", "default": [], "items": { "type": "string" } }, "zipPrefixes": { "title": "Home-office ZIP prefixes", "type": "array", "description": "Only home-office ZIP codes starting with these digits, e.g. 503 (Des Moines area) or 52401.", "default": [], "items": { "type": "string" } }, "homeOfficeStates": { "title": "Home-office states", "type": "array", "description": "Only home offices in these states, e.g. IA, or NE for Nebraska-based companies registered in Iowa.", "default": [], "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "string", "description": "Only entities whose legal name contains this text (not case-sensitive), e.g. ROOFING." }, "corpNumbers": { "title": "Corp numbers to check", "type": "array", "description": "Look up specific Iowa corp numbers (up to 20,000). Numbers not in the active file are listed in the run receipt — that means the entity is not currently active or does not exist.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Order", "enum": [ "newest", "oldest", "file" ], "type": "string", "description": "Which matching records come first when more match than your maximum.", "default": "newest" }, "maxRecords": { "title": "Maximum records", "minimum": 1, "maximum": 400000, "type": "integer", "description": "Maximum records delivered and billed in this run. The whole active file is about 345,000 entities.", "default": 500 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }