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

# Kansas

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

## Start here

This guide contains public integration notes for Kansas. 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="Kansas coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-ks">
  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)
  * [Company Statuses](#company-statuses)
* [Data Availability](#data-availability)

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

## Data Sources

Kansas uses a single integration against the **Kansas Secretary of State Business Entity Search Station** (`sos.ks.gov`), maintained by the Business Services Division. The register covers every domestic and foreign entity filed under the Kansas General Corporation Code (K.S.A. Chapter 17) and the Limited Liability Company Act (K.S.A. Chapter 17, Article 76): for-profit and not-for-profit corporations, LLCs (including series and professional variants), limited partnerships, limited liability partnerships, and business trusts.

* **Kansas Secretary of State Business Entity Search Station** (live, authoritative). The public portal is queried in real time for every request. It exposes legal name, Business ID, entity type, formation date, jurisdiction, current status, principal office address, resident agent name and address, last reporting year, next report due date, forfeiture date when applicable, and the full filing history.

<Note>
  **Single live source.** Kansas does not publish a bulk download or open-data feed of the business register, so every request is served from the live portal. Because that read is fast, both onboarding and verification modes return the same authoritative data — there is no separate non-authoritative cache tier.
</Note>

<Warning>
  **Portal reliability.** The Kansas Secretary of State portal may be temporarily unavailable during maintenance windows or periods of high load. The `flakySource` caveat on the data block reflects this. Failed requests are not billed.
</Warning>

## Company Identifiers

### Query Identifiers

| Identifier Type            | Format                       | Example   | Notes                                                                                                       |
| -------------------------- | ---------------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |
| **Kansas SoS Business ID** | Numeric, no dashes or spaces | `6749200` | Assigned by the Kansas Secretary of State. Distinct from the Federal Employer Identification Number (FEIN). |

<Tip>
  The Kansas Business ID is purely numeric. The portal rejects dashes, spaces, and any non-digit characters. Strip any formatting before passing the identifier to the API.
</Tip>

### Identifiers in API Response

| Identifier   | Format         | Example   | Found In     |
| ------------ | -------------- | --------- | ------------ |
| `businessId` | Numeric string | `6749200` | All entities |

## Search Capabilities

| Search Type               | Pattern        | Example            | Match Type                  | Expected Results              |
| ------------------------- | -------------- | ------------------ | --------------------------- | ----------------------------- |
| By Name                   | 2-100 chars    | `"Garmin"`         | Contains (case-insensitive) | Up to 100 results             |
| By Kansas SoS Business ID | Numeric string | `1749480`          | Exact                       | Single result (matchType: id) |
| By Resident Agent Name    | 2-100 chars    | `"CT Corporation"` | Contains (case-insensitive) | Multiple results              |

<Note>
  **Name search is contains-match.** Queries match anywhere in the legal name, case-insensitively. Results are capped at 100. Use a more specific query string to narrow the result set.
</Note>

## Quirks & Gotchas

| Quirk                                              | Details                                                                                                                                                                                                                |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Numeric Business ID only**                       | The Kansas SoS Business ID is always a numeric string with no dashes or spaces. Non-digit characters are rejected. It is distinct from the Federal Employer Identification Number.                                     |
| **No bulk / open-data feed**                       | Kansas does not publish a Socrata, CSV, or API bulk download of the business register. Every request hits the live portal.                                                                                             |
| **Officers not on the public detail page**         | Officers and directors are filed on the Kansas annual information report (Form IFP) but are not surfaced as a structured datapoint on the public Business Entity Search Station. They are not available via the API.   |
| **Resident agent is an other key person**          | The resident agent name and address are returned under `otherKeyPersons`, not `legalRepresentatives`. The resident agent receives service of process but does not have authority to bind the entity.                   |
| **No activity codes**                              | Industry classification codes (NAICS / NACE / ISIC) are not collected by the Kansas Secretary of State.                                                                                                                |
| **No shareholders or UBOs**                        | Shareholder lists and LLC member names are not collected by the register. Kansas does not maintain a public beneficial-ownership register. Federal FinCEN BOI records are restricted.                                  |
| **Sole proprietorships and DBAs excluded**         | Sole proprietorships, doing-business-as filings, assumed names, fictitious names, and trade names do not file with the Kansas Secretary of State and are not indexed for search.                                       |
| **Certificate of Good Standing is a paid upgrade** | The official Kansas Certificate of Good Standing is available as a paid document (see [pricing](https://topograph.co/pricing/us-ks)). The Trade Register Extract is included with the company data at no extra charge. |

## Mappings

### Legal Forms

Legal form is sourced from the entity-type label published by the Kansas Secretary of State Business Entity Search Station. The taxonomy is a closed enum based on entity types registered under K.S.A. Chapter 17 (Kansas General Corporation Code) and K.S.A. Chapter 17, Article 76 (Limited Liability Company Act).

The full list of legal forms with ISO 20275 mappings is available on the [pricing page](https://topograph.co/pricing/us-ks). The table below shows the most common forms.

<AccordionGroup>
  <Accordion title="All Kansas entity types">
    | Kansas Entity Type                       | Standardized            | ISO 20275 |
    | ---------------------------------------- | ----------------------- | --------- |
    | For-Profit Corporation                   | Corporation             | `C3JQ`    |
    | Professional Association                 | Corporation             |           |
    | Public Benefit Corporation               | Corporation             |           |
    | Not-For-Profit Corporation               | NonprofitOrganization   | `4RCO`    |
    | Foreign For-Profit Corporation           | Corporation             |           |
    | Foreign Not-For-Profit Corporation       | NonprofitOrganization   |           |
    | Limited Liability Company                | LimitedLiabilityCompany | `JY0X`    |
    | Series Limited Liability Company         | LimitedLiabilityCompany |           |
    | Professional Limited Liability Company   | LimitedLiabilityCompany |           |
    | Public Benefit Limited Liability Company | LimitedLiabilityCompany |           |
    | Foreign Limited Liability Company        | LimitedLiabilityCompany |           |
    | Limited Partnership                      | Partnership             | `T91T`    |
    | Foreign Limited Partnership              | Partnership             |           |
    | Limited Liability Partnership            | Partnership             |           |
    | Foreign Limited Liability Partnership    | Partnership             |           |
    | General Partnership                      | Partnership             |           |
    | Business Trust                           | Other                   |           |
    | Foreign Business Trust                   | Other                   |           |
  </Accordion>
</AccordionGroup>

### Company Statuses

Status is read directly from the Kansas Secretary of State Business Entity Search Station and reflects the entity's current lifecycle state under K.S.A. Chapter 17.

| Status                               | Notes                                                                     |
| ------------------------------------ | ------------------------------------------------------------------------- |
| Active And In Good Standing          | Current on annual reports; no outstanding obligations                     |
| In Good Standing                     | Variant of the active / good-standing state                               |
| Active                               | Active without explicit good-standing qualification                       |
| Forfeited - Failed To Timely File AR | Annual report delinquency; entity has forfeited its rights to do business |
| Forfeited                            | General forfeiture state                                                  |
| Dissolved                            | Voluntarily or administratively dissolved                                 |
| Cancelled                            | Applicable to partnerships and similar forms                              |
| Merged                               | Entity merged into another                                                |
| Withdrawn                            | Foreign entity withdrew its registration                                  |
| Inactive                             | No longer active; catch-all for legacy records                            |

## Data Availability

| Data Point                       | Available | Notes                                                                              |
| -------------------------------- | --------- | ---------------------------------------------------------------------------------- |
| Company name                     | Yes       | Current legal name as registered with the Kansas SoS                               |
| Company status                   | Yes       | Live status from the Business Entity Search Station                                |
| Registration date                | Yes       | Formation date as filed with the Kansas SoS                                        |
| Jurisdiction                     | Yes       | State or country of domicile for foreign entities                                  |
| Legal address                    | Yes       | Principal office address                                                           |
| Legal form                       | Yes       | Closed 18-value Kansas SoS taxonomy with ISO 20275 mapping where available         |
| Resident agent                   | Yes       | Returned as an other key person (name and address)                                 |
| Legal representatives (officers) | No        | Filed on the annual information report but not on the public detail page           |
| Activity codes                   | No        | Not collected by the Kansas SoS                                                    |
| Shareholders                     | No        | Not published                                                                      |
| UBOs                             | No        | Not published                                                                      |
| Trade Register Extract           | Yes       | Free printable record of the entity, included with the company data                |
| Certificate of Good Standing     | Yes       | Paid document; official Kansas Certificate of Good Standing (register fee applies) |
| Financial data                   | No        | Not collected                                                                      |
| Fictitious names (DBAs)          | No        | Not filed with the Kansas SoS                                                      |

For the full datapoint catalog, document list, and live pricing, see the [Kansas pricing page](https://topograph.co/pricing/us-ks).

## Example API Responses

### Search by Name

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

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

### Search by Business ID

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

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

### Company Profile

```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-KS", "id": "1234567", "mode": "onboarding", "dataPoints": ["company", "otherKeyPersons"]}'
```

```json theme={null}
{
  "company": {
    "id": "1234567",
    "countryCode": "US-KS",
    "identifiers": { "businessId": "1234567" },
    "legalName": "ACME HOLDINGS LLC",
    "registrationDate": "2015-03-14",
    "status": { "localName": "Active and in Good Standing", "active": true },
    "legalForm": {
      "localName": "Limited Liability Company",
      "englishTranslation": "Limited Liability Company",
      "standardized": "LimitedLiabilityCompany",
      "iso20275Code": "JY0X"
    },
    "legalAddress": {
      "addressLine1": "123 Placeholder St",
      "city": "TOPEKA",
      "region": "KS",
      "postalCode": "66612",
      "countryCode": "US"
    }
  },
  "otherKeyPersons": [
    {
      "type": "COMPANY",
      "role": { "localName": "Resident Agent", "standardized": "RegisteredAgent" },
      "company": {
        "legalName": "SAMPLE REGISTERED AGENTS INC.",
        "countryCode": "US-KS",
        "legalAddress": {
          "addressLine1": "456 Example Ave",
          "city": "WICHITA",
          "region": "KS",
          "postalCode": "67202",
          "countryCode": "US"
        }
      }
    }
  ]
}
```

<Note>
  The resident agent is returned as an individual (`type: "INDIVIDUAL"`, under `individual.name.fullName` / `individual.residenceAddress`) when the agent is a natural person, or as a company (`type: "COMPANY"`, as shown above) when it is a registered-agent service. `legalRepresentatives` is not a supported datapoint for Kansas and will be rejected if requested.
</Note>