Skip to main content

​
Table of Contents

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

​
Data Sources

Texas uses two complementary data sources from the Texas Comptroller of Public Accounts, both accessed via the same API key. The underlying data matches the Comptroller’s open datasets published on data.texas.gov.
  • Franchise Tax API (primary source). Covers entities set up for franchise tax under Tax Code Chapter 171: corporations, LLCs, LPs, LLPs, professional associations, and other entities doing business in Texas. ~3.4M taxpayers. Provides company name, registered office address, SOS registration status, state of formation, officer/director information, and registered agent details. Equivalent open dataset: Active Franchise Tax Permit Holders.
  • Sales Tax Payer API (fallback + establishments). Covers holders of a sales tax permit under Tax Code Chapter 151, Subchapter F. This includes any person or entity authorized to collect sales tax on tangible personal property, including sole traders. Provides business name, individual name (for sole traders), address, permit status, and outlet locations (establishments) with addresses and permit dates. Equivalent open dataset: Active Sales Tax Permit Holders.
Texas is a non-authoritative, fast source. The Comptroller’s tax system is not the official corporate registry (that’s the Texas Secretary of State).
Dual-source routing: The system tries franchise tax first (richer data with officers and registered agent). If the entity is not found in franchise tax (sole traders, entities not set up for franchise tax), it falls back to sales tax data automatically. Establishments are fetched from the sales tax endpoint for both paths.
Entity coverage varies by source. Franchise tax (Chapter 171) covers corporations, LLCs, LPs, LLPs, and professional associations. The sales tax endpoint covers holders of a sales tax permit (Chapter 151, Subchapter F): any person or entity selling tangible goods, including sole traders. Businesses that only provide services (consultants, lawyers, SaaS) typically don’t hold a permit and won’t appear in either source.

​
Company Identifiers

​
Query Identifiers

Identifier TypeFormatExampleNotes
Taxpayer Number11 digits17307175087Texas Comptroller’s primary identifier
Federal EIN9 digits730717508IRS-assigned Employer Identification Number
SOS File Number6-10 digits0003077806Secretary of State registration number
Which identifier to use? For search, any identifier works — 11-digit Taxpayer Number, 9-digit EIN, or SOS File Number. For company profile, you must use the 11-digit Taxpayer Number returned in the search result id field. The detail API only accepts this format.
Search first, then fetch. The EIN and SOS File Number only work for search. To retrieve company data, use the id from the search result (always the 11-digit Taxpayer Number). Passing an EIN or SOS File Number directly to the company profile endpoint will fail.

​
Identifiers in API Response

IdentifierFormatExampleFound In
taxpayerId11 digits17307175087All entities
feiNumber9 digits730717508Most entities
sosFileNumber10 digits0003077806All entities
stateOfFormation2-letterTX, NJ, DEAll entities
sosRegistrationStatusTextACTIVEAll entities

​
Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By Taxpayer Number11 digits17307175087ExactSingle company
By Federal EIN9 digits730717508ExactSingle company
By SOS File Number6-8 or 10 digits0003077806ExactSingle company
By Name2-50 chars"EXXON MOBIL"FuzzyMultiple results
9-digit ambiguity. A 9-digit input is treated as a Federal EIN (sent as taxpayerId). If you need to search by a 9-digit SOS File Number specifically, this is not currently disambiguated — the EIN interpretation takes priority.
Name search is prefix-based. Searching for "TOPOGRAPH" returns all entities whose name starts with or contains that string, including TOPOGRAPHIC OM, INC., TOPOGRAPH LLC, etc.

​
Quirks & Gotchas

QuirkDetails
Non-authoritative sourceThis is the franchise tax system, not the official SOS corporate registry.
Company profile requires 11-digit Taxpayer NumberThe detail API only accepts the 11-digit Taxpayer Number. EIN and SOS File Number work for search only. Always use the id from search results to fetch company data.
No sole proprietors in franchise taxSole proprietors are exempt from franchise tax. They are covered via the sales tax fallback and identified by the IS org type code from SODA3.
No legal form in live APIThe Comptroller live API does not return entity type. Legal form comes from the SODA3 open data taxpayer_organizational_type code, with name-suffix extraction as fallback.
Officer titles truncatedTitles are cut to ~10 characters. VICE PRESIDENT becomes VICE PRESI, MANAGING MEMBER becomes MANAGING MEMB. Handled by AI batch enrichment.
HTML entities in titlesSome titles contain & instead of & (e.g., PRES & CEO). Decoded automatically.
Leading spaces in statestateOfFormation has a leading space (e.g., TX). Trimmed automatically.
Missing detail for some entitiesSome entities appear in search but return “not set up for Franchise Tax” on the detail endpoint. These are entities that exist in the SOS system but aren’t tracked by the Comptroller.
Registered agent is not a legal representativePer BOC §5.206, the registered agent’s only duty is to receive and forward legal process served on the entity. They have no authority to act for the company. Mapped as Other Key Person.
Two address typesThe API returns both mailing address and registered office address. We use the registered office as legalAddress because it’s the official address of record.
Two status fieldsrightToTransactTX = franchise tax standing only. sosRegistrationStatus = actual corporate status from SOS. We use SOS status as the company status.
Officer data depends on report filingOfficer/director information comes from franchise tax annual reports. Entities that have never filed a report (reportYear empty) will have zero officers returned — regardless of formation state, entity type, or SOS status. This includes some large active companies (e.g., SpaceX, Amazon.com) that may file under a different entity.

​
Mappings

​
Company Status

Status is derived from sosRegistrationStatus (Secretary of State), not from rightToTransactTX (franchise tax standing).
Source ValueMapped StatusActive
ACTIVEActivetrue
INACTIVEINACTIVEfalse
Other valuesAs-isfalse
Legal form is determined from the Comptroller’s taxpayer_organizational_type code, a closed 2-letter set defined in the Franchise Layout record layout. This data is fetched from the SODA3 open data API in parallel with the Comptroller live API. It distinguishes domestic vs foreign entities (e.g. CT Texas Profit Corporation vs CF Foreign Profit Corporation) and covers types not detectable from entity names (nonprofits, associations, trusts, joint ventures). Falls back to name-suffix extraction (BOC §5.054-§5.063) when the SODA3 lookup returns no result.
CodeLegal FormStandardizedISO 20275
CLTexas Limited Liability CompanyLimited Liability CompanyWYG5
CIForeign Limited Liability CompanyLimited Liability CompanyWYG5
CTTexas Profit CorporationCorporationC5K7
CFForeign Profit CorporationCorporationC5K7
CPTexas Professional CorporationCorporation9AAS
CUForeign Professional CorporationCorporation9AAS
CNTexas Non-Profit CorporationNon-Profit OrganizationOGSS
CMForeign Non-Profit CorporationNon-Profit Organization
PLTexas Limited PartnershipPartnershipFE1L
PFForeign Limited PartnershipPartnership
PBBusiness General PartnershipPartnership
APTexas Professional AssociationCorporationMXWB
AFForeign Professional AssociationCorporation
TRTrustTrust
ISSole Proprietorship (Individual)Sole Proprietorship
ISO 20275 (ELF) codes are from the GLEIF US-TX jurisdiction list.

​
Activity Codes

NAICS codes are sourced from the SODA3 open data API. ISIC Rev.4 and NACE Rev.2 codes are derived from NAICS via the US Census Bureau concordance table (2022 NAICS to ISIC Rev.4, with 2017 fallback for reorganized codes). NACE Rev.2 is identical to ISIC Rev.4 at the 4-digit level.
SystemSourceExample
NAICSSODA3 open data (franchise or sales tax dataset)541330 (Engineering Services)
ISIC Rev.4US Census concordance from NAICS7110 (Architectural and engineering activities)
NACE Rev.2Identical to ISIC at 4-digit level7110

​
Officer Roles

Officers are split into Legal Representatives (statutory authority to bind the company under Texas BOC) and Other Key Persons (operational, financial, or governance roles). Officer titles come from franchise tax annual reports filed with the Comptroller. The API exposes these as a free-text field, frequently truncated to ~10 characters (e.g. “VICE PRESI”, “GENERAL PA”, “CHIEF ADMI”) and sometimes containing HTML entities (“PRES & CEO”). Because there is no closed list of possible titles, the classification is AI-enriched: all titles for a company are sent in a single batch to an AI classifier with Texas-specific corporate law instructions (BOC §3.101 for corporate officers, §101.254 for LLC managers, §153.152 for LP general partners). The AI translates truncated titles, standardizes them, and determines whether each role carries statutory binding authority. Registered agents are always classified as Other Key Persons (BOC §5.206: their only duty is to receive and forward legal process).
TitleStandardizedNotes
CHAIRMANBoard MemberOversight only in Texas
ASSISTANT SECRETARY, ASECRETARYSecretaryDelegated, no independent authority
APPOINTED ASSISTANT SECRETARYSecretaryDelegated, no independent authority
TREASURERTreasurerFinancial role
CFO, CHIEF FINANCIAL OFFICERChief Financial Officer
COOChief Operating Officer
CTOChief Technology Officer
CHIEF ADMINISTRATIVE OFFICEROther
SENIOR VICE PRESIDENT, SVPOtherOperational seniority
EXECUTIVE VICE PRESIDENT, EVPOtherOperational seniority
CONTROLLEROtherFinancial staff
LIMITED PARTNER, PARTNER, MEMBEROtherNo management authority
AUDITORAuditor
REGISTERED AGENTOtherReceives and forwards legal process only (BOC §5.206)
These tables list commonly observed titles. Because the API uses a free-text field, new or uncommon titles may appear. The AI classifier handles unknown titles based on Texas corporate law context, defaulting to Other Key Person when in doubt.

​
Data Availability

Data PointAvailableNotes
Company nameYesLegal name + DBA (commercial name) if registered
Company statusYesFrom SOS registration status
Registration dateYesSOS effective registration date
Legal addressYesRegistered office address
Legal formYesFrom Comptroller organizational type code (SODA3 open data). 29 entity types with domestic/foreign distinction. Falls back to name-suffix extraction.
Activity codesYesNAICS code from SODA3 open data, with ISIC Rev.4 and NACE Rev.2 derived via US Census concordance table.
Share capitalNoNot provided
Legal representativesYes*Officers with statutory authority (President, Director, etc.). Franchise tax entities only — sole traders have none.
Other key personsYes*Treasurer, CFO, Chairman, Registered Agent, etc. Franchise tax entities only.
EstablishmentsYesBranch/location data from sales tax permits with addresses and permit dates
ShareholdersNoNot available from this source
UBOsNoNot available from this source
DocumentsNoAPI provides data only, no downloadable documents
Financial dataNoNot provided

​
Example API Responses

​
Search by Name

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

[
  {
    "id": "17307175087",
    "legalName": "TOPOGRAPHIC OM, INC.",
    "countryCode": "US-TX",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "postalCode": "76126",
      "countryCode": "US"
    }
  }
]

​
Company Profile (Onboarding Mode)

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-TX", "id": "17307175087", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"], "mode": "onboarding"}'

{
  "company": {
    "id": "17307175087",
    "countryCode": "US-TX",
    "identifiers": {
      "feiNumber": "730717508",
      "taxpayerId": "17307175087",
      "sosFileNumber": "0003077806",
      "stateOfFormation": "OK",
      "sosRegistrationStatus": "ACTIVE"
    },
    "legalName": "TOPOGRAPHIC OM, INC.",
    "registrationDate": "1970-09-16",
    "status": {
      "localName": "Active",
      "active": true
    },
    "legalForm": {
      "localName": "Foreign Profit Corporation",
      "englishTranslation": "Corporation (Foreign)",
      "standardized": "Corporation",
      "iso20275Code": "C5K7"
    },
    "activities": {
      "NAICS": [{ "code": "541330", "description": "Engineering Services", "isAIInferred": false }],
      "ISIC": [{ "code": "7110", "description": "Architectural and engineering activities and related technical consultancy", "isAIInferred": false }],
      "NACE": [{ "code": "7110", "description": "Architectural and engineering activities and related technical consultancy", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "211 E. 7TH STREET SUITE 620",
      "city": "AUSTIN",
      "postalCode": "78701",
      "region": "TX",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": {
        "localName": "PRESIDENT",
        "englishTranslation": "President",
        "standardized": "President"
      },
      "individual": {
        "name": { "fullName": "BRIAN KRAFFT" },
        "residenceAddress": {
          "addressLine1": "5229 EAST VERDE CIRCLE",
          "city": "BENBROOK",
          "postalCode": "76126",
          "region": "TX",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "individual",
      "role": {
        "localName": "VICE PRESI",
        "englishTranslation": "Vice President",
        "standardized": "Vice President"
      },
      "individual": {
        "name": { "fullName": "J ROBERT KEATING" },
        "residenceAddress": {
          "addressLine1": "6040 LAKESIDE DRIVE",
          "city": "FORT WORTH",
          "postalCode": "76179",
          "region": "TX",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "individual",
      "role": {
        "localName": "SECRETARY",
        "englishTranslation": "Secretary",
        "standardized": "Secretary"
      },
      "individual": {
        "name": { "fullName": "SHARON L KEATING" },
        "residenceAddress": {
          "addressLine1": "6040 LAKESIDE DRIVE",
          "city": "FORT WORTH",
          "postalCode": "76179",
          "region": "TX",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "individual",
      "role": {
        "localName": "DIRECTOR",
        "englishTranslation": "Director",
        "standardized": "Director"
      },
      "individual": {
        "name": { "fullName": "WILLIAM KEATING" },
        "residenceAddress": {
          "addressLine1": "903 PRINCETON AVE",
          "city": "MIDLAND",
          "postalCode": "79701",
          "region": "TX",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "individual",
      "role": {
        "localName": "VICE PRESI",
        "englishTranslation": "Vice President",
        "standardized": "Vice President"
      },
      "individual": {
        "name": { "fullName": "WILLIAM KEATING" },
        "residenceAddress": {
          "addressLine1": "903 PRINCETON AVE",
          "city": "MIDLAND",
          "postalCode": "79701",
          "region": "TX",
          "countryCode": "US"
        }
      }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "individual",
      "role": {
        "localName": "TREASURER",
        "englishTranslation": "Treasurer",
        "standardized": "Treasurer"
      },
      "individual": {
        "name": { "fullName": "SHARON L KEATING" },
        "residenceAddress": {
          "addressLine1": "6040 LAKESIDE DRIVE",
          "city": "FORT WORTH",
          "postalCode": "76179",
          "region": "TX",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "company",
      "role": {
        "localName": "Registered Agent",
        "standardized": "Other"
      },
      "company": {
        "countryCode": "US",
        "legalName": "CORPORATION SERVICE COMPANY D/B/A CSC-LAWYERS INCO",
        "legalAddress": {
          "addressLine1": "211 E. 7TH STREET SUITE 620",
          "city": "AUSTIN",
          "postalCode": "78701",
          "region": "TX",
          "countryCode": "US"
        }
      }
    }
  ]
}

​
Sole Trader (Sales Tax Fallback)

Sole traders are not in the franchise tax system. Data comes from the sales tax payer API. 
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-TX", "id": "32008802830", "dataPoints": ["company", "establishments"], "mode": "onboarding"}'

{
  "company": {
    "id": "32008802830",
    "countryCode": "US-TX",
    "identifiers": {
      "taxpayerId": "32008802830"
    },
    "legalName": "DAVID MARTINEZ, JR",
    "status": {
      "localName": "Active",
      "active": true
    },
    "legalForm": {
      "localName": "Sole Proprietorship",
      "englishTranslation": "Sole Proprietorship (Individual)",
      "standardized": "Sole Proprietorship"
    },
    "activities": {
      "NAICS": [{ "code": "561740", "description": "Carpet and Upholstery Cleaning Services", "isAIInferred": false }],
      "ISIC": [{ "code": "9601", "description": "Washing and (dry-) cleaning of textile and fur products", "isAIInferred": false }],
      "NACE": [{ "code": "9601", "description": "Washing and (dry-) cleaning of textile and fur products", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "12567 SOMERSET RD",
      "city": "VON ORMY",
      "postalCode": "78073",
      "region": "TX",
      "countryCode": "US"
    }
  },
  "establishments": [
    {
      "name": "CASTILLO'S ICE HOUSE",
      "creationDate": "1999-12-24",
      "endDate": "2008-09-01",
      "active": false,
      "address": {
        "addressLine1": "346 E QUILL DR",
        "city": "SAN ANTONIO",
        "postalCode": "78228",
        "region": "TX",
        "countryCode": "US"
      }
    },
    {
      "name": "CARPET MASTERS",
      "creationDate": "2008-05-01",
      "active": true,
      "address": {
        "addressLine1": "346 E QUILL DR",
        "city": "SAN ANTONIO",
        "postalCode": "78228",
        "region": "TX",
        "countryCode": "US"
      }
    }
  ]
}
Sole traders are identified by the IS (Individual Sole Owner) organizational type code from the SODA3 open data API. No officers or registered agent data is available for sole traders.