Skip to main content

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.

​
Table of Contents

​
Data Sources

All entity data comes from the Tennessee Secretary of State — Business Services Division via the TN CAB portal (tncab.tnsos.gov). 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 TypeFormatExampleNotes
Control Number9-digit zero-padded integer000239194Primary 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

IdentifierFormatExampleFound In
controlNumberNNNNNNNNN000239194All entities

​
Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By Name2–200 chars"Tennessee Energy LLC"Starts withMultiple results
By Control Number1–9 digits000239194ExactSingle company
Name search matches from the beginning of the entity name (starts-with). For broader matches, use shorter prefixes.

​
Quirks & Gotchas

QuirkDetails
No officers publishedThe 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 APITennessee does not offer bulk corporate data exports or a public REST API. Every lookup is resolved live against the SoS portal.
No activity codesIndustry classification codes are tracked internally by TN SoS but are not displayed on the public entity detail page.
Standing fieldsThe entity detail page shows three standing indicators: Annual Report, Registered Agent, and Department of Revenue. These appear in statusDetails.
Control Number zero-paddingControl 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 ValueActiveNotes
ActivetrueEntity is in good standing
Active - DissolvedtrueEntity is dissolving but still active
DissolvedfalseVoluntary or administrative dissolution
RevokedfalseRevocation by the Secretary of State
WithdrawnfalseForeign entity withdrew its registration
CancelledfalseRegistration cancelled
MergedfalseEntity merged into another entity
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.

​
Other Key Persons

RoleStandardizedNotes
Registered AgentRegistered AgentStatutory service-of-process contact, required for all entities

​
Data Availability

Data PointAvailableNotes
Company nameYesCurrent legal name from the entity detail page
Company statusYesActive / inactive with standing indicators
Registration dateYesInitial filing date
Legal addressYesPrincipal office address
Mailing addressYesSeparate mailing address if different from principal office
Legal formYesEntity type with domestic/foreign distinction
Formation jurisdictionYesState or country of formation for foreign entities
Registered agentYesName and address returned as Other Key Person
Standing informationYesAnnual Report, Registered Agent, and Dept. of Revenue standing
Legal representativesNoOfficers are not published on the TN SoS public portal
Activity codesNoNot displayed on the public entity detail page
ShareholdersNoNot collected by the Tennessee business register
UBOsNoNo state beneficial-ownership register

​
Documents

​
Available Documents

DocumentAvailabilityFormat
Trade Register ExtractAlways availablePDF
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

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

[
  {
    "id": "000060129",
    "legalName": "FEDERAL EXPRESS CORPORATION",
    "countryCode": "US-TN",
    "matchReason": { "matchType": "default" }
  }
]

​
Search by Control Number

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

[
  {
    "id": "000239194",
    "legalName": "TOPOGRAPH TENNESSEE LLC",
    "countryCode": "US-TN",
    "matchReason": {
      "matchType": "id",
      "identifier": { "controlNumber": "000239194" }
    }
  }
]

​
Company Profile

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"]}'

{
  "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

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"]}'

{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_tre_abc123",
      "name": "Trade Register Extract",
      "format": "pdf"
    }
  }
}