{
  "openapi": "3.0.1",
  "info": {
    "title": "TDLR Occupational License Records for Texas Trades",
    "description": "Search Texas TDLR license records across 80+ trades by holder/business name or license number, with trade category, county, and active/expired status filters.",
    "version": "1.0",
    "x-build-id": "PhlhAzpKrwpv60Ysv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/vexaloom-labs~tdlr-occupational-license-records-for-texas-trades/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-vexaloom-labs-tdlr-occupational-license-records-for-texas-trades",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/vexaloom-labs~tdlr-occupational-license-records-for-texas-trades/runs": {
      "post": {
        "operationId": "runs-sync-vexaloom-labs-tdlr-occupational-license-records-for-texas-trades",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/vexaloom-labs~tdlr-occupational-license-records-for-texas-trades/run-sync": {
      "post": {
        "operationId": "run-sync-vexaloom-labs-tdlr-occupational-license-records-for-texas-trades",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "byName",
              "byOwnerName",
              "byBusinessName",
              "byLicenseNumber"
            ],
            "type": "string",
            "description": "How to look up licenses. The three name modes return the same record shape; they only change which name column the search matches.",
            "default": "byName"
          },
          "nameQuery": {
            "title": "Name to search (name modes)",
            "type": "string",
            "description": "Case-insensitive partial match against the license holder name in `byOwnerName`, the business/DBA name in `byBusinessName`, or either in `byName` (e.g. `Smith` or `Star Electrical`). Optional if `licenseType`, `countyFilter`, `cityFilter` or `zipFilter` is set — leaving it blank then browses all licenses matching those filters.",
            "default": "Smith"
          },
          "licenseNumber": {
            "title": "License number (mode=byLicenseNumber)",
            "type": "string",
            "description": "The TDLR license number, e.g. `11484`. Note: TDLR numbers licenses per trade category, so the same number can be shared across different license types — use `licenseType` to disambiguate."
          },
          "licenseType": {
            "title": "Filter by license type / trade category",
            "enum": [
              "",
              "A/C CE Provider",
              "A/C Contractor",
              "A/C Technician",
              "Appliance Installation Contractor",
              "Appliance Installer",
              "Apprentice Electrician",
              "Apprentice Sign Electrician",
              "Associate Auctioneer",
              "Auctioneer",
              "Auctioneer CE Provider",
              "Barber School",
              "Boiler Authorized Inspection Agency",
              "Boiler Inspectors",
              "CS AMATEUR PROMOTER (Business)",
              "CS CONTESTANT",
              "CS JUDGE",
              "CS MANAGER",
              "CS PROMOTER (Business)",
              "CS REFEREE",
              "Class A Barber",
              "Cosmetology CE Provider",
              "Cosmetology Esthetician",
              "Cosmetology Eyelash Extension Specialist",
              "Cosmetology Hair Weaving Specialist",
              "Cosmetology Hair Weaving Specialist/Esthetician",
              "Cosmetology Junior College",
              "Cosmetology Manicurist",
              "Cosmetology Manicurist/Esthetician",
              "Cosmetology Operator",
              "Cosmetology Private School",
              "Cosmetology Vocational/High School",
              "Devices",
              "Distributor/Wholesaler",
              "Electrical Contractor",
              "Electrical Sign Contractor",
              "Electrician Apprenticeship Program",
              "Electrician CE Provider",
              "Elevator Contractor",
              "Elevator Responsible Party",
              "Elevator Responsible Party CE Provider",
              "Esthetician Establishment",
              "Eyelash Extension Establishment",
              "Full Service Establishment",
              "Hair Weaving  Establishment",
              "Journeyman Electrician",
              "Journeyman Industrial Electrician",
              "Journeyman Lineman Electrician",
              "Journeyman Sign Electrician",
              "Licensed Assistant Behavior Analyst",
              "Licensed Behavior Analyst",
              "Licensed Breeder",
              "Maintenance Electrician",
              "Manicurist Establishment",
              "Manicurist/Esthetician Establishment",
              "Master Electrician",
              "Master Sign Electrician",
              "Mini Establishment",
              "Mobile Establishment",
              "Professional Employer Organization",
              "Professional Employer Organization (Limited license)",
              "Property Tax Appraiser",
              "Property Tax Assessor/Collector",
              "Property Tax Collector",
              "Property Tax Consultant",
              "Property Tax Consultant CE Provider",
              "Property Tax Professional CE Provider",
              "Property Tax Professional Core Education Provider",
              "Qualified Elevator Inspector",
              "Registered Accessibility Specialist",
              "Registered Accessibility Specialist CE Provider",
              "Residential Wireman",
              "Service Company",
              "Service Contract Provider",
              "Service Technician",
              "Supplier",
              "Tow Operator CE Provider",
              "Tow Truck Operator (Consent Tow)",
              "Tow Truck Operator (Incident Management)",
              "Tow Truck Operator (Private Property)",
              "Used Auto Parts Recycler",
              "VSF Employee",
              "Water Well Driller/Pump Installer",
              "Water Well Driller/Pump Installer Apprentice",
              "Water Well Driller/Pump Installer CE Provider",
              "Weather Modification License",
              "Weather Modification Permit",
              "Behavior Analyst",
              "Behavior Analyst Assistant"
            ],
            "type": "string",
            "description": "Only emit licenses of this TDLR trade category. The list mirrors the 86 categories currently present in TDLR's published dataset; the two legacy Behavior Analyst labels at the end are accepted for saved tasks and mapped to their current names.",
            "default": ""
          },
          "countyFilter": {
            "title": "Filter by Texas county",
            "enum": [
              "",
              "ANDERSON",
              "ANDREWS",
              "ANGELINA",
              "ARANSAS",
              "ARCHER",
              "ARMSTRONG",
              "ATASCOSA",
              "AUSTIN",
              "BAILEY",
              "BANDERA",
              "BASTROP",
              "BAYLOR",
              "BEE",
              "BELL",
              "BEXAR",
              "BLANCO",
              "BORDEN",
              "BOSQUE",
              "BOWIE",
              "BRAZORIA",
              "BRAZOS",
              "BREWSTER",
              "BRISCOE",
              "BROOKS",
              "BROWN",
              "BURLESON",
              "BURNET",
              "CALDWELL",
              "CALHOUN",
              "CALLAHAN",
              "CAMERON",
              "CAMP",
              "CARSON",
              "CASS",
              "CASTRO",
              "CHAMBERS",
              "CHEROKEE",
              "CHILDRESS",
              "CLAY",
              "COCHRAN",
              "COKE",
              "COLEMAN",
              "COLLIN",
              "COLLINGSWORTH",
              "COLORADO",
              "COMAL",
              "COMANCHE",
              "CONCHO",
              "COOKE",
              "CORYELL",
              "COTTLE",
              "CRANE",
              "CROCKETT",
              "CROSBY",
              "CULBERSON",
              "DALLAM",
              "DALLAS",
              "DAWSON",
              "DE WITT",
              "DEAF SMITH",
              "DELTA",
              "DENTON",
              "DICKENS",
              "DIMMIT",
              "DONLEY",
              "DUVAL",
              "EASTLAND",
              "ECTOR",
              "EDWARDS",
              "EL PASO",
              "ELLIS",
              "ERATH",
              "FALLS",
              "FANNIN",
              "FAYETTE",
              "FISHER",
              "FLOYD",
              "FOARD",
              "FORT BEND",
              "FRANKLIN",
              "FREESTONE",
              "FRIO",
              "GAINES",
              "GALVESTON",
              "GARZA",
              "GILLESPIE",
              "GLASSCOCK",
              "GOLIAD",
              "GONZALES",
              "GRAY",
              "GRAYSON",
              "GREGG",
              "GRIMES",
              "GUADALUPE",
              "HALE",
              "HALL",
              "HAMILTON",
              "HANSFORD",
              "HARDEMAN",
              "HARDIN",
              "HARRIS",
              "HARRISON",
              "HARTLEY",
              "HASKELL",
              "HAYS",
              "HEMPHILL",
              "HENDERSON",
              "HIDALGO",
              "HILL",
              "HOCKLEY",
              "HOOD",
              "HOPKINS",
              "HOUSTON",
              "HOWARD",
              "HUDSPETH",
              "HUNT",
              "HUTCHINSON",
              "IRION",
              "JACK",
              "JACKSON",
              "JASPER",
              "JEFF DAVIS",
              "JEFFERSON",
              "JIM HOGG",
              "JIM WELLS",
              "JOHNSON",
              "JONES",
              "KARNES",
              "KAUFMAN",
              "KENDALL",
              "KENEDY",
              "KENT",
              "KERR",
              "KIMBLE",
              "KING",
              "KINNEY",
              "KLEBERG",
              "KNOX",
              "LA SALLE",
              "LAMAR",
              "LAMB",
              "LAMPASAS",
              "LAVACA",
              "LEE",
              "LEON",
              "LIBERTY",
              "LIMESTONE",
              "LIPSCOMB",
              "LIVE OAK",
              "LLANO",
              "LOVING",
              "LUBBOCK",
              "LYNN",
              "MADISON",
              "MARION",
              "MARTIN",
              "MASON",
              "MATAGORDA",
              "MAVERICK",
              "MCCULLOCH",
              "MCLENNAN",
              "MCMULLEN",
              "MEDINA",
              "MENARD",
              "MIDLAND",
              "MILAM",
              "MILLS",
              "MITCHELL",
              "MONTAGUE",
              "MONTGOMERY",
              "MOORE",
              "MORRIS",
              "MOTLEY",
              "NACOGDOCHES",
              "NAVARRO",
              "NEWTON",
              "NOLAN",
              "NUECES",
              "OCHILTREE",
              "OLDHAM",
              "ORANGE",
              "OUT OF STATE",
              "PALO PINTO",
              "PANOLA",
              "PARKER",
              "PARMER",
              "PECOS",
              "POLK",
              "POTTER",
              "PRESIDIO",
              "RAINS",
              "RANDALL",
              "REAGAN",
              "REAL",
              "RED RIVER",
              "REEVES",
              "REFUGIO",
              "ROBERTS",
              "ROBERTSON",
              "ROCKWALL",
              "RUNNELS",
              "RUSK",
              "SABINE",
              "SAN AUGUSTINE",
              "SAN JACINTO",
              "SAN PATRICIO",
              "SAN SABA",
              "SCHLEICHER",
              "SCURRY",
              "SHACKLEFORD",
              "SHELBY",
              "SHERMAN",
              "SMITH",
              "SOMERVELL",
              "STARR",
              "STEPHENS",
              "STERLING",
              "STONEWALL",
              "SUTTON",
              "SWISHER",
              "TARRANT",
              "TAYLOR",
              "TERRELL",
              "TERRY",
              "THROCKMORTON",
              "TITUS",
              "TOM GREEN",
              "TRAVIS",
              "TRINITY",
              "TYLER",
              "UPSHUR",
              "UPTON",
              "UVALDE",
              "VAL VERDE",
              "VAN ZANDT",
              "VICTORIA",
              "WALKER",
              "WALLER",
              "WARD",
              "WASHINGTON",
              "WEBB",
              "WHARTON",
              "WHEELER",
              "WICHITA",
              "WILBARGER",
              "WILLACY",
              "WILLIAMSON",
              "WILSON",
              "WINKLER",
              "WISE",
              "WOOD",
              "YOAKUM",
              "YOUNG",
              "ZAPATA",
              "ZAVALA"
            ],
            "type": "string",
            "description": "Only emit licenses whose business or mailing county is this county. Values are TDLR's own uppercase county names; `OUT OF STATE` covers out-of-state licensees. Saved tasks using mixed-case text still work.",
            "default": ""
          },
          "cityFilter": {
            "title": "Filter by city",
            "type": "string",
            "description": "Only emit licenses whose business or mailing city matches, e.g. `Austin`, `San Antonio` or `Green Bay`. Case-insensitive exact city match; a trailing state or ZIP is accepted and ignored."
          },
          "zipFilter": {
            "title": "Filter by ZIP code",
            "type": "string",
            "description": "Only emit licenses whose business or mailing ZIP starts with this 5-digit code, e.g. `78701`. ZIP+4 input is accepted and truncated to the 5-digit prefix."
          },
          "statusFilter": {
            "title": "Filter by license status",
            "enum": [
              "",
              "active",
              "expired"
            ],
            "type": "string",
            "description": "Only emit licenses that are currently active or expired, based on the license expiration date. Leave unset for both.",
            "default": ""
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "licenseNumber",
              "ownerName",
              "businessName",
              "expirationDate"
            ],
            "type": "string",
            "description": "Order results are fetched/emitted in. Defaults to license number.",
            "default": "licenseNumber"
          },
          "sortDirection": {
            "title": "Sort direction",
            "enum": [
              "asc",
              "desc"
            ],
            "type": "string",
            "description": "Ascending or descending for the selected sort field. Expiration sorting is chronological, not month-first text order.",
            "default": "asc"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on emitted license records.",
            "default": 20
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}