Texas Business Entity Scraper & LLC Lookup - SOS Registry API

Search Texas LLCs, corporations, and LPs through the official Comptroller public data path. Look up known businesses by name, taxpayer number, EIN, or SOS file number and return source-reported right-to-transact and registration status, officers, registered agents, addresses, report-year data, and identifiers for KYB checks, due diligence, and B2B enrichment.

No browser automation. No proxies. Uses the official Texas Comptroller public API. The first run uses Dell's exact taxpayer number and returns one detailed record for up to $0.0021; replace it with your own identifier or a specific company name. Very broad names can be rejected by the source API.

---

What You Get

Each result is one business entity record with full details when fetchDetails is enabled (default).

Field	Type	Description
setupStatus	string	found, no_match, or search_error
source / sourceUrl	string	Official source and exact entity API URL
retrievedAt	string	UTC retrieval timestamp
evidenceNotice	string	Interpretation and due-diligence boundary
taxpayerId	string	11-digit Comptroller taxpayer number
feiNumber	string	9-digit Federal Employer ID (EIN)
name	string	Registered entity name
dbaName	string	Doing business as name
mailingAddressStreet	string	Mailing street address
mailingAddressCity	string	Mailing city
mailingAddressState	string	Mailing state
mailingAddressZip	string	Mailing ZIP code
rightToTransactTX	string	Whether the entity has the right to transact business in Texas
stateOfFormation	string	State or country of formation
sosRegistrationStatus	string	TX Secretary of State registration status
effectiveSosRegistrationDate	string	Effective SOS registration date
sosFileNumber	string	TX Secretary of State file number
registeredAgentName	string	Registered agent name
registeredOfficeStreet	string	Registered office street address
registeredOfficeCity	string	Registered office city
registeredOfficeState	string	Registered office state
registeredOfficeZip	string	Registered office ZIP code
reportYear	string	Most recent annual report year
officers	array	Officers and directors with name, title, report year, and address
searchTerm	string	Search term used to find this entity

---

Sample Output

{
  "setupStatus": "found",
  "source": "Texas Comptroller of Public Accounts Franchise Tax Account Status Search",
  "sourceUrl": "https://comptroller.texas.gov/data-search/franchise-tax/17424878340",
  "retrievedAt": "2026-07-24T00:00:00Z",
  "taxpayerId": "17424878340",
  "feiNumber": "742487834",
  "name": "DELL INC.",
  "mailingAddressCity": "ROUND ROCK",
  "mailingAddressState": "TX",
  "rightToTransactTX": "ACTIVE",
  "stateOfFormation": "DE",
  "sosRegistrationStatus": "ACTIVE",
  "sosFileNumber": "0007444706",
  "reportYear": "2026",
  "officers": [
    {"name": "MICHAEL S. DELL", "title": "CEO", "year": "2026", "source": "SOS"}
  ],
  "searchTerm": "17424878340",
  "evidenceNotice": "Point-in-time public Comptroller evidence..."
}

No-match searches return one explicit, query-preserving no_match evidence item. Source rejections or outages return search_error, which must not be interpreted as no match.

---

Who Uses This

Business banking and payments teams enriching known applicants or prospects with Texas entity identifiers, source-reported status, officers, and registered-agent evidence.

Insurance, accounting, and B2B teams appending official registry fields to an existing company list before outreach or account review.

Legal and compliance teams comparing a counterparty's submitted name and identifiers with the current public Comptroller record during KYB, vendor onboarding, credit, or due diligence.

This actor does not search by formation-date range, produce a complete feed of newly registered businesses, or determine whether an entity is legally compliant or suitable for a transaction.

---

How to Use

Step 1: Configure your input

Exact one-record lookup (first-run default):

{
  "taxpayerNumbers": ["17424878340"],
  "fetchDetails": true,
  "maxResults": 1
}

Search by a specific entity name:

{
  "query": "Dell Inc",
  "fetchDetails": true,
  "maxResults": 10
}

Batch search by multiple entity names:

{
  "searchTerms": ["Acme Manufacturing", "Pacific Energy"],
  "fetchDetails": true
}

Look up by Comptroller taxpayer number or EIN:

{
  "taxpayerNumbers": ["12345678901", "987654321"],
  "fetchDetails": true
}

Look up by TX SOS file number:

{
  "fileNumbers": ["0801163717"],
  "fetchDetails": true
}

Input reference

Parameter	Type	Description
query	string	Single entity name search. Used if searchTerms is empty.
searchTerms	string[]	Batch entity name searches. Overrides query if non-empty.
taxpayerNumbers	string[]	11-digit Comptroller taxpayer numbers or 9-digit EINs.
fileNumbers	string[]	6–10 digit TX SOS file numbers.
fetchDetails	boolean	When true (default), fetches full details including officers and registered agent. When false, returns only name, taxpayer ID, and ZIP.
maxResults	integer	Maximum total paid records across all supplied searches; default 1, range 1–10,000.

Multiple input types can be combined in a single run. Results are deduplicated by taxpayer ID.

---

Cost Estimate

Pricing is a $0.0001 minimum actor-start event plus $0.002 per result.

Run size	Estimated cost
1 result (default)	~$0.0021
10 results	~$0.0201
100 results	~$0.20
500 results	~$1.00
1,000 results	~$2.00

With fetchDetails: true, the actor makes one additional API call per result to retrieve officer and address data. This is the default and recommended setting.

---

Output Formats

Results are available in JSON, CSV, and Excel from the Apify dataset viewer. Connect to downstream tools via the Apify API or webhooks.

---

FAQ

Does this require a paid API key or credentials? No. The Texas Comptroller public API is free and requires no authentication. This actor uses it directly with no API keys needed.

What does "right to transact business in Texas" mean? It indicates whether the entity is authorized by the state to conduct business in Texas. Foreign entities (formed outside Texas) must obtain this authorization separately from SOS registration.

What is in the officers array? Each entry includes the officer's name, title (e.g. President, Secretary, Director), the report year the record comes from, and their address if provided. Data comes from the entity's most recent annual franchise tax report.

Can I search by EIN? Yes. Pass 9-digit EINs in the taxpayerNumbers field. The Comptroller API accepts both 11-digit taxpayer numbers and 9-digit federal EINs.

How specific do name searches need to be? The Comptroller API rejects very broad or single-character searches. Use specific entity names or partial names with at least 3–4 characters. Overly generic terms may return no results or an API error.

Is the data real-time? The actor queries the current public Comptroller endpoint on each run, but agency records can lag, change, or be corrected. Treat the output as point-in-time public-record evidence, not a certified status report or legal conclusion.

Does a positive status prove good standing or compliance? No. rightToTransactTX and sosRegistrationStatus are source-reported fields. Review the latest linked agency record, match identifiers carefully, and obtain any certified evidence required for a legal, credit, or compliance decision.