Texas Comptroller Business Records data contract

Provenance

PublisherTexas Comptroller Open Data

Sourcehttps://data.texas.gov/

Docshttps://dev.socrata.com/foundry/data.texas.gov/9cir-efmm

Freshness & coverage

FreshnessScheduled — The upstream open-data portal publishes current active datasets without a guaranteed cadence.

GeographicTexas

Temporal… → present — Current active franchise-taxpayer and sales-tax-permit records; inactive history is outside these datasets.

AuthenticationNo credentials required

Caveats

⚠ Open-data results are not certificates of account status.
⚠ No result means not found in the current active dataset.

Methods (4)

searchFranchiseTaxpayers

read

Search active franchise taxpayers by name or exact business identifier.

Entitiesbusiness, franchise-taxpayer

Paginationoffset (offsetField: offset, limitField: limit)

FreshnessScheduled

Input schema

{
  "type": "object",
  "properties": {
    "taxpayerNumber": {
      "type": "string",
      "pattern": "^\\d{11}$"
    },
    "name": {
      "type": "string"
    },
    "sosFileNumber": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "postalCode": {
      "type": "string"
    },
    "rightToTransactCode": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50000
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string"
    },
    "datasetId": {
      "type": "string"
    },
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "returned": {
      "type": "integer"
    },
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "caveat": {
      "type": "string"
    }
  },
  "required": [
    "dataset",
    "datasetId",
    "records",
    "returned",
    "limit",
    "offset",
    "caveat"
  ],
  "additionalProperties": true
}

Requires taxpayerNumber, name, or sosFileNumber.

searchSalesTaxPermitHolders

read

Search current Texas sales-tax permit holders and outlets.

Entitiesbusiness, sales-tax-permit

Paginationoffset (offsetField: offset, limitField: limit)

FreshnessScheduled

Input schema

{
  "type": "object",
  "properties": {
    "taxpayerNumber": {
      "type": "string",
      "pattern": "^\\d{11}$"
    },
    "name": {
      "type": "string"
    },
    "outletName": {
      "type": "string"
    },
    "outletNumber": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "postalCode": {
      "type": "string"
    },
    "naicsCode": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50000
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string"
    },
    "datasetId": {
      "type": "string"
    },
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "returned": {
      "type": "integer"
    },
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "caveat": {
      "type": "string"
    }
  },
  "required": [
    "dataset",
    "datasetId",
    "records",
    "returned",
    "limit",
    "offset",
    "caveat"
  ],
  "additionalProperties": true
}

Requires taxpayerNumber, name, or outletName.

getTaxpayerStanding

read

Combine franchise and sales-tax evidence for one taxpayer number.

Required paramstaxpayerNumber

Entitiesbusiness, business-standing, sales-tax-permit

Paginationnone

FreshnessScheduled

Input schema

{
  "type": "object",
  "properties": {
    "taxpayerNumber": {
      "type": "string",
      "pattern": "^\\d{11}$"
    }
  },
  "required": [
    "taxpayerNumber"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "taxpayerNumber": {
      "type": "string"
    },
    "standingStatus": {
      "type": "string",
      "enum": [
        "not_found_in_active_franchise_dataset",
        "active_right_to_transact",
        "listed_but_right_to_transact_not_active"
      ]
    },
    "franchiseTaxpayer": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true
    },
    "activeSalesTaxPermits": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "evidence": {
      "type": "object",
      "additionalProperties": true
    },
    "caveat": {
      "type": "string"
    }
  },
  "required": [
    "taxpayerNumber",
    "standingStatus",
    "franchiseTaxpayer",
    "activeSalesTaxPermits",
    "evidence",
    "caveat"
  ],
  "additionalProperties": true
}

getServiceInfo

read

Describe datasets, methods, codes, and no-result semantics.

Entitiesservice-metadata

Paginationnone

FreshnessScheduled (source-level)

Output schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "auth": {
      "type": "string"
    },
    "datasets": {
      "type": "object",
      "additionalProperties": true
    },
    "methods": {
      "type": "object",
      "additionalProperties": true
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "service",
    "auth",
    "datasets",
    "methods",
    "notes"
  ],
  "additionalProperties": true
}