Texas Comptroller Business Entity & Officer Search Scraper

Here is one real result, with every field the actor returns:

{
  "taxpayerId": "17104151885",
  "name": "WALMART INC.",
  "dbaName": null,
  "feiNumber": "710415188",
  "rightToTransactTexas": "ACTIVE",
  "sosRegistrationStatus": "ACTIVE",
  "sosFileNumber": "0003668006",
  "effectiveSosRegistrationDate": "10/29/1974",
  "stateOfFormation": "DE",
  "reportYear": "2019",
  "mailingAddressStreet": "702 SW 8TH ST DEPT 8687",
  "mailingAddressCity": "BENTONVILLE",
  "mailingAddressState": "AR",
  "mailingAddressZip": "72716",
  "registeredAgentName": "C T CORPORATION SYSTEM",
  "registeredOfficeAddressStreet": "1999 BRYAN ST., STE. 900",
  "registeredOfficeAddressCity": "DALLAS",
  "registeredOfficeAddressState": "TX",
  "registeredOfficeAddressZip": "75201",
  "officerCount": 463,
  "officers": "AANAN CONTRACTOR | VICE PRESI | 702 SW 8TH STREET BENTONVILLE, AR 72716 | (2019)\nADAM CAIRNS | VICE PRESI | 702 SW 8TH STREET BENTONVILLE, AR 72716 | (2019) ... [officers list trimmed for brevity; the real field returns all 463 officers]",
  "firstOfficerName": "AANAN CONTRACTOR",
  "firstOfficerTitle": "VICE PRESI",
  "matchedBy": "name",
  "matchedQuery": "WALMART",
  "source": "texas-comptroller-franchise-tax-account-status",
  "observedAt": "2026-08-11T11:13:02.982Z"
}

The officers value above is trimmed to keep this example readable; the actor returns all 463 officer rows. All other values are the exact record from a live run.

The most complete Texas Comptroller business-entity scraper available. It returns every field the franchise-tax account-status record exposes, including the taxpayer and SOS file numbers, right-to-transact and SOS status, mailing and registered-office addresses, the registered agent, and the full officers/directors block from the Public Information Report, and it lets you look entities up by name, taxpayer number, or SOS file number.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the Texas Comptroller franchise-tax account-status system by entity name, taxpayer number, or SOS file number, merges and de-duplicates results across searches, and writes one normalized record per entity to the run's dataset. With withDetails on (the default) it fetches each entity's full account status: the registered agent, SOS registration status and date, mailing and registered-office addresses, and the complete officers/directors block from the Public Information Report (PIR Form 05-102), flattened into an easy-to-read officers string plus officerCount and the first officer's name and title. Missing source values are returned as null rather than invented.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 30 entities matching WALMART with full agent and officer details.

{
  "names": ["WALMART"],
  "maxEntities": 30,
  "withDetails": true
}

Every input field is optional. Search by names, or look up a single entity by taxpayerId or fileNumber.

Input reference

Field	Type	Required	Default	Description
names	string[]	no	["WALMART"]	One or more business/entity names to search (2 to 50 characters each). Each name runs its own search; results are merged and de-duplicated.
taxpayerId	string	no	(empty)	Exact 11-digit Texas taxpayer number (or 9-digit FEI/EIN) to look up a single entity.
fileNumber	string	no	(empty)	Texas Secretary of State file number (6 to 10 digits) to look up a single entity.
withDetails	boolean	no	true	Fetch each entity's full account status: registered agent, SOS status, and the officers/directors block. Off returns name/number only.
maxEntities	integer	no	30	Maximum number of entities to return across the whole run.

Output reference

One dataset item per entity. Types: string, integer, or null when the source value is absent.

Field	Type	Description
taxpayerId	string	11-digit Texas taxpayer number (unique per entity).
name	string	Legal entity name.
dbaName	string	Doing-business-as name when published, or null.
feiNumber	string	Federal Employer Identification (FEI/EIN) number.
rightToTransactTexas	string	Right-to-transact-business status, for example ACTIVE.
sosRegistrationStatus	string	Secretary of State registration status, for example ACTIVE.
sosFileNumber	string	Secretary of State file number.
effectiveSosRegistrationDate	string	Effective SOS registration date (MM/DD/YYYY).
stateOfFormation	string	State or country of formation, for example DE.
reportYear	string	Year of the Public Information Report the officer data came from.
mailingAddressStreet	string	Mailing address street.
mailingAddressCity	string	Mailing address city.
mailingAddressState	string	Mailing address state.
mailingAddressZip	string	Mailing address ZIP.
registeredAgentName	string	Registered agent name (from the detail record).
registeredOfficeAddressStreet	string	Registered office street.
registeredOfficeAddressCity	string	Registered office city.
registeredOfficeAddressState	string	Registered office state.
registeredOfficeAddressZip	string	Registered office ZIP.
officerCount	integer	Number of officers/directors on the report.
officers	string	Flattened officers/directors block: one line per officer as `NAME
firstOfficerName	string	Name of the first listed officer.
firstOfficerTitle	string	Title of the first listed officer.
matchedBy	string	How the record was matched: name, taxpayerId, or fileNumber.
matchedQuery	string	The search term that returned this record.
source	string	Source system the record came from.
observedAt	string	ISO 8601 timestamp of when the record was collected.

Example output record

Real record from the same live run (input {"names": ["WALMART"], "maxEntities": 30}):

{
  "taxpayerId": "17107380069",
  "name": "WALMART CLAIMS SERVICES, INC.",
  "dbaName": null,
  "feiNumber": "710738006",
  "rightToTransactTexas": "ACTIVE",
  "sosRegistrationStatus": "ACTIVE",
  "sosFileNumber": "0009735106",
  "effectiveSosRegistrationDate": "10/27/1993",
  "stateOfFormation": "AR",
  "reportYear": "2023",
  "mailingAddressStreet": "1 CUSTOMER DR MSC 0555",
  "mailingAddressCity": "BENTONVILLE",
  "mailingAddressState": "AR",
  "mailingAddressZip": "72716",
  "registeredAgentName": "C T CORPORATION SYSTEM",
  "registeredOfficeAddressStreet": "1999 BRYAN ST., STE. 900",
  "registeredOfficeAddressCity": "DALLAS",
  "registeredOfficeAddressState": "TX",
  "registeredOfficeAddressZip": "75201",
  "officerCount": 12,
  "officers": "CAROL HAGGARD | ASSISTANT | 702 SW 8TH STREET BENTONVILLE, AR 72716 | (2023) ... [officers list trimmed for brevity; the real field returns all 12 officers]",
  "firstOfficerName": "CAROL HAGGARD",
  "firstOfficerTitle": "ASSISTANT",
  "matchedBy": "name",
  "matchedQuery": "WALMART",
  "source": "texas-comptroller-franchise-tax-account-status",
  "observedAt": "2026-08-11T11:13:03.161Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~texas-comptroller-entities-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"names":["WALMART"],"maxEntities":30,"withDetails":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~texas-comptroller-entities-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"taxpayerId":"17104151885","withDetails":true}'

Apify CLI:

apify call scrapers_lat/texas-comptroller-entities-scraper \
  --input '{"fileNumber":"0003668006"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per entity returned (result event). See the pricing tab for the current per-result price.
• Detail add-on. When withDetails is on and the full account status (agent + officers) is fetched, a small details event is charged in addition to the result. Turn withDetails off to skip it.
• No charge on failure. Failed or empty runs do not charge for records that were not returned.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxEntities.

FAQ and troubleshooting

A run returned 0 entities. Why? The name matched nothing, or the taxpayer/file number was not found. Try a shorter or different name, or confirm the number. Zero-result runs are not charged.

How do I look up one exact entity? Pass its taxpayerId (11 digits) or fileNumber (SOS file number) instead of a name.

Why is registeredAgentName or officers empty? Those come from the full account status, which is only fetched when withDetails is on. Some entities also have no officer block on file.

What is the officers format? One line per officer as NAME | TITLE | ADDRESS | (YEAR), so it stays readable in a single CSV cell. Use officerCount for the count.

Is this an official Texas government tool? No. This actor is independent and has no affiliation with the Texas Comptroller or Secretary of State. It reads only data that is publicly available on the franchise-tax account-status system.

Related scrapers

• Texas TDLR License Scraper: Texas occupational and trade licenses.
• Texas PELS Engineers Scraper: Texas professional engineers and firms.
• Tennessee License Scraper: Tennessee professional and business licenses.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with the Texas Comptroller or Secretary of State. Accesses only publicly available business-entity data.