Skip to main content

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.

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

​
Table of Contents

​
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 TypeFormatExampleNotes
Registry Number3-9 digits, optional 2-digit suffix087399-14Primary 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

IdentifierFormatExampleFound In
registryNumber3-9 digits, optional 2-digit suffix087399-14All entities

​
Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By Name2-200 chars"Nike"ContainsMultiple results
By Registry Number3-9 digits, optional -NN suffix087399-14ExactSingle company
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

QuirkDetails
Registry Number paddingOregon 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 snapshotThe open dataset covers active entities only. Inactive entities (dissolved, withdrawn, cancelled) resolve through the live registry path.
Associated-name rowsEach 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 cadenceThe “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 publishedOregon 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 ValueActiveNotes
ACT / ActivetrueEntity is in good standing.
INA / InactivefalseCatch-all inactive state (cancelled, dissolved).
WDR / WithdrewfalseForeign entity withdrew its Oregon registration.
EXP / ExpiredfalseRegistration lapsed.
DIS / DissolvedfalseVoluntary or administrative dissolution.
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.

​
Officer Roles

Officer titles surface on the live profile page using three-letter Oregon filing-form codes. Topograph maps them to standardized roles.
Source CodeLocal NameStandardized
PREPresidentPresident
VPRVice PresidentVicePresident
SECSecretarySecretary
TRETreasurerTreasurer
DIRDirectorDirector
MGRManagerManager
PARPartnerPartner
GPAGeneral PartnerGeneralPartner
MEMMemberOther
INCIncorporatorOther
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

RoleStandardizedNotes
Registered AgentRegistered AgentStatutory service-of-process contact. Returned as an otherKeyPerson.

​
Data Availability

Data PointAvailableNotes
Company nameYesCurrent legal name from the entity detail page.
Company statusYesActive/inactive with detailed status code.
Registration dateYesInitial filing date with the Oregon Secretary of State.
Legal addressYesPrincipal place of business; falls back to mailing address when not separately filed.
Mailing addressYesReturned when distinct from the principal place of business.
Legal formYesEntity type with domestic/foreign distinction.
JurisdictionYesState or country of formation for foreign entities.
Registered agentYesReturned as an otherKeyPerson.
Officers and managersYesReturned in verification mode (legalRepresentatives).
Name historyYesPrior legal names with transaction date.
Activity codesNoNot published by the Oregon Secretary of State.
ShareholdersNoNot collected by the Oregon business registry.
UBOsNoNo state-level beneficial-ownership register.

​
Documents

​
Available Documents

DocumentAvailabilityFormat
Trade Register ExtractAlways availablePDF
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"]}'

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