> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Texas (US)
> Country-specific identifiers, data sources, and integration details
## 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.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
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](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Company Status](#company-status)
* [Legal Forms](#legal-forms)
* [Activity Codes](#activity-codes)
* [Officer Roles](#officer-roles)
* [Data Availability](#data-availability)
* [Documents](#documents)
**API access:** `US-TX` is not yet part of the public `countryCode` enum.
Contact us to enable it on your workspace. Requests sent with `countryCode:
"US-TX"` will otherwise return `400` until the enum is expanded.
## 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](https://data.texas.gov/dataset/Active-Franchise-Tax-Permit-Holders/9cir-efmm).
* **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](https://data.texas.gov/Government-and-Taxes/Active-Sales-Tax-Permit-Holders/jrea-zgmq).
**Texas Secretary of State** (verification mode + documents)
The [Texas Secretary of State](https://www.sos.state.tx.us/) is the official corporate registry for entities formed or registered to do business in Texas. It is the authoritative source for entity status, filing history, registered agent, officer/director records, and assumed names. Used for verification-mode company profiles and for issuing the Information Letter document. Covers formal entities only: sole traders are not registered with the SOS.
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.
**Entity coverage varies by source.** Franchise tax (Chapter 171) covers
corporations, LLCs, LPs, LLPs, and professional associations. The sales tax
endpoint covers holders of a sales tax permit (Chapter 151, Subchapter F): any
person or entity selling taxable goods, including sole traders. Businesses
that only provide services (consultants, lawyers, SaaS) typically don't hold a
permit and won't appear in either source. Verification mode is limited to
formal entities registered with the Secretary of State: sole traders have no
SOS filing and are not covered.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ------------------- | ----------- | ------------- | ------------------------------------------- |
| **Taxpayer Number** | 11 digits | `17307175087` | Texas Comptroller's primary identifier |
| **Federal EIN** | 9 digits | `730717508` | IRS-assigned Employer Identification Number |
| **SOS File Number** | 6-10 digits | `0003077806` | Secretary of State registration number |
**Which identifier to use?** For **search**, any identifier works — 11-digit
Taxpayer Number, 9-digit EIN, or SOS File Number. For **company profile**, you
must use the **11-digit Taxpayer Number** returned in the search result `id`
field. The detail API only accepts this format.
**Search first, then fetch.** The EIN and SOS File Number only work for
search. To retrieve company data, use the `id` from the search result (always
the 11-digit Taxpayer Number). Passing an EIN or SOS File Number directly to
the company profile endpoint will fail.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| ----------------------- | --------- | ---------------- | ------------- |
| `taxpayerId` | 11 digits | `17307175087` | All entities |
| `feiNumber` | 9 digits | `730717508` | Most entities |
| `sosFileNumber` | 10 digits | `0003077806` | All entities |
| `stateOfFormation` | 2-letter | `TX`, `NJ`, `DE` | All entities |
| `sosRegistrationStatus` | Text | `ACTIVE` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ------------------ | ---------------- | --------------- | ---------- | -------------------------------------------------------------------- |
| By Taxpayer Number | 11 digits | `17307175087` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Federal EIN | 9 digits | `730717508` | Exact | Exact match returned first (matchType: id); other results may follow |
| By SOS File Number | 6-8 or 10 digits | `0003077806` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Name | 2-50 chars | `"EXXON MOBIL"` | Fuzzy | Multiple results |
**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
| Quirk | Details |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Onboarding mode is non-authoritative** | Onboarding mode uses the Comptroller franchise tax system, not the official SOS corporate registry. Verification mode uses the Secretary of State directly and is authoritative. |
| **Verification mode: formal entities only** | The Secretary of State only registers formal entities (corporations, LLCs, LPs, etc.). Sole traders have no SOS filing number. Verification mode requests for sole-trader taxpayer IDs will not resolve. |
| **Company profile requires 11-digit Taxpayer Number** | The detail API only accepts the 11-digit Taxpayer Number. EIN and SOS File Number work for search only. Always use the `id` from search results to fetch company data. |
| **No sole proprietors in franchise tax** | Sole proprietors are exempt from franchise tax. They are covered via the sales tax fallback and identified by the `IS` org type code. |
| **No legal form in Comptroller live API** | The Comptroller live API does not return entity type. In onboarding mode, legal form comes from the open data `taxpayer_organizational_type` code, with name-suffix extraction as fallback. In verification mode, the SOS entity type string is used directly. |
| **Officer titles truncated (onboarding mode)** | In onboarding mode, titles from the Comptroller are cut to \~10 characters: `VICE PRESIDENT` becomes `VICE PRESI`. AI enrichment standardizes and completes them. In verification mode, titles come directly from the SOS Management tab and are always the full string as filed. |
| **HTML entities in titles** | Some Comptroller titles contain `&` instead of `&` (e.g., `PRES & CEO`). Decoded automatically. |
| **Leading spaces in state** | `stateOfFormation` has a leading space (e.g., ` TX`). Trimmed automatically. |
| **Missing detail for some entities** | Some entities appear in search but return "not set up for Franchise Tax" on the detail endpoint. These are entities tracked by SOS but not the Comptroller. |
| **Registered agent is not a legal representative** | Per BOC §5.206, the registered agent's only duty is to receive and forward legal process. They have no authority to act for the company. Mapped as Other Key Person. |
| **Two address types** | The Comptroller API returns both mailing address and registered office address. We use the **registered office** as `legalAddress` because it's the official address of record. |
| **Two status fields (onboarding mode)** | `rightToTransactTX` = franchise tax standing only. `sosRegistrationStatus` = corporate status from SOS. We use SOS status as the company status in onboarding mode. In verification mode, status is read directly from the SOS entity page. |
| **Officer data depends on report filing (onboarding mode)** | In onboarding mode, officer data comes from franchise tax annual reports. Entities that have never filed a report will have zero officers returned, regardless of their actual structure. This includes some large active companies that file under a different entity. Verification mode reads officers directly from the SOS Management tab and is not affected by this. |
## Mappings
### Company Status
**Onboarding mode** uses `sosRegistrationStatus` from the Comptroller (which mirrors the SOS), not `rightToTransactTX` (franchise tax standing).
| Source Value | Mapped Status | Active |
| ------------ | ------------- | ------- |
| `ACTIVE` | Active | `true` |
| `INACTIVE` | Inactive | `false` |
| Other values | As-is | `false` |
**Verification mode** reads entity status directly from the Secretary of State.
| SOS Status Value | Mapped Status | Active | Notes |
| ----------------------- | ------------- | ------- | ------------------------------------- |
| `In existence` | In existence | `true` | Entity is active and in good standing |
| `Forfeited existence` | Forfeited | `false` | Franchise tax delinquency |
| `Voluntarily dissolved` | Dissolved | `false` | Entity chose to dissolve |
| `Merged` | Merged | `false` | Entity was absorbed by another |
### Legal Forms
Legal form is sourced differently depending on the request mode.
**Onboarding mode** uses the Comptroller's `taxpayer_organizational_type` code, a closed 2-letter set defined in the [Franchise Layout](https://data.texas.gov/dataset/Active-Franchise-Tax-Permit-Holders/9cir-efmm/about_data) 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](https://www.sos.state.tx.us/corp/forms_boc.shtml).
| Code | Legal Form | Standardized | ISO 20275 |
| ---- | --------------------------------- | ------------------------- | --------- |
| CL | Texas Limited Liability Company | Limited Liability Company | `WYG5` |
| CI | Foreign Limited Liability Company | Limited Liability Company | `WYG5` |
| CT | Texas Profit Corporation | Corporation | `C5K7` |
| CF | Foreign Profit Corporation | Corporation | `C5K7` |
| CP | Texas Professional Corporation | Corporation | `9AAS` |
| CU | Foreign Professional Corporation | Corporation | `9AAS` |
| CN | Texas Non-Profit Corporation | Non-Profit Organization | `OGSS` |
| CM | Foreign Non-Profit Corporation | Non-Profit Organization | |
| PL | Texas Limited Partnership | Partnership | `FE1L` |
| PF | Foreign Limited Partnership | Partnership | |
| PB | Business General Partnership | Partnership | |
| AP | Texas Professional Association | Corporation | `MXWB` |
| AF | Foreign Professional Association | Corporation | |
| TR | Trust | Trust | |
| IS | Sole Proprietorship (Individual) | Sole Proprietorship | |
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.
| SOS Entity Type | Standardized | ISO 20275 |
| ------------------------------------------------------ | ------------------------- | --------- |
| Domestic For-Profit Corporation | Corporation | `C5K7` |
| Foreign For-Profit Corporation | Corporation | `C5K7` |
| Domestic Nonprofit Corporation | Non-Profit Organization | `OGSS` |
| Foreign Nonprofit Corporation | Non-Profit Organization | |
| Domestic Professional Corporation | Corporation | `9AAS` |
| Foreign Professional Corporation | Corporation | `9AAS` |
| Domestic Professional Association | Corporation | `MXWB` |
| Foreign Professional Association | Corporation | |
| Domestic Limited Liability Company (LLC) | Limited Liability Company | `WYG5` |
| Foreign Limited Liability Company (LLC) | Limited Liability Company | `WYG5` |
| Domestic Professional Limited Liability Company (PLLC) | Limited Liability Company | |
| Foreign Professional Limited Liability Company (PLLC) | Limited Liability Company | |
| Domestic Limited Partnership (LP) | Partnership | `FE1L` |
| Foreign Limited Partnership (LP) | Partnership | |
| Domestic Limited Liability Partnership | Partnership | |
| Foreign Limited Liability Partnership | Partnership | |
| Domestic Real Estate Investment Trust | Trust | |
| Foreign Real Estate Investment Trust | Trust | |
| Domestic Business Trust | Trust | |
| Foreign Business Trust | Trust | |
| Domestic Cooperative Association | Non-Profit Organization | |
| Foreign Cooperative Association | Non-Profit Organization | |
| Foreign Series Limited Liability Company (LLC) | Limited Liability Company | |
| Foreign Financial Institution | Corporation | |
ISO 20275 (ELF) codes are from the [GLEIF US-TX jurisdiction list](https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list).
### 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](https://www.census.gov/naics/concordances/concordances.html) (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.
| System | Source | Example |
| ---------- | ------------------------------------------------ | ------------------------------------------------- |
| NAICS | SODA3 open data (franchise or sales tax dataset) | `541330` (Engineering Services) |
| ISIC Rev.4 | US Census concordance from NAICS | `7110` (Architectural and engineering activities) |
| NACE Rev.2 | Identical to ISIC at 4-digit level | `7110` |
### 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).
| Title | Standardized | Legal Basis |
| ------------------------------ | ----------------------- | --------------------- |
| PRESIDENT, PRES | President | BOC §3.101 |
| VICE PRESIDENT, VICE PRESI, VP | Vice President | BOC §3.101 |
| SECRETARY | Secretary | BOC §3.101 |
| DIRECTOR | Director | Board member |
| CEO, CHIEF EXECUTIVE OFFICER | Chief Executive Officer | Executive authority |
| MANAGER, MANAGING MEMBER | Manager | BOC §101.254 (LLC) |
| GENERAL PARTNER, GENERAL PA | General Partner | BOC §153.152 (LP/LLP) |
| MANAGING PARTNER | Managing Partner | BOC §153.152 |
| OWNER | Owner | Sole authority |
| GENERAL COUNSEL | General Counsel | Legal authority |
| Title | Standardized | Notes |
| -------------------------------- | ------------------------ | ----------------------------------------------------- |
| CHAIRMAN | Board Member | Oversight only in Texas |
| ASSISTANT SECRETARY, ASECRETARY | Secretary | Delegated, no independent authority |
| APPOINTED ASSISTANT SECRETARY | Secretary | Delegated, no independent authority |
| TREASURER | Treasurer | Financial role |
| CFO, CHIEF FINANCIAL OFFICER | Chief Financial Officer | |
| COO | Chief Operating Officer | |
| CTO | Chief Technology Officer | |
| CHIEF ADMINISTRATIVE OFFICER | Other | |
| SENIOR VICE PRESIDENT, SVP | Other | Operational seniority |
| EXECUTIVE VICE PRESIDENT, EVP | Other | Operational seniority |
| CONTROLLER | Other | Financial staff |
| LIMITED PARTNER, PARTNER, MEMBER | Other | No management authority |
| AUDITOR | Auditor | |
| REGISTERED AGENT | Other | Receives and forwards legal process only (BOC §5.206) |
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
| Data Point | Available | Notes |
| --------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Company name | Yes | Legal name + DBA. Verification mode also returns historical names and assumed names from the SOS Names tab. |
| Company status | Yes | Onboarding: SOS registration status from Comptroller mirror (ACTIVE / INACTIVE). Verification: status read directly from SOS (In existence, Forfeited, Dissolved, Merged). |
| Registration date | Yes | SOS effective registration date |
| Legal address | Yes | Registered office address |
| Legal form | Yes | Onboarding: Comptroller organizational type code (29 types, domestic/foreign). Falls back to name-suffix extraction. Verification: Secretary of State entity type string (24 types from Texas BOC). |
| Activity codes | Yes | NAICS from Comptroller open data, with ISIC Rev.4 and NACE Rev.2 derived via US Census concordance table. Onboarding mode only. |
| Share capital | No | Not provided by either source |
| Legal representatives | Yes\* | Officers with statutory authority (President, Director, etc.). Onboarding: from Comptroller franchise tax reports, truncated titles, AI-enriched. Verification: from SOS Management tab, full titles. *Not available for sole traders.* |
| Other key persons | Yes\* | Treasurer, CFO, Chairman, Registered Agent, etc. Same sourcing as legal representatives by mode. *Not available for sole traders.* |
| Registered agent | Yes\* | Formal entities only. Onboarding: from Comptroller. Verification: from SOS Registered Agent tab. |
| Establishments | Yes | Branch/location data from Comptroller sales tax permits, with addresses and permit dates. Both modes. |
| Shareholders | No | Not available from either source |
| UBOs | No | Not available from either source |
| Documents | Yes | **Information Letter** from the Secretary of State for formal entities (corporations, LLCs, limited partnerships). **Sales Tax Permit** from the Comptroller for all entities with a sales tax permit, including sole traders. Both returned as PDF. |
| Financial data | No | Not provided |
## 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.
| Property | Value |
| ----------------- | --------------------------------------------------------------------- |
| Available for | Formal entities only (corporations, LLCs, limited partnerships, etc.) |
| Not available for | Sole traders — they have no SOS filing number |
| Format | PDF |
| Delivery | Up to 2 hours after request |
### 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.
| Property | Value |
| ------------- | -------------------------------------------------------------------- |
| Available for | All entities with an active or inactive Comptroller sales tax permit |
| Format | PDF |
| Delivery | Under 2 minutes |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-TX&query=TOPOGRAPHIC+OM" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "17307175087",
"legalName": "TOPOGRAPHIC OM, INC.",
"countryCode": "US-TX",
"matchReason": {
"matchType": "default"
},
"address": {
"postalCode": "76126",
"countryCode": "US"
}
}
]
```
### Company Profile (Onboarding Mode)
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countryCode": "US-TX", "id": "17307175087", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"], "mode": "onboarding"}'
```
```json theme={null}
{
"company": {
"id": "17307175087",
"countryCode": "US-TX",
"identifiers": {
"feiNumber": "730717508",
"taxpayerId": "17307175087",
"sosFileNumber": "0003077806",
"stateOfFormation": "OK",
"sosRegistrationStatus": "ACTIVE"
},
"legalName": "TOPOGRAPHIC OM, INC.",
"registrationDate": "1970-09-16",
"status": {
"localName": "Active",
"active": true
},
"legalForm": {
"localName": "Foreign Profit Corporation",
"englishTranslation": "Corporation (Foreign)",
"standardized": "Corporation",
"iso20275Code": "C5K7"
},
"activities": {
"NAICS": [
{
"code": "541330",
"description": "Engineering Services",
"isAIInferred": false
}
],
"ISIC": [
{
"code": "7110",
"description": "Architectural and engineering activities and related technical consultancy",
"isAIInferred": false
}
],
"NACE": [
{
"code": "7110",
"description": "Architectural and engineering activities and related technical consultancy",
"isAIInferred": false
}
]
},
"legalAddress": {
"addressLine1": "211 E. 7TH STREET SUITE 620",
"city": "AUSTIN",
"postalCode": "78701",
"region": "TX",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "PRESIDENT",
"englishTranslation": "President",
"standardized": "President"
},
"individual": {
"name": { "fullName": "BRIAN KRAFFT" },
"residenceAddress": {
"addressLine1": "5229 EAST VERDE CIRCLE",
"city": "BENBROOK",
"postalCode": "76126",
"region": "TX",
"countryCode": "US"
}
}
},
{
"type": "individual",
"role": {
"localName": "VICE PRESI",
"englishTranslation": "Vice President",
"standardized": "Vice President"
},
"individual": {
"name": { "fullName": "J ROBERT KEATING" },
"residenceAddress": {
"addressLine1": "6040 LAKESIDE DRIVE",
"city": "FORT WORTH",
"postalCode": "76179",
"region": "TX",
"countryCode": "US"
}
}
},
{
"type": "individual",
"role": {
"localName": "SECRETARY",
"englishTranslation": "Secretary",
"standardized": "Secretary"
},
"individual": {
"name": { "fullName": "SHARON L KEATING" },
"residenceAddress": {
"addressLine1": "6040 LAKESIDE DRIVE",
"city": "FORT WORTH",
"postalCode": "76179",
"region": "TX",
"countryCode": "US"
}
}
},
{
"type": "individual",
"role": {
"localName": "DIRECTOR",
"englishTranslation": "Director",
"standardized": "Director"
},
"individual": {
"name": { "fullName": "WILLIAM KEATING" },
"residenceAddress": {
"addressLine1": "903 PRINCETON AVE",
"city": "MIDLAND",
"postalCode": "79701",
"region": "TX",
"countryCode": "US"
}
}
},
{
"type": "individual",
"role": {
"localName": "VICE PRESI",
"englishTranslation": "Vice President",
"standardized": "Vice President"
},
"individual": {
"name": { "fullName": "WILLIAM KEATING" },
"residenceAddress": {
"addressLine1": "903 PRINCETON AVE",
"city": "MIDLAND",
"postalCode": "79701",
"region": "TX",
"countryCode": "US"
}
}
}
],
"otherKeyPersons": [
{
"type": "individual",
"role": {
"localName": "TREASURER",
"englishTranslation": "Treasurer",
"standardized": "Treasurer"
},
"individual": {
"name": { "fullName": "SHARON L KEATING" },
"residenceAddress": {
"addressLine1": "6040 LAKESIDE DRIVE",
"city": "FORT WORTH",
"postalCode": "76179",
"region": "TX",
"countryCode": "US"
}
}
},
{
"type": "company",
"role": {
"localName": "Registered Agent",
"standardized": "Other"
},
"company": {
"countryCode": "US",
"legalName": "CORPORATION SERVICE COMPANY D/B/A CSC-LAWYERS INCO",
"legalAddress": {
"addressLine1": "211 E. 7TH STREET SUITE 620",
"city": "AUSTIN",
"postalCode": "78701",
"region": "TX",
"countryCode": "US"
}
}
}
]
}
```
### Sole Trader (Sales Tax Fallback)
Sole traders are not in the franchise tax system. Data comes from the sales tax payer API.
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countryCode": "US-TX", "id": "32008802830", "dataPoints": ["company", "establishments"], "mode": "onboarding"}'
```
```json theme={null}
{
"company": {
"id": "32008802830",
"countryCode": "US-TX",
"identifiers": {
"taxpayerId": "32008802830"
},
"legalName": "DAVID MARTINEZ, JR",
"status": {
"localName": "Active",
"active": true
},
"legalForm": {
"localName": "Sole Proprietorship",
"englishTranslation": "Sole Proprietorship (Individual)",
"standardized": "Sole Proprietorship"
},
"activities": {
"NAICS": [
{
"code": "561740",
"description": "Carpet and Upholstery Cleaning Services",
"isAIInferred": false
}
],
"ISIC": [
{
"code": "9601",
"description": "Washing and (dry-) cleaning of textile and fur products",
"isAIInferred": false
}
],
"NACE": [
{
"code": "9601",
"description": "Washing and (dry-) cleaning of textile and fur products",
"isAIInferred": false
}
]
},
"legalAddress": {
"addressLine1": "12567 SOMERSET RD",
"city": "VON ORMY",
"postalCode": "78073",
"region": "TX",
"countryCode": "US"
}
},
"establishments": [
{
"name": "CASTILLO'S ICE HOUSE",
"creationDate": "1999-12-24",
"endDate": "2008-09-01",
"active": false,
"address": {
"addressLine1": "346 E QUILL DR",
"city": "SAN ANTONIO",
"postalCode": "78228",
"region": "TX",
"countryCode": "US"
}
},
{
"name": "CARPET MASTERS",
"creationDate": "2008-05-01",
"active": true,
"address": {
"addressLine1": "346 E QUILL DR",
"city": "SAN ANTONIO",
"postalCode": "78228",
"region": "TX",
"countryCode": "US"
}
}
]
}
```
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.