> ## 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.

# Oregon (US)

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

## Start here

This guide contains public integration notes for Oregon. 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="Oregon coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-or">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<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)
  * [Officer Roles](#officer-roles)
  * [Other Key Persons](#other-key-persons)
* [Data Availability](#data-availability)
* [Documents](#documents)
* [Example API Responses](#example-api-responses)

## Data Sources

Oregon entity data comes from the **Oregon Secretary of State Business Registry**, which publishes two complementary public surfaces:

* **Active Businesses snapshot** (fast, onboarding). A weekly refresh of every active Oregon entity, published by the Oregon Secretary of State as the "Active Businesses - ALL" open dataset on `data.oregon.gov`. Covers about 520,000 active entities. Used for onboarding checks and name/identifier search.
* **Oregon Business Registry profile page** (live, verification). The authoritative entity detail page rendered by the Secretary of State at `egov.sos.state.or.us/br/`. Returns the live company profile including officers, members, registered agent, name history, and current status. Used for verification requests and to cover inactive entities (which are absent from the open dataset).

<Note>
  **Mode-based routing.** Onboarding requests (`mode: "onboarding"`) are served from the open-data snapshot for sub-second response times. Verification requests fall through to the live profile page, which carries inactive entities and the full officer roster. Both modes are priced together as a single block.
</Note>

## Company Identifiers

### Query Identifiers

| Identifier Type     | Format                              | Example     | Notes                                                         |
| ------------------- | ----------------------------------- | ----------- | ------------------------------------------------------------- |
| **Registry Number** | 3-9 digits, optional 2-digit suffix | `087399-14` | Primary identifier assigned by the Oregon Secretary of State. |

<Tip>
  Oregon displays Registry Numbers in two equivalent shapes. The public profile
  page renders them with a hyphenated filing-type suffix (`087399-14`, where the
  prefix is padded to at least six digits for entities registered after 1970).
  The open dataset stores them digits-only (`8739914`). Either form is accepted
  on input; responses always return the dashed display form.
</Tip>

### Identifiers in API Response

| Identifier       | Format                              | Example     | Found In     |
| ---------------- | ----------------------------------- | ----------- | ------------ |
| `registryNumber` | 3-9 digits, optional 2-digit suffix | `087399-14` | All entities |

## Search Capabilities

| Search Type        | Pattern                           | Example     | Match Type | Expected Results                                                     |
| ------------------ | --------------------------------- | ----------- | ---------- | -------------------------------------------------------------------- |
| By Name            | 2-200 chars                       | `"Nike"`    | Contains   | Multiple results                                                     |
| By Registry Number | 3-9 digits, optional `-NN` suffix | `087399-14` | Exact      | Exact match returned first (matchType: id); other results may follow |

<Note>
  Name search runs against the active-entity snapshot for sub-second response,
  and in parallel against the live registry. Inactive entities are returned by
  the live registry path only.
</Note>

## Quirks & Gotchas

| Quirk                            | Details                                                                                                                                                                                                                            |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Registry Number padding**      | Oregon pads the prefix to at least six digits for entities registered after 1970. Pre-1970 entities (Registry Numbers issued before the suffix convention) are short digit-only numbers, e.g. `414` (Lewis & Clark College, 1867). |
| **Active-only snapshot**         | The open dataset covers active entities only. Inactive entities (dissolved, withdrawn, cancelled) resolve through the live registry path.                                                                                          |
| **Associated-name rows**         | Each entity emits up to four rows in the snapshot, one per associated-name type (Registered Agent, Principal Place of Business, Mailing Address, Authorized Representative). Topograph folds them into one company per entity.     |
| **Snapshot refresh cadence**     | The "Active Businesses - ALL" dataset is refreshed weekly, typically Monday around 14:00 UTC. Brand-new filings may be a few days behind in onboarding mode; verification mode reads the live registry.                            |
| **Activity codes not published** | Oregon does not publish industry classification codes on the public business registry.                                                                                                                                             |

## Mappings

### Company Status

Status comes from the Oregon SoS entity status field on the detail page.

| Source Value      | Active  | Notes                                            |
| ----------------- | ------- | ------------------------------------------------ |
| `ACT` / Active    | `true`  | Entity is in good standing.                      |
| `INA` / Inactive  | `false` | Catch-all inactive state (cancelled, dissolved). |
| `WDR` / Withdrew  | `false` | Foreign entity withdrew its Oregon registration. |
| `EXP` / Expired   | `false` | Registration lapsed.                             |
| `DIS` / Dissolved | `false` | Voluntary or administrative dissolution.         |

### Legal Forms

Legal form is derived from the Entity Type field. Domestic types cover entities formed under Oregon law; Foreign types cover entities formed elsewhere and registered to do business in Oregon. ISO 20275 ELF codes are assigned to domestic Oregon types from the GLEIF ELF Code List; foreign variants carry no ELF code because the code belongs to the jurisdiction of formation.

<AccordionGroup>
  <Accordion title="Full legal form mapping">
    | Entity Type                                     | Standardized            | ELF Code |
    | ----------------------------------------------- | ----------------------- | -------- |
    | Domestic Business Corporation                   | Corporation             | `C3JQ`   |
    | Foreign Business Corporation                    | Corporation             | —        |
    | Domestic Professional Corporation               | Corporation             | —        |
    | Foreign Professional Corporation                | Corporation             | —        |
    | Domestic Limited Liability Company              | LimitedLiabilityCompany | `JY0X`   |
    | Foreign Limited Liability Company               | LimitedLiabilityCompany | —        |
    | Domestic Professional Limited Liability Company | LimitedLiabilityCompany | —        |
    | Foreign Professional Limited Liability Company  | LimitedLiabilityCompany | —        |
    | Domestic Limited Partnership                    | Partnership             | `T91T`   |
    | Foreign Limited Partnership                     | Partnership             | —        |
    | Domestic Limited Liability Partnership          | Partnership             | —        |
    | Foreign Limited Liability Partnership           | Partnership             | —        |
    | Domestic Nonprofit Corporation                  | NonprofitOrganization   | `4RCO`   |
    | Foreign Nonprofit Corporation                   | NonprofitOrganization   | —        |
    | Domestic Cooperative                            | Cooperative             | —        |
    | Assumed Business Name                           | Other                   | —        |
  </Accordion>
</AccordionGroup>

### Officer Roles

Officer titles surface on the live profile page using three-letter Oregon filing-form codes. Topograph maps them to standardized roles.

| Source Code | Local Name      | Standardized   |
| ----------- | --------------- | -------------- |
| `PRE`       | President       | President      |
| `VPR`       | Vice President  | VicePresident  |
| `SEC`       | Secretary       | Secretary      |
| `TRE`       | Treasurer       | Treasurer      |
| `DIR`       | Director        | Director       |
| `MGR`       | Manager         | Manager        |
| `PAR`       | Partner         | Partner        |
| `GPA`       | General Partner | GeneralPartner |
| `MEM`       | Member          | Other          |
| `INC`       | Incorporator    | Other          |

<Note>
  LLC members and corporate incorporators are surfaced with their literal local
  name (`Member`, `Incorporator`) but standardized to `Other`. They are not
  promoted to `Manager` or `Director` because those roles carry signing-authority
  semantics that members and incorporators do not necessarily hold.
</Note>

### Other Key Persons

| Role             | Standardized       | Notes                                                                  |
| ---------------- | ------------------ | ---------------------------------------------------------------------- |
| Registered Agent | `Registered Agent` | Statutory service-of-process contact. Returned as an `otherKeyPerson`. |

## Data Availability

| Data Point            | Available | Notes                                                                                 |
| --------------------- | --------- | ------------------------------------------------------------------------------------- |
| Company name          | Yes       | Current legal name from the entity detail page.                                       |
| Company status        | Yes       | Active/inactive with detailed status code.                                            |
| Registration date     | Yes       | Initial filing date with the Oregon Secretary of State.                               |
| Legal address         | Yes       | Principal place of business; falls back to mailing address when not separately filed. |
| Mailing address       | Yes       | Returned when distinct from the principal place of business.                          |
| Legal form            | Yes       | Entity type with domestic/foreign distinction.                                        |
| Jurisdiction          | Yes       | State or country of formation for foreign entities.                                   |
| Registered agent      | Yes       | Returned as an `otherKeyPerson`.                                                      |
| Officers and managers | Yes       | Returned in verification mode (`legalRepresentatives`).                               |
| Name history          | Yes       | Prior legal names with transaction date.                                              |
| Activity codes        | No        | Not published by the Oregon Secretary of State.                                       |
| Shareholders          | No        | Not collected by the Oregon business registry.                                        |
| UBOs                  | No        | No state-level beneficial-ownership register.                                         |

## Documents

### Available Documents

| Document                   | Availability     | Format |
| -------------------------- | ---------------- | ------ |
| **Trade Register Extract** | Always available | PDF    |

<Info>
  The Trade Register Extract is a printed capture of the Oregon SoS entity
  detail page. It is included with the company data block at no extra charge.
</Info>

## Example API Responses

### Search by Name

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

```json theme={null}
[
  {
    "id": "087399-14",
    "legalName": "NIKE, INC.",
    "countryCode": "US-OR",
    "matchReason": { "matchType": "default" }
  },
  {
    "id": "1496294-95",
    "legalName": "NIKE ALPHA FORCE LLC",
    "countryCode": "US-OR",
    "matchReason": { "matchType": "default" }
  }
]
```

### Search by Registry Number

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

```json theme={null}
[
  {
    "id": "087399-14",
    "legalName": "NIKE, INC.",
    "countryCode": "US-OR",
    "matchReason": {
      "matchType": "id",
      "identifier": { "registryNumber": "087399-14" }
    }
  }
]
```

### Company Profile

```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-OR", "id": "1496294-95", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"]}'
```

<AccordionGroup>
  <Accordion title="Foreign LLC with registered agent and member">
    ```json theme={null}
    {
      "company": {
        "id": "1496294-95",
        "countryCode": "US-OR",
        "identifiers": { "registryNumber": "1496294-95" },
        "legalName": "NIKE ALPHA FORCE LLC",
        "registrationDate": "2018-11-16",
        "status": { "localName": "Active", "active": true },
        "legalForm": {
          "localName": "Foreign Limited Liability Company",
          "englishTranslation": "Foreign Limited Liability Company",
          "standardized": "LimitedLiabilityCompany"
        },
        "legalAddress": {
          "addressLine1": "1 Bowerman Drive",
          "city": "Beaverton",
          "postalCode": "97005",
          "region": "OR",
          "countryCode": "US"
        }
      },
      "otherKeyPersons": [
        {
          "type": "company",
          "role": {
            "localName": "Registered Agent",
            "standardized": "Registered Agent"
          },
          "company": { "legalName": "UNITED AGENT GROUP INC." }
        }
      ],
      "legalRepresentatives": [
        {
          "type": "company",
          "role": { "localName": "Member", "standardized": "Other" },
          "company": { "legalName": "NIKE HOLDING, LLC" }
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### 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-OR", "id": "1496294-95", "dataPoints": ["availableDocuments"]}'
```

```json theme={null}
{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_tre_or_abc123",
      "name": "Trade Register Extract",
      "format": "pdf"
    }
  }
}
```