Oklahoma - Topograph

Start here

This guide contains public integration notes for Oklahoma. 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.

Oklahoma coverage, pricing, and sources

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

This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.

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
- Legal Forms
- Officer Roles
Data Availability

API access: US-OK is not yet part of the public countryCode enum. Contact us to enable it on your workspace. Requests sent with countryCode: "US-OK" will otherwise return 400 until the enum is expanded.

Data Sources

Oklahoma uses two tiers against the Oklahoma Secretary of State, Business Services Division. The register covers every domestic and foreign for-profit corporation, nonprofit corporation, limited liability company, limited partnership, limited liability partnership, and cooperative association formed in or qualified to do business in Oklahoma. No bulk-data extract is published for business entities; every request is resolved live against the portal.

Oklahoma Secretary of State public portal (free tier). The free Entity Summary page at sos.ok.gov/corp exposes the legal name, current status, legal form, jurisdiction, formation date, and the registered agent for any entity. This is what the free company-data block delivers. Officer and director rosters are not visible on this surface.
Oklahoma Secretary of State paid Entity Detail (paid tier). The Secretary of State charges a fee per entity to unlock the full Entity Detail view, which adds the officer/director/general-partner roster, the principal-office address, active commercial tradenames (DBAs), the duration, and the full filing history. Purchase the paid Entity Detail block to receive legalRepresentatives.

Two-block model. The free company + otherKeyPersons datapoints (registered agent) are delivered by the base company-data block. legalRepresentatives (officers, directors, general partners) require the separate paid Entity Detail block. See the pricing page for block pricing.

Company Identifiers

Query Identifiers

Identifier Type	Format	Example	Notes
Filing Number	10 digits, numeric only	`3400676484`	Primary identifier assigned by the Oklahoma Secretary of State. Displayed on every entity page at sos.ok.gov/corp.

Oklahoma Filing Numbers are 10 numeric digits. Unlike Pennsylvania’s filing number they are not zero-padded: they are plain integers (e.g. 3400676484, not 0003400676). Pass the number exactly as it appears on the SoS portal.

Identifiers in API Response

Identifier	Format	Example	Found In
`filingNumber`	10 digits, numeric only	`3400676484`	All entities

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Name	2-100 chars	`"Acme Corp"`	Starts-with (case-insensitive)	Multiple results
By Filing Number	10 digits	`3400676484`	Exact (`matchType: id`)	Single match returned first

Starts-with search. Name search anchors on the beginning of the legal name (case-insensitive). Use fuller query strings to narrow the result set, which is capped at 50 matches.

Quirks & Gotchas

Quirk	Details
No open-data snapshot	Oklahoma does not publish a bulk-data extract for business entities. There is no fast/non-authoritative mode. Every request hits the live portal. Expect latency in the 30 s range for the free tier.
Officers are a paid upgrade	The free Entity Summary page does not expose officer or director data. The SoS charges a fee per entity for the full Entity Detail view that includes the PRINCIPALS table. Send the paid Entity Detail block to receive `legalRepresentatives`.
No registered-address from the free tier	The free Entity Summary shows only the registered-agent address, not the principal-office address. The principal-office address is part of the paid Entity Detail.
Registered agent in `otherKeyPersons`	The registered agent is returned as an `otherKeyPersons` entry with the `RegisteredAgent` role, not under `legalRepresentatives`.
No shareholder or UBO register	Oklahoma does not publish shareholders or beneficial owners for any entity type.
No activity codes	The Business Services Division does not collect NAICS, NACE, or ISIC codes.
Legal form is free-text from the register	The entity-type label on the SoS portal is free text (e.g. `Foreign Limited Partnership`, `Domestic Limited Liability Company`). Topograph maps it to a standardized legal form; unmapped variants are returned with only `localName`.
Tradenames (DBAs) in the paid tier only	Active commercial tradenames appear on the paid Entity Detail page. They are not exposed by the free Entity Summary.
Paid Entity Detail carries a per-entity fee	Each lookup of the paid Entity Detail block is charged a fee by the Secretary of State. This fee is incorporated into the paid block price on the pricing page.
Free Trade Register Extract included	The free company-data block includes a printable Trade Register Extract (a rendered PDF of the public Entity Summary page) at no extra charge.

Mappings

Legal Forms

Legal form is sourced from the entity-type label on the Oklahoma Secretary of State Entity Summary page. The register uses a fixed vocabulary of entity types corresponding to Oklahoma statutes. Topograph maps each to a standardized category; the raw local name is always preserved.

Common Oklahoma entity types

SoS Entity Type	Standardized
Domestic For Profit Corporation	Corporation
Foreign For Profit Corporation	Corporation
Domestic Non-Profit Corporation	NonprofitOrganization
Foreign Non-Profit Corporation	NonprofitOrganization
Domestic Limited Liability Company	LimitedLiabilityCompany
Foreign Limited Liability Company	LimitedLiabilityCompany
Domestic Limited Partnership	Partnership
Foreign Limited Partnership	Partnership
Domestic Limited Liability Partnership	Partnership
Foreign Limited Liability Partnership	Partnership
Domestic Cooperative Association	Other
Foreign Cooperative Association	Other

The full list of standardized legal forms and their ISO 20275 mappings (where GLEIF publishes one) is available on the Oklahoma pricing page.

Officer Roles

Officer and director data comes from the PRINCIPALS table on the paid Entity Detail page. Titles are reported in uppercase by the register. Topograph maps the well-known vocabulary to standardized roles; unusual titles are enriched by AI and returned with the raw localName preserved.

Common Title	Standardized	Entity Types
PRESIDENT	President	Corporations
VICE PRESIDENT	VicePresident	Corporations
SECRETARY	Secretary	Corporations
TREASURER	Treasurer	Corporations
DIRECTOR	Director	Corporations
CHAIRMAN	Chairman	Corporations
CEO	CEO	Corporations
CFO	CFO	Corporations
COO	COO	Corporations
MANAGER	Manager	LLCs
MANAGING MEMBER	ManagingDirector	LLCs
MEMBER	Other	LLCs (member-managed)
GENERAL PARTNER	GeneralPartner	Limited partnerships
LIMITED PARTNER	LimitedPartner	Limited partnerships
MANAGING PARTNER	ManagingPartner	Partnerships

Registered agents are returned under otherKeyPersons, not under legalRepresentatives. They hold the RegisteredAgent role and are available from the free company-data block.

Data Availability

Data Point	Available	Notes
Company name	Yes (free)	Current legal name from the Entity Summary
Company status	Yes (free)	Active / Inactive; read live from the portal
Registration date	Yes (free)	Formation date from the Entity Summary
Jurisdiction	Yes (free)	State of formation for foreign entities (e.g. Delaware)
Legal form	Yes (free)	Standardized from the register’s entity-type label
Registered agent	Yes (free)	Returned as `otherKeyPersons` with the `RegisteredAgent` role
Legal address	Paid tier	Principal-office address is only on the paid Entity Detail
Legal representatives	Paid tier	Officers, directors, and general partners from the PRINCIPALS table
Tradenames (DBAs)	Paid tier (in progress)	Active commercial tradenames from the paid Entity Detail
Trade Register Extract	Yes (free, included)	Printable PDF of the public Entity Summary page, included with the company-data block at no extra charge
Shareholders	No	Not published by the Oklahoma business register
UBOs	No	No public beneficial-ownership register at the Oklahoma state level
Activity codes	No	Not collected by the Business Services Division
Financial data	No	Not collected
Certified copies	Roadmap	Certified documents require the Secretary of State paid filing flow and are not yet offered through Topograph
Certificate of Good Standing	Roadmap	Not yet offered through Topograph

Example API Responses

Search by Name

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

[
  {
    "id": "1234567890",
    "legalName": "ACME HOLDINGS LLC",
    "countryCode": "US-OK",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "OK",
      "countryCode": "US"
    }
  }
]

Search by Filing Number

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

[
  {
    "id": "1234567890",
    "legalName": "ACME HOLDINGS LLC",
    "countryCode": "US-OK",
    "matchReason": {
      "matchType": "id"
    }
  }
]

Company Profile (free tier)

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-OK", "id": "1234567890", "dataPoints": ["company", "otherKeyPersons"]}'

{
  "company": {
    "id": "1234567890",
    "countryCode": "US-OK",
    "identifiers": { "filingNumber": "1234567890" },
    "legalName": "ACME HOLDINGS LLC",
    "status": {
      "localName": "Active",
      "active": true
    },
    "legalForm": {
      "localName": "Domestic Limited Liability Company",
      "standardized": "LimitedLiabilityCompany"
    },
    "registrationDate": "2010-03-15"
  },
  "otherKeyPersons": [
    {
      "role": { "standardized": "RegisteredAgent" },
      "individual": {
        "name": { "fullName": "ACME REGISTERED AGENT INC" },
        "residenceAddress": {
          "addressLine1": "123 Main St",
          "city": "Oklahoma City",
          "region": "OK",
          "postalCode": "73102",
          "countryCode": "US"
        }
      }
    }
  ]
}

Company Profile with Legal Representatives (paid tier)

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-OK", "id": "1234567890", "dataPoints": ["company", "legalRepresentatives"]}'

{
  "company": {
    "id": "1234567890",
    "countryCode": "US-OK",
    "identifiers": { "filingNumber": "1234567890" },
    "legalName": "ACME HOLDINGS LLC"
  },
  "legalRepresentatives": [
    {
      "role": {
        "localName": "MANAGER",
        "standardized": "Manager"
      },
      "individual": {
        "name": { "fullName": "JANE SMITH" }
      }
    }
  ]
}

​Start here

Oklahoma coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Legal Forms

​Officer Roles

​Data Availability

​Example API Responses

​Search by Name

​Search by Filing Number

​Company Profile (free tier)

​Company Profile with Legal Representatives (paid tier)

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Legal Forms

Officer Roles

Data Availability

Example API Responses

Search by Name

Search by Filing Number

Company Profile (free tier)

Company Profile with Legal Representatives (paid tier)