Skip to content
    ↑↓ to choose · Enter to open

    · 12 min read

    Texas Franchise Tax Account Status Scraper: 28 Data Fields per Record

    By CrawlerBros Engineering Team

    Each record carries 28 output fields, including the franchise tax right-to-transact status, registered agent name, and officer listings directly from the Texas Comptroller. You can query the registry using business names, 11-digit taxpayer IDs, or Secretary of State file numbers without needing a login or CAPTCHA solving. A thousand results cost $5.00 on Apify's free plan, which can be tried at no cost. This is built for compliance officers and legal professionals who need to verify a business's legal standing to operate in Texas; it is not for those who need images of original paper filings.

    Try it: open Texas Franchise Tax Account Status Scraper on Apify, sign in on the free plan and run the prefilled example.

    Can you try Texas Franchise Tax Account Status Scraper before paying?

    Yes. Apify's free plan includes $5.00 of prepaid usage every month and asks for no credit card. At $0.005 per result, that covers up to 1,000 results of Texas Franchise Tax Account Status Scraper a month, before run-start charges and platform usage.

    The example request further down caps maxOfficers at 25, so a first run returns at most 25 results and costs at most $0.125 in result charges. That is enough to see the real shape of the data before deciding anything.

    Texas Franchise Tax Account Status Scraper was last updated on 2026-07-22. It is one of 1,725 Actors CrawlerBros publishes on Apify, which together have 680,173 lifetime public runs and an average rating of 4.63 out of 5 across 416 reviews.

    What does it cost to run Texas Franchise Tax Account Status Scraper?

    Each result costs $0.005 on Apify's free plan, which is $5.00 per 1,000 results. Starting a run is charged separately at $0.005 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

    Apify plan Per result Per 1,000 results
    FREE $0.005 $5.00
    BRONZE $0.00433 $4.33
    SILVER $0.00367 $3.67
    GOLD $0.003 $3.00
    PLATINUM $0.003 $3.00
    DIAMOND $0.003 $3.00

    The maxItems control is the primary driver of your bill because result charges apply only to items successfully written to the dataset. To minimize costs while testing your query parameters, set maxItems to 1 to verify the schema before processing a long list of taxpayer numbers.

    How do you run Texas Franchise Tax Account Status Scraper from the API?

    The schema marks 1 of its 7 controls as required: mode. The payload below uses the schema's own prefilled values, so it runs as written once you substitute your API token.

    Call the synchronous endpoint to start a run and receive dataset items in one request:

    curl -X POST "https://api.apify.com/v2/acts/crawlerbros~texas-franchise-tax-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"byName","entityName":"walmart","taxpayerNumbers":[],"sosFileNumbers":[],"fetchDetails":true,"maxOfficers":25,"maxItems":20}'

    The same run from Python, using the official client:

    from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
  "mode": "byName",
  "entityName": "walmart",
  "taxpayerNumbers": [],
  "sosFileNumbers": [],
  "fetchDetails": True,
  "maxOfficers": 25,
  "maxItems": 20
}

run = client.actor("crawlerbros~texas-franchise-tax-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

    And from Node.js:

    import { ApifyClient } from 'apify-client'

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })

const input = {
  "mode": "byName",
  "entityName": "walmart",
  "taxpayerNumbers": [],
  "sosFileNumbers": [],
  "fetchDetails": true,
  "maxOfficers": 25,
  "maxItems": 20
}

const run = await client.actor('crawlerbros~texas-franchise-tax-scraper').call(input)
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)

    The synchronous endpoint holds the connection open until the run finishes, which is convenient for small batches and wrong for large ones. For anything long running, start the run asynchronously and poll, or attach a webhook, so a dropped connection does not cost you the results.

    Which Texas Franchise Tax Account Status Scraper inputs matter, and which can you skip?

    The mode control is the most important setting, as it determines whether the Actor searches by name or performs an exact lookup using taxpayerNumbers or sosFileNumbers. Most users should leave fetchDetails enabled to ensure the scraper collects the full registered agent and officer data rather than just a summary.

    • mode (string): What to search by. Default: "byName".
    • entityName (string): Business name to search for (2-50 characters). Partial/starts-with matches are returned by the registry. Default: "walmart".
    • taxpayerNumbers (array): 11-digit Texas Comptroller taxpayer numbers. Default: [].
    • sosFileNumbers (array): Texas Secretary of State filing numbers. Default: [].
    • fetchDetails (boolean): When mode=byName, fetch the full account-status record (registered agent, addresses, officers) for each match instead of just the name/taxpayer ID summary. Adds one extra request per match. Default: true.
    • maxOfficers (integer): Cap on how many officers/directors to include per business record. Default: 25.
    • maxItems (integer): Hard cap on emitted records. Default: 20.

    Fixed-choice controls: mode accepts byName (Search by entity name), byTaxpayerNumber (Lookup by Comptroller taxpayer number), bySosFileNumber (Lookup by Texas SOS file number).

    What does Texas Franchise Tax Account Status Scraper return?

    The output provides a clear rightToTransactTX status that indicates if a business is legally active, alongside registered agent addresses and officer titles. It does not include private financial statements or personal contact information like phone numbers for the listed officers.

    • 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

    These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

    How do you build the workflow end to end?

    Open Texas Franchise Tax Account Status Scraper and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

    1. Set the mode control to byName, byTaxpayerNumber, or bySosFileNumber to define your search criteria.
    2. Enter a business name into entityName if searching by name, or provide lists of IDs in taxpayerNumbers or sosFileNumbers for exact lookups.
    3. Ensure fetchDetails is enabled when using name-search mode to ensure the scraper retrieves the registered agent and officer details for each hit.
    4. Define maxOfficers to limit the number of directors or officials returned per record to keep the dataset size manageable.
    5. Set maxItems to a small number like 5 for an initial run to verify the output format before running a larger list of identifiers.
    6. Execute the run and check the console logs to see if the registry requires a more specific search term for broad name queries.
    7. Examine the dataset for the rightToTransactTX field to confirm the legal standing of the retrieved entities.

    How do you apply it? Three worked playbooks

    These are Texas Franchise Tax Account Status Scraper's own documented use cases, each worked through as an operating pattern rather than a description.

    Use case 1: Business verification

    Outcome: Confirm an entity is in good standing before signing a contract

    Configure: Set mode to "byName", entityName to "walmart", and fetchDetails to true.

    Working method: Run a name search to find the correct entity, then inspect the rightToTransactTX field to verify it shows the entity is authorized to operate.

    Deliverable: A data record containing the verified franchise tax status and the official source URL for legal proof.

    Stop condition: The rightToTransactTX field returns a status indicating the tax right has ended or was never established.

    Use case 2: Registered-agent research

    Outcome: Find who a company's Texas registered agent is

    Configure: Set mode to "byTaxpayerNumber" and taxpayerNumbers to ["19424041101"].

    Working method: Perform a direct lookup using the 11-digit taxpayer number and extract the registeredAgentName and registeredOfficeAddress fields from the result.

    Deliverable: A report identifying the specific individual or entity designated to receive legal service for the business.

    Stop condition: The returned record contains no data in the registeredAgentName field.

    Use case 3: Compliance & KYC

    Outcome: Check franchise tax right-to-transact status

    Configure: Set mode to "bySosFileNumber" and sosFileNumbers to ["0004789806"].

    Working method: Lookup the entity by its Secretary of State file number to retrieve its official SOS registration status and franchise tax standing simultaneously.

    Deliverable: A JSON record showing the effective SOS registration date and the current franchise tax right-to-transact status.

    Stop condition: The sosRegistrationStatus field indicates the entity is no longer in an active registration state.

    What breaks, and how do you design around it?

    When searching by name, the registry may block overly broad queries; refine your search terms if you encounter a prompt to narrow your results. If officer data is missing, the entity may be a sole proprietorship or a new business that has not yet filed its first Public Information Report.

    When should you not use Texas Franchise Tax Account Status Scraper?

    Do not use this scraper if you need to access corporate records from states other than Texas or if you require original PDF copies of business filings. For Florida entities, use Florida Sunbiz Business Entity Search Scraper. If your research focuses on individual professional licenses like HVAC or cosmetology rather than corporate tax accounts, the TDLR Texas License Search Scraper is the appropriate alternative.

    What should you check before trusting the output?

    • Verify that rightToTransactTX contains a value such as ACTIVE or FRANCHISE TAX ENDED for every record.
    • Confirm taxpayerId is a valid 11-digit string for all business records in the dataset.
    • Check that sourceUrl contains a valid link back to the official Comptroller account-status page.
    • Validate that registeredAgentName is present when the entity is expected to have a registered agent on file with the Secretary of State.
    • Monitor for status messages indicating the registry has capped a broad name search, which may require refining the entityName input.

    None of this proves a record is correct. It gives a scheduled Texas Franchise Tax Account Status Scraper run defined points where it should stop instead of quietly passing bad data downstream.

    Frequently asked questions

    What is the price for 1,000 results?

    On the free-plan price, you pay $5.00 per 1,000 results. Since Apify's free plan includes $5.00 of monthly usage, you can extract up to 1,000 records without a credit card. Keep in mind that platform usage is billed separately on top of the $0.005 per-result charge.

    How often is the Texas business data updated?

    The Texas Comptroller describes Secretary of State registration status as being updated each business day. Other details, such as the list of officers and directors, reflect the information provided in the entity's most recently filed franchise tax report.

    Can I search the Comptroller registry by federal EIN?

    Direct lookups require the 11-digit Texas taxpayer number or the SOS file number. While a 9-digit federal EIN might occasionally trigger a match in name-search mode if it is indexed in the name field, this is not a reliable method for EIN-based discovery.

    Why do some Texas businesses show no officers?

    Officer and director information is self-reported via Public Information Reports. If a business is very new, is a sole proprietorship, or has failed to file its required tax reports, the registry may not have any officer data to return.

    What does it mean if a status is 'Involuntarily Ended'?

    This status indicates the business has lost its legal right to transact in Texas, typically due to tax delinquency or failure to file reports. The scraper returns the Comptroller's specific action URL and text to help identify how the entity can be reinstated.

    Where to go next

    When you are ready to run it, open Texas Franchise Tax Account Status Scraper on Apify; the free plan covers up to 1,000 results a month.

    Other Actors we maintain for related data:

    Related guides:

    Resources

    • Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-26.

    • Actor last updated by its maintainers on 2026-07-22.

    • Run outcome figures cover the 30 day public window ending 2026-09-26.

    • Texas Franchise Tax Account Status Scraper on Apify

    Featured actors

    Texas Franchise Tax Account Status Scraper

    Search Texas Comptroller's Franchise Tax Account Status registry by entity name, taxpayer number, or SOS file number. Get registration status, registered agent, addresses, and officers. No login required.

    Run on Apify ↗