{ "openapi": "3.0.1", "info": { "title": "Oregon Business Registry - Entities, Agents & Addresses", "description": "Oregon Secretary of State business registry (public open data, 565,827 entities across 1.58M role records): every registered business with its entity type, principal place of business, mailing address, registered agent and authorized representative, and organizing jurisdiction.", "version": "0.0", "x-build-id": "EarJvLfEhKV4TEpSM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/j0401~or-business-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-j0401-or-business-registry", "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/j0401~or-business-registry/runs": { "post": { "operationId": "runs-sync-j0401-or-business-registry", "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/j0401~or-business-registry/run-sync": { "post": { "operationId": "run-sync-j0401-or-business-registry", "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": [ "rows", "aggregate" ], "type": "string", "description": "rows = role records matching your filters (default). aggregate = one count row per group (see groupBy).", "default": "rows" }, "businessName": { "title": "Business name", "type": "string", "description": "Registered business name substring, e.g. 'BREWING'. Blank = any.", "default": "" }, "registryNumber": { "title": "Registry number", "type": "string", "description": "Exact registry number, e.g. '299818'. A business has one row per party role, so a registry number returns several records (principal place of business, mailing address, registered agent, authorized representative).", "default": "" }, "entityType": { "title": "Entity type", "enum": [ "", "DOMESTIC LIMITED LIABILITY COMPANY", "ASSUMED BUSINESS NAME", "DOMESTIC BUSINESS CORPORATION", "DOMESTIC NONPROFIT CORPORATION", "FOREIGN LIMITED LIABILITY COMPANY", "FOREIGN BUSINESS CORPORATION", "DOMESTIC PROFESSIONAL CORPORATION", "FOREIGN NONPROFIT CORPORATION", "DOMESTIC LIMITED PARTNERSHIP", "FOREIGN PROFESSIONAL CORPORATION", "FOREIGN LIMITED PARTNERSHIP", "COOPERATIVE", "DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP", "FOREIGN REGISTERED LIMITED LIABILITY PARTNERSHIP", "DISTRICT IMPROVEMENT NONPROFIT", "FOREIGN BUSINESS TRUST", "DOMESTIC BUSINESS TRUST", "RESERVED NAME", "ACT OF GOVERNMENT", "DISTRICT IMPROVEMENT PROFIT", "REGISTERED NAME" ], "type": "string", "description": "The entity's type. DOMESTIC LIMITED LIABILITY COMPANY (894,925) dominates, then ASSUMED BUSINESS NAME (233,948) and DOMESTIC BUSINESS CORPORATION (138,299). Blank = any.", "default": "" }, "role": { "title": "Party role", "enum": [ "", "PRINCIPAL PLACE OF BUSINESS", "REGISTERED AGENT", "MAILING ADDRESS", "AUTHORIZED REPRESENTATIVE" ], "type": "string", "description": "Which role record to return. PRINCIPAL PLACE OF BUSINESS (560,800), REGISTERED AGENT (450,601), MAILING ADDRESS (448,925), AUTHORIZED REPRESENTATIVE (117,484). Blank = all roles.", "default": "" }, "personName": { "title": "Person / agent name", "type": "string", "description": "Name substring matched against the agent or representative's first / last name, or the organization named on the role. Combine with role=REGISTERED AGENT to search by agent. Blank = any.", "default": "" }, "city": { "title": "City", "type": "string", "description": "City substring on the role's address. Filter only - the city column is not an aggregate dimension. Blank = any.", "default": "" }, "state": { "title": "State", "type": "string", "description": "Two-letter state on the role's address. Blank = any.", "default": "" }, "jurisdiction": { "title": "Organizing jurisdiction", "type": "string", "description": "Jurisdiction the entity is organized under, an exact 2-3 letter code (117 values), e.g. 'OR' for Oregon-domiciled (1.29M rows). Blank = any.", "default": "" }, "registeredFrom": { "title": "Registered from", "type": "string", "description": "Earliest registry date, YYYY-MM-DD. Blank = any. The registry reaches back to 1850.", "default": "" }, "registeredTo": { "title": "Registered to", "type": "string", "description": "Latest registry date, YYYY-MM-DD. Blank = any.", "default": "" }, "groupBy": { "title": "Aggregate by", "enum": [ "entityType", "role", "state", "jurisdiction" ], "type": "string", "description": "Which dimension to aggregate over.", "default": "entityType" }, "maxResults": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Cap the number of records pushed in rows mode (0 = up to ~10k per run; each record is metered individually, so there is no per-run charge cap). Aggregate mode returns every group.", "default": 50 } } }, "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 } } } } } } } } } }