# Wyoming SOS Business Registry — Filing & Agent Lookup (`bovi/wyoming-sos-registry`) Actor Search Wyoming Secretary of State business filings by company name or filing ID. Returns official filing status, standing, registered agent, and officer/party records from wyobiz.wyo.gov. - **URL**: https://apify.com/bovi/wyoming-sos-registry.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $7.42 / 1,000 filing records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Wyoming SOS Business Registry — Filing & Agent Lookup Search the Wyoming Secretary of State business filing registry ([wyobiz.wyo.gov](https://wyobiz.wyo.gov)) by company name or exact filing ID. Returns the official filing record: entity type, current status and standing (tax / registered agent / other), formation jurisdiction, registered-agent name and address, principal/mailing addresses, and — when on file — officer/director records. Typical use: verify a Wyoming-registered company's filing status and standing before doing business with it, find its registered agent for service of process, or build a list of active filings matching a name pattern. ### Input | Field | Type | Default | Description | |---|---|---|---| | `searchNames` | string[] | `["Grand Teton"]` | Company/entity names to search. Each name is one search. | | `searchIds` | string[] | `[]` | Exact Wyoming SOS filing IDs (format `YYYY-NNNNNNNNN`, e.g. `1980-000149890`). Faster and unambiguous — use when you already know the ID. | | `searchMode` | string | `"contains"` | `"contains"` = substring match anywhere in the name. `"startsWith"` = name must begin with the search text (fewer false positives). | | `maxResultsPerSearch` | integer | `20` | Cap on matching filings returned per search term (a broad name can match hundreds of filings). | | `fetchDetails` | boolean | `true` | Fetch each match's detail page for registered agent, addresses, and officers. If `false`, only the search-result summary fields are returned (one fewer request per filing). | | `maxItems` | integer | `100` | Overall cap across all searches combined. `0` = unlimited. | | `proxyConfiguration` | object | Apify Proxy, RESIDENTIAL, US | Standard Apify Proxy input. The actor works out of the box — no proxy key or credentials of your own are required. | At least one of `searchNames` / `searchIds` must be non-empty. ### Output fields One record per matched filing. Fields marked "detail" only populate when `fetchDetails` is `true` (default) and the detail-page fetch succeeds. | Field | Source | Description | |---|---|---| | `search_query` | input | The name/ID that produced this record | | `search_type` | input | `name` or `filingId` | | `filing_id` | search+detail | Wyoming SOS filing ID | | `entity_name` | search | Official registered filing name | | `entity_type_code` | search | Short type code (CORP, LLC, LP, LLP, TN, TM, …) | | `filing_type_full` | detail | Full type description (e.g. "Limited Liability Company - Foreign") | | `sub_type` | detail | Filing sub-type, when declared | | `status` | search+detail | Current filing status (Active, Inactive - Withdrawal, …) | | `sub_status` | detail | Current / Archived | | `standing_tax` | search+detail | Annual license tax standing (Good/Delinquent) | | `standing_ra` | search+detail | Registered-agent-on-file standing (Good/Delinquent) | | `standing_other` | detail | Any other administrative-action standing | | `initial_filing_date` | search+detail | Original filing date | | `effective_date` | detail | Effective date, if different from filing date | | `inactive_date` | detail | Date the entity became inactive, if applicable | | `duration` | detail | Term of duration, if not perpetual | | `formed_in` | detail | Jurisdiction of formation (Wyoming for domestic entities) | | `fictitious_name` | detail | DBA name on file, if any | | `principal_office_address` | detail | Principal office address | | `mailing_address` | detail | Mailing address | | `registered_agent_name` | detail | Registered agent name — see PII note below | | `registered_agent_address` | detail | Registered agent address | | `officers` | detail | Array of `{name, title, address}` — see coverage note below | | `officer_count` | detail | Number of officer records found | | `latest_ar_number_year` | detail | Latest annual report number / year | | `ar_exempt` | detail | Annual-report exemption flag | | `license_tax_paid` | detail | Most recent license tax amount paid | | `filing_detail_url` | derived | Direct link to the filing's page on wyobiz.wyo.gov | | `efnum` | search | Internal registry token for the filing (opaque, used to build `filing_detail_url`) | | `parse_confidence` | derived | `high` / `medium` / `low` — see below | `parse_confidence` is `high` when the core search fields (name, filing ID) are present and the detail page enriched the record with a registered agent; `medium` when core fields are present but detail enrichment is missing or thin (e.g. `fetchDetails: false`); `low` if even the core search-row fields are missing (an unrecognized page shape). ### PII disclosure The **registered agent** field is a mandatory public disclosure under Wyoming law for every business entity on file — it exists precisely so the public and courts can identify who to contact or serve process on. For filings that use a **registered-agent service company**, this field is a business name. For filings where the owner serves as their **own** registered agent, this field is a **natural person's name and address** — the same public-disclosure pattern already present on this fleet's `cslb-contractor-licenses` actor (US state licensing-board registries). This is standard, already-public US Secretary-of-State data, not personal data collected from a private source. **Officer/director records** (`officers`), when present, are also standard public SOS filings for domestic corporations. **Wyoming does not require LLC member or manager disclosure** (a well-known reason Wyoming is popular for privacy-conscious LLC formation) — so `officers` is structurally **empty for the large majority of LLC filings**, and populated mainly for domestic corporations. This is a registry-structure fact, not a parser gap: don't expect `officer_count > 0` on an LLC record even when the detail fetch succeeds cleanly. ### Charge event This actor bills per matched filing record delivered: - **`filing-record`** — charged once per record pushed to the dataset (whether or not `officers` populated for that record — the registered agent, status, and standing fields are the JTBD-critical payload on every record regardless of entity type). ### Notes - Search results are ordered as the registry returns them; pagination beyond the first page of a broad name search is not currently followed — narrow broad names with `searchMode: "startsWith"` or a tighter `maxResultsPerSearch` if you need a long tail. - A `filing-ID` search (`searchIds`) is exact-match and unambiguous — prefer it whenever the filing ID is already known. # Actor input Schema ## `searchNames` (type: `array`): One or more company/entity names to search on the Wyoming Secretary of State business registry (wyobiz.wyo.gov). Each name is one search — matches use the searchMode below. ## `searchIds` (type: `array`): One or more exact Wyoming SOS filing IDs to look up directly (format YYYY-NNNNNNNNN, e.g. 1980-000149890). Faster and more precise than a name search — use when you already know the filing ID. ## `searchMode` (type: `string`): How searchNames are matched against registered filing names. 'contains' = substring match anywhere in the name (broader). 'startsWith' = name must begin with the search text (narrower, fewer false positives). ## `maxResultsPerSearch` (type: `integer`): Cap on how many matching filings to return for each name/ID searched (a broad name like 'Grand Teton' can match hundreds of filings). Results are ordered as the registry returns them. ## `fetchDetails` (type: `boolean`): If true, fetch each matched filing's detail page for registered-agent name/address, principal/mailing address, and officer/party records. If false, only the search-result summary fields (status, standing, filed date) are returned, one extra request saved per filing. ## `maxItems` (type: `integer`): Overall cap on filing records returned across all searches combined. 0 = unlimited (bounded only by maxResultsPerSearch per search). ## `proxyConfiguration` (type: `object`): Proxy settings. Use Apify Proxy with the RESIDENTIAL group (country US) — required for reliable access to wyobiz.wyo.gov. ## Actor input object example ```json { "searchNames": [ "Grand Teton" ], "searchIds": [], "searchMode": "contains", "maxResultsPerSearch": 20, "fetchDetails": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ```` # Actor output Schema ## `results` (type: `string`): Dataset containing Wyoming SOS filing records (entity\_name, filing\_id, entity\_type\_code, status, standing\_tax, standing\_ra, registered\_agent\_name, registered\_agent\_address, officers, officer\_count, filing\_detail\_url, parse\_confidence). # 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 = { "searchNames": [ "Grand Teton" ], "searchIds": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/wyoming-sos-registry").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 = { "searchNames": ["Grand Teton"], "searchIds": [], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("bovi/wyoming-sos-registry").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 '{ "searchNames": [ "Grand Teton" ], "searchIds": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call bovi/wyoming-sos-registry --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/wyoming-sos-registry", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Wyoming SOS Business Registry — Filing & Agent Lookup", "description": "Search Wyoming Secretary of State business filings by company name or filing ID. Returns official filing status, standing, registered agent, and officer/party records from wyobiz.wyo.gov.", "version": "0.1", "x-build-id": "TJhCqpcRsP1qDO4rT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~wyoming-sos-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-wyoming-sos-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/bovi~wyoming-sos-registry/runs": { "post": { "operationId": "runs-sync-bovi-wyoming-sos-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/bovi~wyoming-sos-registry/run-sync": { "post": { "operationId": "run-sync-bovi-wyoming-sos-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": { "searchNames": { "title": "Company names to search", "type": "array", "description": "One or more company/entity names to search on the Wyoming Secretary of State business registry (wyobiz.wyo.gov). Each name is one search — matches use the searchMode below.", "items": { "type": "string" } }, "searchIds": { "title": "Filing IDs to search", "type": "array", "description": "One or more exact Wyoming SOS filing IDs to look up directly (format YYYY-NNNNNNNNN, e.g. 1980-000149890). Faster and more precise than a name search — use when you already know the filing ID.", "items": { "type": "string" } }, "searchMode": { "title": "Name match mode", "enum": [ "contains", "startsWith" ], "type": "string", "description": "How searchNames are matched against registered filing names. 'contains' = substring match anywhere in the name (broader). 'startsWith' = name must begin with the search text (narrower, fewer false positives).", "default": "contains" }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on how many matching filings to return for each name/ID searched (a broad name like 'Grand Teton' can match hundreds of filings). Results are ordered as the registry returns them.", "default": 20 }, "fetchDetails": { "title": "Fetch full filing detail (registered agent + officers)", "type": "boolean", "description": "If true, fetch each matched filing's detail page for registered-agent name/address, principal/mailing address, and officer/party records. If false, only the search-result summary fields (status, standing, filed date) are returned, one extra request saved per filing.", "default": true }, "maxItems": { "title": "Max total records", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Overall cap on filing records returned across all searches combined. 0 = unlimited (bounded only by maxResultsPerSearch per search).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Use Apify Proxy with the RESIDENTIAL group (country US) — required for reliable access to wyobiz.wyo.gov." } } }, "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 } } } } } } } } } } ```