> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Wyoming (US)

> Country-specific identifiers, data sources, and implementation details

## Start here

This guide contains public integration notes for Wyoming. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

<Card title="Wyoming coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-wy">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Warning>
  This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
</Warning>

<Note>
  Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
  * [Company Status](#company-status)
  * [Legal Forms](#legal-forms)
  * [Legal Representatives](#legal-representatives)
  * [Other Key Persons](#other-key-persons)
* [Data Availability](#data-availability)
* [Documents](#documents)
* [Example API Responses](#example-api-responses)

## Data Sources

All entity data comes from the **Wyoming Secretary of State** business register, the official **WyoBiz** filing and search system ([wyobiz.wyo.gov](https://wyobiz.wyo.gov)) for the \~200,000+ business entities registered in Wyoming.

Wyoming supports two modes on a single data block:

* **Onboarding** (`mode: "onboarding"`, fast, non-authoritative). Returns a quick summary built from the register's public search index: legal name, Filing ID, legal form, and status. It does not include addresses, registration date, officers, or the registered agent. Use it for fast identity resolution during onboarding flows.

* **Verification** (`mode: "verification"`, the default, authoritative). Returns the full register record read live from the entity's WyoBiz detail page: everything in the onboarding summary plus the registered/principal-office address, the registration date, directors and officers, and the registered agent. Use it when you need the complete, authoritative profile.

<Note>
  **Mode-based routing.** Onboarding requests are served fast from the register's
  public search index and return a non-authoritative summary. Verification requests
  read the live register detail page and return the full authoritative record,
  including address, directors and officers, and the registered agent.
</Note>

## Company Identifiers

### Query Identifiers

| Identifier Type | Format           | Example          | Notes                                                                   |
| --------------- | ---------------- | ---------------- | ----------------------------------------------------------------------- |
| **Filing ID**   | `YYYY-NNNNNNNNN` | `2004-000464709` | Wyoming Secretary of State primary identifier (year + 9-digit sequence) |

<Tip>
  The Filing ID is the only identifier supported for company retrieval. To find
  a Filing ID from a name, use the search endpoint first.
</Tip>

<Note>
  The `YYYY` prefix of the Filing ID is the year the entity registered with the
  Wyoming Secretary of State (the qualification year for foreign entities), not
  the entity's incorporation date. It is year-granularity only, so do not treat
  it as `registrationDate`. The registration date is returned as a separate field
  in verification mode.
</Note>

### Identifiers in API Response

| Identifier | Format           | Example          | Found In     |
| ---------- | ---------------- | ---------------- | ------------ |
| `filingId` | `YYYY-NNNNNNNNN` | `2004-000464709` | All entities |

## Search Capabilities

| Search Type  | Pattern          | Example                 | Match Type  | Expected Results                                                     |
| ------------ | ---------------- | ----------------------- | ----------- | -------------------------------------------------------------------- |
| By Name      | 2-200 chars      | `"Wyoming Energy Corp"` | Starts with | Multiple results                                                     |
| By Filing ID | `YYYY-NNNNNNNNN` | `2004-000464709`        | Exact       | Exact match returned first (matchType: id); other results may follow |

<Note>
  Name search matches from the beginning of the entity name (starts-with). For
  broader matches, use shorter prefixes.
</Note>

## Quirks & Gotchas

| Quirk                                  | Details                                                                                                                                                                |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wyoming is a privacy state**         | Wyoming does not require LLCs to disclose members or managers in public filings. Only the organizer who filed the articles appears on the entity record.               |
| **No shareholder or UBO register**     | Wyoming does not publish shareholders or beneficial owners for any entity type. The federal CTA/FinCEN is a separate system.                                           |
| **No activity codes**                  | The Wyoming Secretary of State does not collect NAICS or industry classification codes.                                                                                |
| **Registered agent standing**          | Wyoming tracks three separate standings: Tax, Registered Agent (RA), and Other. All three must be "Good" for a Certificate of Good Standing to be issued.              |
| **Officers require verification mode** | Directors, officers, and the registered agent come from the entity's register detail page. They are returned in verification mode only, not in the onboarding summary. |
| **Dual role labels**                   | Corporate officers may hold combined roles (e.g. "President / Director"). These are mapped to the primary role.                                                        |
| **Trade names and trademarks**         | Trade Name and Trademark registrations appear in WyoBiz as entity types but are not legal entities. They are mapped with standardized form `Other`.                    |

## Mappings

### Company Status

Status comes from the WyoBiz entity status field. "Active" is the only in-good-standing state. All other statuses begin with "Inactive -" followed by a specific reason. The response includes `statusDetails` with structured fields: `status`, `closureReason`, `closureDate`, and `additionalInfo`.

| Source Value                                                  | Active  | closureReason           |
| ------------------------------------------------------------- | ------- | ----------------------- |
| `Active`                                                      | `true`  | —                       |
| `Inactive - Dissolved`                                        | `false` | `VOLUNTARY_DISSOLUTION` |
| `Inactive - Administratively Dissolved (Tax)`                 | `false` | `STRUCK_OFF`            |
| `Inactive - Administratively Dissolved or Revoked (Tax)`      | `false` | `STRUCK_OFF`            |
| `Inactive - Administratively Dissolved or Revoked (No Agent)` | `false` | `STRUCK_OFF`            |
| `Inactive - Administratively Dissolved or Revoked (Other)`    | `false` | `STRUCK_OFF`            |
| `Inactive - Revoked (Tax)`                                    | `false` | `STRUCK_OFF`            |
| `Inactive - Cancelled`                                        | `false` | `OTHER`                 |
| `Inactive - Expired`                                          | `false` | `OTHER`                 |
| `Inactive - Withdraw/Dissolve/Cancel`                         | `false` | `OTHER`                 |
| `Inactive - Merged`                                           | `false` | `MERGER`                |
| `Inactive - Withdrawal`                                       | `false` | `OTHER`                 |

The Sub Status field ("Current" or "Archived") from WyoBiz further qualifies inactive entities. "Current" means the entity has a 2-year reinstatement window; "Archived" means it can no longer reinstate.

### Legal Forms

Legal form is derived from the WyoBiz Filing Details `Type` field. Wyoming distinguishes between domestic and foreign variants of each entity structure.

<AccordionGroup>
  <Accordion title="Full legal form mapping">
    | WyoBiz Type                                         | Standardized            | ELF Code |
    | --------------------------------------------------- | ----------------------- | -------- |
    | Limited Liability Company (Domestic)                | LimitedLiabilityCompany | `NB58`   |
    | Limited Liability Company (Foreign)                 | LimitedLiabilityCompany | `NB58`   |
    | Profit Corporation (Domestic)                       | Corporation             | `9GXA`   |
    | Profit Corporation (Foreign)                        | Corporation             | `9GXA`   |
    | Nonprofit Corporation (Domestic)                    | NonprofitOrganization   | `PUJR`   |
    | Nonprofit Corporation (Foreign)                     | NonprofitOrganization   | `PUJR`   |
    | Limited Partnership (Domestic)                      | Partnership             | `QR4Y`   |
    | Limited Partnership (Foreign)                       | Partnership             | `QR4Y`   |
    | Registered Limited Liability Partnership (Domestic) | Partnership             | `71ZI`   |
    | Registered Limited Liability Partnership (Foreign)  | Partnership             | `71ZI`   |
    | Statutory Trust (Domestic)                          | Trust                   | `RDQZ`   |
    | Statutory Trust (Foreign)                           | Trust                   | `RDQZ`   |
    | Statutory Foundation (Domestic)                     | Foundation              | `1YA4`   |
    | Statutory Foundation (Foreign)                      | Foundation              | `1YA4`   |
    | Statutory Close Corporation (Domestic)              | Corporation             | `9GXA`   |
    | Trade Name                                          | Other                   | —        |
    | Trademark                                           | Other                   | —        |
  </Accordion>
</AccordionGroup>

### Legal Representatives

Wyoming discloses named officers and parties on the Filing Details page. The available roles depend on entity type.

| Role                 | Entity Types         | Standardized    |
| -------------------- | -------------------- | --------------- |
| Director             | Corporations         | Director        |
| President            | Corporations         | President       |
| President / Director | Corporations         | President       |
| Vice President       | Corporations         | Vice President  |
| Secretary            | Corporations         | Secretary       |
| Secretary / Director | Corporations         | Secretary       |
| Treasurer            | Corporations         | Treasurer       |
| Treasurer / Director | Corporations         | Treasurer       |
| Incorporator         | Corporations         | Other           |
| Organizer            | LLCs                 | Other           |
| Manager              | Manager-managed LLCs | Manager         |
| General Partner      | Limited Partnerships | General Partner |
| Limited Partner      | Limited Partnerships | Limited Partner |
| Partner              | Registered LLPs      | Partner         |
| Trustee              | Statutory Trusts     | Other           |

<Note>
  Wyoming LLCs do not disclose members in public filings. Only the organizer
  (who filed the articles of organization) and managers (if manager-managed)
  appear on the public record.
</Note>

### Other Key Persons

| Role             | Standardized     | Notes                                                           |
| ---------------- | ---------------- | --------------------------------------------------------------- |
| Registered Agent | Registered Agent | Statutory service-of-process contact, required for all entities |

## Data Availability

Availability depends on the mode. Onboarding returns a fast summary from the register's search index; verification returns the full authoritative record from the entity's register page.

| Data Point             | Onboarding | Verification | Notes                                                                             |
| ---------------------- | ---------- | ------------ | --------------------------------------------------------------------------------- |
| Company name           | Yes        | Yes          | Current legal name                                                                |
| Filing ID              | Yes        | Yes          | Canonical identifier                                                              |
| Legal form             | Yes        | Yes          | Full type with domestic/foreign distinction and ISO 20275 mapping                 |
| Company status         | Yes        | Yes          | Active or Inactive with specific reason                                           |
| Registration date      | No         | Yes          | Initial filing date                                                               |
| Legal address          | No         | Yes          | Principal office address                                                          |
| Mailing address        | No         | Yes          | Separate mailing address if different from principal office                       |
| Fictitious name        | No         | Yes          | If registered alongside the entity                                                |
| Standings              | No         | Yes          | Tax, Registered Agent, and Other standings                                        |
| Legal representatives  | No         | Yes\*        | Depends on entity type — corporations have officers; LLCs may only show organizer |
| Registered agent       | No         | Yes          | Name and address returned as Other Key Person                                     |
| Share capital          | No         | Yes\*        | Common and preferred shares with par value (corporations only)                    |
| Formation jurisdiction | No         | Yes          | State or country of formation for foreign entities                                |
| Activity codes         | No         | No           | Not collected by the Wyoming Secretary of State                                   |
| Shareholders           | No         | No           | Not published by Wyoming at the state level                                       |
| UBOs                   | No         | No           | No state-level beneficial-ownership register; federal FinCEN is a separate system |
| Financial data         | No         | No           | Not collected                                                                     |

## Documents

### Available Documents

| Document                         | Availability                                                  | Format |
| -------------------------------- | ------------------------------------------------------------- | ------ |
| **Trade Register Extract**       | Always available                                              | PDF    |
| **Certificate of Good Standing** | Conditional — entity must be Active with all standings "Good" | PDF    |

<Info>
  Both documents are included at no extra charge with the company data block. The
  Trade Register Extract is a printed PDF of the entity's register detail page. The
  Certificate of Good Standing is issued electronically by the Wyoming Secretary of
  State and confirms the entity is in compliance with all state requirements (tax,
  registered agent, other); it is available only for entities that are Active with
  all three standings "Good".
</Info>

## Example API Responses

### Search by Name

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-WY&query=ACME+ENERGY+CORP" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "2004-000464709",
    "legalName": "Wyoming Energy Corporation",
    "countryCode": "US-WY",
    "matchReason": {
      "matchType": "default"
    }
  }
]
```

### Search by Filing ID

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-WY&query=2004-000464709" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "2004-000464709",
    "legalName": "Wyoming Energy Corporation",
    "countryCode": "US-WY",
    "matchReason": {
      "matchType": "id",
      "identifier": { "filingId": "2004-000464709" }
    }
  }
]
```

### Company Profile (Onboarding)

Onboarding mode returns a fast, non-authoritative summary from the register's public search index: legal name, Filing ID, legal form, and status.

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-WY", "id": "2004-000464709", "dataPoints": ["company"], "mode": "onboarding"}'
```

```json theme={null}
{
  "id": "2004-000464709",
  "countryCode": "US-WY",
  "identifiers": { "filingId": "2004-000464709" },
  "legalName": "Wyoming Energy Corporation",
  "status": {
    "localName": "Active",
    "active": true,
    "statusDetails": { "status": "ACTIVE" }
  },
  "legalForm": {
    "localName": "Profit Corporation (Domestic)",
    "englishTranslation": "Profit Corporation",
    "standardized": "Corporation",
    "iso20275Code": "9GXA"
  }
}
```

### Company Profile (Verification)

Verification mode reads the live register detail page and returns the full authoritative record: everything in the onboarding summary plus the registration date, the principal-office address, directors and officers, and the registered agent.

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-WY", "id": "2004-000464709", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"], "mode": "verification"}'
```

```json theme={null}
{
  "company": {
    "id": "2004-000464709",
    "countryCode": "US-WY",
    "identifiers": { "filingId": "2004-000464709" },
    "legalName": "Wyoming Energy Corporation",
    "registrationDate": "2004-04-12",
    "status": {
      "localName": "Active",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Profit Corporation (Domestic)",
      "englishTranslation": "Profit Corporation",
      "standardized": "Corporation",
      "iso20275Code": "9GXA"
    },
    "legalAddress": {
      "addressLine1": "Northwest 69th Street",
      "city": "Boca Raton",
      "postalCode": "33487",
      "region": "Palm Beach County",
      "state": "Florida",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": {
        "localName": "President / Director",
        "standardized": "President"
      },
      "individual": {
        "name": { "fullName": "Blair Merriam" }
      }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "company",
      "role": {
        "localName": "Registered Agent",
        "standardized": "Registered Agent"
      },
      "company": {
        "countryCode": "US",
        "legalName": "InCorp Services, Inc.",
        "legalAddress": {
          "addressLine1": "Thomes Avenue",
          "city": "Cheyenne",
          "postalCode": "82002",
          "region": "Laramie County",
          "state": "Wyoming",
          "countryCode": "US"
        }
      }
    }
  ]
}
```

### Available Documents

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-WY", "id": "2004-000464709", "dataPoints": ["availableDocuments"]}'
```

```json theme={null}
{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_tre_123",
      "name": "Trade Register Extract",
      "format": "pdf"
    },
    "certificateOfGoodStanding": {
      "id": "doc_cogs_456",
      "name": "Certificate of Good Standing",
      "format": "pdf"
    }
  }
}
```
