Texas Franchise Tax Account Status Scraper

Search the Texas Comptroller of Public Accounts' Franchise Tax Account Status registry — the official record of every business entity's right to transact business in Texas. Search by entity name, Comptroller taxpayer number, or Texas Secretary of State file number. Get registration status, registered agent, mailing and registered-office addresses, and officers/directors. HTTP-only via the Comptroller's own public data-search API — no login, no CAPTCHA, no proxy required.

What this actor does

• Three modes: byName, byTaxpayerNumber, bySosFileNumber
• Full record enrichment — name-search results are automatically enriched with the full account-status detail (registered agent, addresses, officers) unless disabled
• Officers & directors — every reported officer/director with their title, active year, and address
• Empty fields are omitted — a field only appears on a record when the registry actually has a value for it

Output per business

• entityName, dbaName
• taxpayerId — 11-digit Comptroller taxpayer number
• feiNumber — federal EIN, when on file
• mailingAddress, mailingAddressStreet, mailingAddressCity, mailingAddressState, mailingAddressZip
• rightToTransactTX — franchise tax right-to-transact status, e.g. ACTIVE, FRANCHISE TAX ENDED, FRANCHISE TAX INVOLUNTARILY ENDED, NOT ESTABLISHED
• rightToTransactActionUrl, rightToTransactActionText — when the entity has lapsed, the Comptroller's own "next step" link (e.g. request tax clearance to reinstate) and its label
• stateOfFormation
• sosRegistrationStatus, effectiveSosRegistrationDate
• sosFileNumber — Texas Secretary of State filing number
• registeredAgentName
• registeredOfficeAddress, registeredOfficeAddressStreet, registeredOfficeAddressCity, registeredOfficeAddressState, registeredOfficeAddressZip
• officers[] — {name, title, activeYear, address, source}, officerCount (source is CPA when reported on the entity's Public Information Report, or SOS when sourced from the Secretary of State filing)
• reportYear, lastUpdated
• sourceUrl — link to the official Comptroller account-status page
• recordType: "business", scrapedAt

Input

Field	Type	Default	Description
mode	string	byName	byName / byTaxpayerNumber / bySosFileNumber
entityName	string	walmart	Business name (2-50 chars, mode=byName)
taxpayerNumbers	array	–	11-digit Comptroller taxpayer numbers (mode=byTaxpayerNumber)
sosFileNumbers	array	–	Texas SOS file numbers (mode=bySosFileNumber)
fetchDetails	bool	true	Enrich name-search hits with the full detail record
maxOfficers	int	25	Cap on officers/directors per record (1-200)
maxItems	int	20	Hard cap on emitted records (1-500)

Example: search by name

{
  "mode": "byName",
  "entityName": "apple inc",
  "maxItems": 10
}

Example: lookup by taxpayer number

{
  "mode": "byTaxpayerNumber",
  "taxpayerNumbers": ["19424041101"]
}

Example: lookup by Texas SOS file number

{
  "mode": "bySosFileNumber",
  "sosFileNumbers": ["0004789806"]
}

Use cases

• Business verification — confirm an entity is in good standing before signing a contract
• Registered-agent research — find who a company's Texas registered agent is
• Compliance & KYC — check franchise tax right-to-transact status
• Corporate intelligence — pull officers/directors on file for a Texas entity
• Due diligence — verify a company's Texas SOS filing number and formation state

Data Source & Usage Notes

Data comes directly from the Texas Comptroller of Public Accounts' public "Franchise Tax Account Status Search" (comptroller.texas.gov/taxes/franchise/account-status/search), which itself publishes a documented public data-search API. No account, API key, or login is required. This is the same registry used to verify a business's legal standing to operate in Texas, functionally equivalent to a state Secretary of State business-entity search.

FAQ

Is this the same as the Texas Secretary of State's SOSDirect system? No — SOSDirect requires a paid subscription. This actor uses the Comptroller's free, public Franchise Tax Account Status registry, which cross-references the same SOS registration status, file number, and registered-agent data without any login.

What does "Right to Transact Business in Texas" mean? It reflects the entity's franchise tax standing. ACTIVE means the entity may legally transact business in Texas; values like FRANCHISE TAX ENDED or FRANCHISE TAX INVOLUNTARILY ENDED mean it has lost that right (usually for failing to file/pay franchise tax). When lapsed, the record also includes rightToTransactActionUrl/rightToTransactActionText — the Comptroller's own link for reinstating the entity.

Why do some records have no officers? Officer/director data is self-reported on the entity's most recent Public Information Report or Ownership Information Report. Sole proprietors, very new entities, or entities that haven't filed a report yet may have none on file.

Can I search by federal EIN? The name-search endpoint will match a federal EIN if it appears in the registry's indexed name field, but direct detail lookups require the 11-digit Texas Comptroller taxpayer number (not the 9-digit FEIN).

How fresh is the data? SOS registration status is described by the Comptroller as updated each business day; other fields reflect the entity's most recently filed franchise tax report.

Is there a limit on name searches? The registry itself caps very broad name searches (e.g. a single common word) and asks you to refine the query — the actor surfaces that message via the run's status rather than failing silently.