Start here
This guide contains public integration notes for Texas. 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.Texas coverage, pricing, and sources
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
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
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Data Availability
- Documents
Data Sources
Texas uses three data sources depending on the request mode and entity type. Texas Comptroller of Public Accounts (onboarding mode)- 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.
In onboarding mode, franchise tax is tried first (richer data with officers
and registered agent). If the entity is not found there (sole traders,
entities not set up for franchise tax), it falls back to sales tax
automatically. Establishments are always fetched from the sales tax endpoint.
Company Identifiers
Query Identifiers
Identifiers in API Response
Search Capabilities
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
Mappings
Company Status
Onboarding mode usessosRegistrationStatus from the Comptroller (which mirrors the SOS), not rightToTransactTX (franchise tax standing).
Verification mode reads entity status directly from the Secretary of State.
Legal Forms
Legal form is sourced differently depending on the request mode. Onboarding mode uses the Comptroller’staxpayer_organizational_type code, a closed 2-letter set defined in the Franchise Layout record layout, fetched from the Comptroller open data API. It distinguishes domestic vs foreign entities (e.g. CT Texas Profit Corporation vs CF Foreign Profit Corporation) and covers types not detectable from names (nonprofits, associations, trusts, joint ventures). Falls back to name-suffix extraction (BOC §5.054-§5.063) when the open data lookup returns no result.
Verification mode uses the entity type field from the Secretary of State register directly. The SOS uses the full English description from the Texas Business Organizations Code — a closed set of 24 types organized as Domestic/Foreign pairs (e.g. “Domestic Limited Liability Company (LLC)”, “Foreign For-Profit Corporation”). Source: Texas BOC forms index.
Onboarding: Comptroller organizational type codes
Onboarding: Comptroller organizational type codes
Verification: Secretary of State entity types (24 types from Texas BOC)
Verification: Secretary of State entity types (24 types from Texas BOC)
Domestic entities are formed under Texas law; foreign entities are registered to do business in Texas. The parenthetical abbreviation (LLC), (LP), (PLLC) is part of the official SOS display string.
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.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). In onboarding mode, titles come from franchise tax annual reports via the Comptroller. They are a free-text field, frequently truncated to ~10 characters (e.g. “VICE PRESI”, “GENERAL PA”) and sometimes containing HTML entities (“PRES & CEO”). Because there is no closed list, classification is AI-enriched: all titles for a company are sent in a 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 completes truncated titles, standardizes them, and determines binding authority. In verification mode, titles come directly from the Secretary of State Management tab as the full string as filed (e.g. “VICE PRESIDENT”, “MANAGING MEMBER”). AI enrichment is still applied for standardization, but truncation is not a factor. Registered agents are always classified as Other Key Persons (BOC §5.206: their only duty is to receive and forward legal process).Common Legal Representative titles -- can bind the company
Common Legal Representative titles -- can bind the company
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
Documents
Information Letter
The Information Letter is an official document issued by the Texas Secretary of State confirming entity status, original filing date, registered agent name and address, and duration. It is the closest equivalent to a trade register extract for Texas.Sales Tax Permit
The Sales Tax Permit is the official Comptroller record confirming permit status, mailing address, and all outlet locations. For sole traders it is the primary official government record confirming their business registration.Example API Responses
Search by Name
Company Profile (Onboarding Mode)
Sole Trader (Sales Tax Fallback)
Sole traders are not in the franchise tax system. Data comes from the sales tax payer API.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.