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

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.

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

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

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

Active companies only

Search can return companies that are no longer active. Each result carries the register’s status, so activeOnly=true 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 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.
`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.

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	LimitedLiabilityCompany	`QK2J`
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	`UZ83`
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	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

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 GET "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 GET "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

Active companies only

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

​Active companies only

​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

Active companies only

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