> ## 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.
# Kentucky
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for Kentucky. 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.
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.
## 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)
* [Company Status](#company-status)
* [Data Availability](#data-availability)
**API access:** `US-KY` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-KY"` will otherwise return `400` until the enum is expanded.
## Data Sources
Kentucky data is retrieved live from the **Kentucky Secretary of State, Business Filings & Records** through the public Business Entity Search portal. The register covers every domestic and foreign entity filed under Kentucky Revised Statutes Title XXIII: for-profit and nonprofit corporations, limited liability companies, limited partnerships, business trusts, cooperatives, and assumed names.
Each entity is assigned a seven-digit Organization Number with leading zeros preserved (e.g. `0061792`). The portal exposes legal name, profit/non-profit status, entity type, industry label, employee-count band, primary county, status (Active / Inactive), standing (Good / Bad), state of incorporation, formation and authority dates, last annual report date, principal office, registered agent, the current officer roster, founding officers (including the incorporator for domestic corporations), assumed names, former names, and the full filing history. Scanned images of filings submitted on or after 15 September 2004 are published as downloadable PDFs.
**Single-tier integration.** Kentucky does not publish a free open-data extract of its business register. Bulk access requires a paid subscription, which is not viable for a cost-free integration. All lookups go directly against the live portal. There is no separate fast / non-authoritative mode.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| -------------------------------- | --------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kentucky Organization Number** | 7 digits, leading zeros preserved | `0061792` | Primary identifier assigned by the Kentucky Secretary of State. Inputs without leading zeros (`61792`) or with a `KY-` / `SOS-` prefix are accepted and normalised. |
The Organization Number is zero-padded to exactly seven digits. One Organization Number is shared across the entity's main registration and any assumed-name (DBA) filings, so searching by org number may return several rows. The API returns the main filing's record and surfaces DBAs inside the company data, not as separate companies.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| -------------------- | --------------------- | --------- | ------------ |
| `organizationNumber` | 7 digits, zero-padded | `0061792` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ---------------------- | ----------- | -------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------- |
| By Name | 2–100 chars | `"Papa Johns"` | Starts-with (case-insensitive) | Multiple results |
| By Organization Number | 7 digits | `0061792` | Exact | Exact match returned first (`matchType: id`); assumed-name filings sharing the same org number may follow |
**Starts-with search.** Name search anchors on the beginning of the legal name (case-insensitive). Use a fuller query string to narrow the result set, which is capped at 50 matches.
## Quirks & Gotchas
| Quirk | Details |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **One org number, many filings** | A single Organization Number is shared by the entity's main registration and every assumed-name (DBA) filing. The API returns the main legal entity and includes DBAs as part of the company record. Never use the org number as a unique filing key. |
| **Zero-padding is load-bearing** | Organization Numbers are always 7 digits. The register and our API treat `0061792` and `61792` as different keys. |
| **Status has two dimensions** | The register records both a Status (`A - Active` / `I - Inactive`) and a Standing (`G - Good` / `B - Bad`). The API returns Status as the primary active/inactive flag; Standing is included as a separate field when present. |
| **No shareholder or UBO register** | Kentucky Secretary of State filings do not publish shareholder lists, capital structure, or beneficial ownership data for any entity type. Federal FinCEN beneficial ownership records are restricted and not accessible publicly. |
| **No standardised activity codes** | The register exposes a coarse industry label (e.g. "Miscellaneous Manufacturing Industries") but no NAICS, NACE, or ISIC codes. Tax IDs and EINs are also not published. |
| **Assumed names are not separate companies** | DBA / assumed-name registrations share the parent entity's Organization Number. They are surfaced inside the company record's assumed-names list, not returned as independent company results. |
| **Founding officers appear separately** | Initial officers (the people named at formation, including the incorporator for domestic corporations) are returned as other key persons, not as current legal representatives. |
| **Filing scans start from 2004** | Scanned documents cover filings submitted on or after 15 September 2004. Earlier documents are paper records available only by request from the register. |
| **Certificate of Existence is not yet offered** | The paid Certificate of Existence / Authorization (flat \$10 statutory fee, KRS 14A.2-130) is not currently available through Topograph. |
## Mappings
### Legal Forms
Legal form is sourced from the Company Type field on the Kentucky SoS portal. The vocabulary uses three-letter codes with expanded display names.
| Portal Code | Display Name | Standardized | Notes |
| ----------- | ---------------------------------- | ----------------------- | ----------------------------------------------------------- |
| `KCO` | Kentucky Corporation | Corporation | Domestic for-profit corporation |
| `FCO` | Foreign Corporation | Corporation | Out-of-state corporation registered in KY |
| `KLC` | Kentucky Limited Liability Company | LimitedLiabilityCompany | Domestic LLC |
| `FLC` | Foreign Limited Liability Company | LimitedLiabilityCompany | Out-of-state LLC registered in KY |
| `ASN` | Assumed Name Corporation | Other | DBA filing for a corporation; same org number as the parent |
| `ASL` | Assumed Name for LLC | Other | DBA filing for an LLC; same org number as the parent |
The codelist above reflects entity types observed during integration. The Kentucky register includes additional entity types (limited partnerships, business trusts, cooperatives, nonprofits, and others). Unrecognised codes are preserved verbatim with a standardized fallback of `Other`. The pricing page carries the full canonical list.
### Officer Roles
Current officers are returned as legal representatives. The portal publishes a small closed vocabulary of titles; each is mapped to a standardized Topograph role.
| Portal Title | Standardized Role |
| ----------------------- | ------------------- |
| President | President |
| Vice President | VicePresident |
| Secretary | Secretary |
| Treasurer | Treasurer |
| Director | Director |
| Manager | Manager |
| Managing Director | ManagingDirector |
| Chairman | Chairman |
| Chairman of the Board | ChairmanOfTheBoard |
| Chief Executive Officer | CEO |
| Chief Financial Officer | CFO |
| Chief Operating Officer | COO |
| General Partner | GeneralPartner |
| Managing Partner | ManagingPartner |
| Limited Partner | LimitedPartner |
| Partner | Partner |
| Authorized Signatory | AuthorizedSignatory |
| Owner | Owner |
| Liquidator | Liquidator |
| Officer | Other |
Founding officers (including the incorporator for domestic corporations) are returned as other key persons with the `Incorporator` local name, not as legal representatives. The registered agent is also returned as an other key person.
### Company Status
| Portal Value | Active Flag |
| -------------- | ----------- |
| `A - Active` | `true` |
| `I - Inactive` | `false` |
Standing (Good / Bad) is a separate register field and is included in the response alongside status when available.
## Data Availability
| Data Point | Available | Notes |
| ---------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name |
| Company status | Yes | Active / Inactive, read from the live portal |
| Standing | Yes | Good / Bad, as reported by the register |
| Registration date | Yes | Date filed in Kentucky |
| Authority date | Yes (foreign) | Date the foreign entity was authorized to transact in KY |
| Organization date | Yes (domestic) | Date the domestic entity was originally organized |
| Legal address | Yes | Principal office address (street, city, state, ZIP) |
| Legal form | Yes | Portal Company Type, standardized |
| Legal representatives | Yes | Current officers (President, Secretary, Treasurer, Director, and other titles) |
| Other key persons | Yes | Registered agent; founding officers including the incorporator |
| Assumed names (DBAs) | Yes | Listed as part of the company record |
| Former names | Yes | Prior legal names from amendments |
| Last annual report date | Yes | Date of the most recent annual report on file |
| State of incorporation | Yes | `KY` for domestic entities; ISO 3166-2 region code for foreign entities |
| Employee count band | Yes | Coarse bucket: Small (0-19) / Medium (20-99) / Large (100+) |
| Primary county | Yes | Kentucky county where the principal office is located |
| Industry label | Yes | Coarse SIC-style label; not a standardized NAICS/NACE code |
| Activity codes | No | Not published by the register in a standardized format |
| Registered agent address | Yes | Included in other key persons |
| Shareholders | No | Not published |
| UBOs | No | Not published; federal FinCEN records are restricted |
| Tax ID / EIN | No | Not exposed in the public business register |
| Financial data | No | Not collected |
| Trade Register Extract | Yes | A printable summary of the live business entity record, included at no extra charge when purchasing company data |
| Annual Report PDF | Yes | The latest Annual Report PDF, published by the register; available as a separate document |
| Certificate of Existence / Authorization | No (roadmap) | Paid (\$10 statutory fee, KRS 14A.2-130); not currently offered |
| Pre-2004 document scans | No | Paper records; must be ordered directly from the register |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-KY&query=Acme" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "0012345",
"legalName": "ACME MANUFACTURING LLC",
"countryCode": "US-KY",
"matchReason": {
"matchType": "default"
},
"address": {
"region": "KY",
"countryCode": "US"
}
}
]
```
### Search by Organization Number
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-KY&query=0012345" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "0012345",
"legalName": "ACME MANUFACTURING LLC",
"countryCode": "US-KY",
"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-KY", "id": "0012345", "dataPoints": ["company", "legalRepresentatives"]}'
```
```json theme={null}
{
"company": {
"id": "0012345",
"countryCode": "US-KY",
"identifiers": { "organizationNumber": "0012345" },
"legalName": "ACME MANUFACTURING LLC",
"registrationDate": "2010-03-15",
"status": { "localName": "A - Active", "active": true },
"legalForm": {
"localName": "Kentucky Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"city": "Louisville",
"region": "KY",
"postalCode": "40201",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"name": "Jane Example",
"role": { "localName": "President", "standardized": "President" }
}
]
}
```