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

# Oklahoma

> Country-specific identifiers, data sources, and integration details

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

<Card title="Oklahoma coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-ok">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

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

<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)
  * [Legal Forms](#legal-forms)
  * [Officer Roles](#officer-roles)
* [Data Availability](#data-availability)

<Warning>
  **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.
</Warning>

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

<Note>
  **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.
</Note>

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

<Tip>
  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.
</Tip>

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

<Note>
  **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.
</Note>

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

<AccordionGroup>
  <Accordion title="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                   |
  </Accordion>
</AccordionGroup>

<Note>
  The full list of standardized legal forms and their ISO 20275 mappings (where GLEIF publishes one) is available on the [Oklahoma pricing page](https://topograph.co/pricing/us-ok).
</Note>

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

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

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

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

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

### Search by Filing Number

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

```json theme={null}
[
  {
    "id": "1234567890",
    "legalName": "ACME HOLDINGS LLC",
    "countryCode": "US-OK",
    "matchReason": {
      "matchType": "id"
    }
  }
]
```

### Company Profile (free tier)

```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-OK", "id": "1234567890", "dataPoints": ["company", "otherKeyPersons"]}'
```

```json theme={null}
{
  "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)

```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-OK", "id": "1234567890", "dataPoints": ["company", "legalRepresentatives"]}'
```

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