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

<Warning>
  This guide is outdated and will be removed on 1 November 2026. The up-to-date Oregon (US) reference is on the [Oregon (US) country page](https://www.topograph.co/countries/us-or).
</Warning>

## 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, prefill). 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 prefill 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, and current status. Used for verification requests and to cover inactive entities (which are absent from the open dataset).

<Note>
  **Mode-based routing.** Prefill requests (`mode: "prefill"`) 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. Most: 6 or 7 digits, `-` and 2 digits (`087399-14`, `1496294-95`). Some: 3-6 digits with no hyphen (`414`, `443499`) | `087399-14` | Primary identifier assigned by the Oregon Secretary of State. |

<Tip>
  Oregon displays most Registry Numbers with a hyphen before the last two digits, and the part before the hyphen is zero-padded to six digits (`087399-14`). The open dataset stores the same number as digits only, without leading zeros (`8739914`). Both forms are accepted on input.

  Responses use the hyphenated form, or plain digits for numbers under seven digits (`443499`). Some search results carry the part before the hyphen without its leading zero (`12267-11` for `012267-11`); both resolve to the same entity.
</Tip>

### Identifiers in API Response

| Identifier | Format | Example | Found In |
| - | - | - | - |
| `registryNumber` | 3-9 digits, usually with `-` before the last 2 (`087399-14`); plain digits under 7 digits (`443499`) | `087399-14` | All entities |

### Legal Entity Identifier (LEI)

GLEIF is the supplementary data source for this identifier.

`company.identifiers.lei` is returned when a company identifier has a unique match against this jurisdiction's registration or validation references in GLEIF.

An [LEI (Legal Entity Identifier)](https://www.gleif.org/en/about-lei/introducing-the-legal-entity-identifier-lei) has 20 uppercase letters and digits, ending in two check digits.

Coverage varies by entity. The field is omitted when no unambiguous match is available. Lapsed or retired LEIs may be returned; annulled records are excluded.

## 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, with or without the `-` before the last 2 | `087399-14` | Exact | Exact match returned first (matchType: id); other results may follow |

<Note>
  Name search covers active entities only. Inactive entities (dissolved,
  withdrawn, cancelled) can be found only by Registry Number, which also
  queries the live registry.
</Note>

### Active companies only

Search can return companies that are no longer active. Each result carries the register's status, so [`activeOnly=true`](/essentials/search#active-companies-only) removes the inactive ones. Name searches only cover active companies. Registration-number lookups can also return inactive companies, which the filter removes.

## Quirks & Gotchas

| Quirk | Details |
| - | - |
| **Registry Number padding** | Oregon pads the part before the hyphen to six digits (`087399-14`). Numbers under seven digits in total are returned as plain digits with no hyphen, e.g. `414` (Lewis & Clark College) or `443499`. The registration year does not decide the shape: a 1907 entity carries `012267-11` and a 2001 entity carries `443499`. |
| **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 prefill 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. |
| `PEN` / Pending | `false` | Registration pending. |
| `WIT` / Withdrawn | `false` | Foreign entity withdrew its Oregon registration. |
| `CAN` / Cancelled | `false` | Registration cancelled. |
| `CON` / Converted | `false` | Entity converted. |
| `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 | `T5ZE` |
    | Foreign Business Corporation | Corporation | — |
    | Domestic Professional Corporation | Corporation | — |
    | Foreign Professional Corporation | Corporation | — |
    | Domestic Limited Liability Company | Limited Liability Company | `QK2J` |
    | Foreign Limited Liability Company | Limited Liability Company | — |
    | Domestic Professional Limited Liability Company | Limited Liability Company | — |
    | Foreign Professional Limited Liability Company | Limited Liability Company | — |
    | Domestic Limited Partnership | Partnership | `GEE0` |
    | Foreign Limited Partnership | Partnership | — |
    | Domestic Limited Liability Partnership | Partnership | — |
    | Foreign Limited Liability Partnership | Partnership | — |
    | Domestic Nonprofit Corporation | Nonprofit Organization | `UZ83` |
    | Foreign Nonprofit Corporation | Nonprofit Organization | — |
    | 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 | Vice President |
| `SEC` | Secretary | Secretary |
| `TRE` | Treasurer | Treasurer |
| `DIR` | Director | Board Member |
| `MGR` | Manager | Manager |
| `PAR` | Partner | Partner |
| `GPA` | General Partner | General Partner |
| `MEM` | Member | Other |
| `INC` | Incorporator | Other |

<Note>
  Fixed source codes have deterministic English and standardized meanings. Directors and incorporators are returned as other key persons, as are registered agents. A member in a roster that also names a current manager is an other key person; otherwise the member retains the register's representing category. Oregon law distinguishes member-managed and manager-managed LLCs, so this category alone does not establish a person's actual signing powers. Officer duties depend on bylaws and individual grants; no sole or joint signing mode is inferred. Unknown named principal functions retain their source title as other key persons with standardized `Other`.
</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 | No | Not returned as a separate field (used only as the legal address fallback). Shown on the Trade Register Extract. |
| Legal form | Yes | Entity type with domestic/foreign distinction. |
| Jurisdiction | No | Not returned in the JSON response. Shown on the Trade Register Extract. |
| Registered agent | Yes | Returned as an `otherKeyPerson`. |
| Officers and managers | Yes | Returned in verification mode (`legalRepresentatives`). |
| Name history | No | Not returned in the JSON response. Shown on the Trade Register Extract. |
| 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 GET "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 GET "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": "Limited Liability Company"
        },
        "legalAddress": {
          "addressLine1": "1 Bowerman Drive",
          "city": "Beaverton",
          "postalCode": "97005",
          "region": "OR",
          "countryCode": "US"
        }
      },
      "otherKeyPersons": [
        {
          "entityId": "company_001",
          "type": "company",
          "role": {
            "localName": "Registered Agent",
            "standardized": "Registered Agent"
          },
          "company": { "legalName": "UNITED AGENT GROUP INC." }
        }
      ],
      "legalRepresentatives": [
        {
          "entityId": "company_002",
          "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"
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.