> ## 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.
# Tennessee (US)
> Country-specific identifiers, data sources, and implementation details
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Company Status](#company-status)
* [Legal Forms](#legal-forms)
* [Other Key Persons](#other-key-persons)
* [Data Availability](#data-availability)
* [Documents](#documents)
* [Example API Responses](#example-api-responses)
## Data Sources
All entity data comes from the **Tennessee Secretary of State — Business Services Division** via the **TN CAB** portal ([tncab.tnsos.gov](https://tncab.tnsos.gov/business-entity-search)). This is the official online search system for all for-profit corporations, LLCs, nonprofit corporations, limited partnerships, and their foreign equivalents registered in Tennessee.
Every request hits the live register — there is no bulk data export or REST API. The response is always authoritative and up to date.
Tennessee is a single-source country. All data — company profile, registered
agent, and search — comes from the live TN SoS portal. The Trade Register
Extract is included at no extra charge with the company data block.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ------------------ | --------------------------- | ----------- | ----------------------------------------------------- |
| **Control Number** | 9-digit zero-padded integer | `000239194` | Primary identifier assigned by TN SoS at registration |
The Control Number is the only identifier supported for company retrieval. Leading zeros may be omitted in queries — `239194` resolves the same entity as `000239194`. To find a Control Number from a name, use the search endpoint first.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| --------------- | ----------- | ----------- | ------------ |
| `controlNumber` | `NNNNNNNNN` | `000239194` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ----------------- | ----------- | ------------------------ | ----------- | -------------------------------------------------------------------- |
| By Name | 2–200 chars | `"Tennessee Energy LLC"` | Starts with | Multiple results |
| By Control Number | 1–9 digits | `000239194` | Exact | Exact match returned first (matchType: id); other results may follow |
Name search matches from the beginning of the entity name (starts-with). For
broader matches, use shorter prefixes.
## Quirks & Gotchas
| Quirk | Details |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No officers published** | The TN SoS public portal does not expose officer or director information for any entity type. Filing history records officer changes but they are not displayed publicly. |
| **No bulk data / REST API** | Tennessee does not offer bulk corporate data exports or a public REST API. Every lookup is resolved live against the SoS portal. |
| **No activity codes** | Industry classification codes are tracked internally by TN SoS but are not displayed on the public entity detail page. |
| **Standing fields** | The entity detail page shows three standing indicators: Annual Report, Registered Agent, and Department of Revenue. These appear in `statusDetails`. |
| **Control Number zero-padding** | Control Numbers are always 9 digits in API responses. The portal displays them without leading zeros; we normalize to 9-digit form in all identifiers. |
## Mappings
### Company Status
Status comes from the TN SoS entity status field on the detail page.
| Source Value | Active | Notes |
| -------------------- | ------- | ---------------------------------------- |
| `Active` | `true` | Entity is in good standing |
| `Active - Dissolved` | `true` | Entity is dissolving but still active |
| `Dissolved` | `false` | Voluntary or administrative dissolution |
| `Revoked` | `false` | Revocation by the Secretary of State |
| `Withdrawn` | `false` | Foreign entity withdrew its registration |
| `Cancelled` | `false` | Registration cancelled |
| `Merged` | `false` | Entity merged into another entity |
### Legal Forms
Legal form is derived from the Entity Type field on the TN SoS portal. Domestic types cover entities formed under Tennessee law; Foreign types cover entities formed elsewhere and registered to do business in Tennessee.
| Portal Type | Standardized | ELF Code |
| --------------------------------- | ----------------------- | -------- |
| For-profit Corporation | Corporation | `C3JQ` |
| Foreign For-profit Corporation | Corporation | — |
| Limited Liability Company (LLC) | LimitedLiabilityCompany | `JY0X` |
| Foreign Limited Liability Company | LimitedLiabilityCompany | — |
| Nonprofit Corporation | NonprofitOrganization | `4RCO` |
| Foreign Nonprofit Corporation | NonprofitOrganization | — |
| Limited Partnership (LP) | Partnership | `T91T` |
| Foreign Limited Partnership (LP) | Partnership | — |
| Reserved Name | Other | — |
### Other Key Persons
| Role | Standardized | Notes |
| ---------------- | ---------------- | --------------------------------------------------------------- |
| Registered Agent | Registered Agent | Statutory service-of-process contact, required for all entities |
## Data Availability
| Data Point | Available | Notes |
| ---------------------- | --------- | -------------------------------------------------------------- |
| Company name | Yes | Current legal name from the entity detail page |
| Company status | Yes | Active / inactive with standing indicators |
| Registration date | Yes | Initial filing date |
| Legal address | Yes | Principal office address |
| Mailing address | Yes | Separate mailing address if different from principal office |
| Legal form | Yes | Entity type with domestic/foreign distinction |
| Formation jurisdiction | Yes | State or country of formation for foreign entities |
| Registered agent | Yes | Name and address returned as Other Key Person |
| Standing information | Yes | Annual Report, Registered Agent, and Dept. of Revenue standing |
| Legal representatives | No | Officers are not published on the TN SoS public portal |
| Activity codes | No | Not displayed on the public entity detail page |
| Shareholders | No | Not collected by the Tennessee business register |
| UBOs | No | No state beneficial-ownership register |
## Documents
### Available Documents
| Document | Availability | Format |
| -------------------------- | ---------------- | ------ |
| **Trade Register Extract** | Always available | PDF |
The Trade Register Extract is a printed capture of the TN SoS entity detail
page. It is included with the company data block at no extra charge.
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-TN&query=FEDEX" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "000060129",
"legalName": "FEDERAL EXPRESS CORPORATION",
"countryCode": "US-TN",
"matchReason": { "matchType": "default" }
}
]
```
### Search by Control Number
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-TN&query=000239194" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "000239194",
"legalName": "TOPOGRAPH TENNESSEE LLC",
"countryCode": "US-TN",
"matchReason": {
"matchType": "id",
"identifier": { "controlNumber": "000239194" }
}
}
]
```
### 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-TN", "id": "000239194", "dataPoints": ["company", "otherKeyPersons"]}'
```
```json theme={null}
{
"company": {
"id": "000239194",
"countryCode": "US-TN",
"identifiers": { "controlNumber": "000239194" },
"legalName": "TOPOGRAPH TENNESSEE LLC",
"registrationDate": "2021-03-15",
"status": {
"localName": "Active",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "Limited Liability Company (LLC)",
"englishTranslation": "Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"addressLine1": "123 Main Street",
"city": "Nashville",
"postalCode": "37201",
"region": "Davidson County",
"countryCode": "US",
"state": "Tennessee"
}
},
"otherKeyPersons": [
{
"type": "company",
"role": {
"localName": "Registered Agent",
"standardized": "Registered Agent"
},
"company": {
"countryCode": "US",
"legalName": "CT Corporation System",
"legalAddress": {
"addressLine1": "300 Montvue Road",
"city": "Knoxville",
"postalCode": "37919",
"region": "Knox County",
"countryCode": "US",
"state": "Tennessee"
}
}
}
]
}
```
### Available Documents
```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-TN", "id": "000239194", "dataPoints": ["availableDocuments"]}'
```
```json theme={null}
{
"documents": {
"tradeRegisterExtract": {
"id": "doc_tre_abc123",
"name": "Trade Register Extract",
"format": "pdf"
}
}
}
```