Oregon (US)

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.

Oregon coverage, pricing, and sources

Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.

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.

Data Sources
Company Identifiers
Search Capabilities
Quirks & Gotchas
Mappings
Data Availability
Documents
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).

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.

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.

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.

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

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.

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.

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	—

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

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.

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

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.

Example API Responses

Search by Name

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

[
  {
    "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

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

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

Company Profile

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"]}'

Foreign LLC with registered agent and member

{
  "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" }
    }
  ]
}

Available Documents

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"]}'

{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_tre_or_abc123",
      "name": "Trade Register Extract",
      "format": "pdf"
    }
  }
}

Europe

North America

Asia

Offshore Centers

Start here

Oregon coverage, pricing, and sources

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Officer Roles

Other Key Persons

Data Availability

Documents

Available Documents

Example API Responses

Search by Name

Search by Registry Number

Company Profile

Available Documents

​Start here

Oregon coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Company Status

​Legal Forms

​Officer Roles

​Other Key Persons

​Data Availability

​Documents

​Available Documents

​Example API Responses

​Search by Name

​Search by Registry Number

​Company Profile

​Available Documents

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Officer Roles

Other Key Persons

Data Availability

Documents

Available Documents

Example API Responses

Search by Name

Search by Registry Number

Company Profile

Available Documents