{
  "openapi": "3.0.1",
  "info": {
    "title": "Dallas TX Building Permit Records & Contractor Lookup",
    "description": "Search City of Dallas building permit filings by type, land use, ZIP code, contractor, date range, or declared value and area, or look up exact permits by permit number.",
    "version": "2.0",
    "x-build-id": "U8HUaFvRTnMukaIdk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~dallas-tx-building-permit-records-and-contractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-dallas-tx-building-permit-records-and-contractor",
        "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/nimbryxo-studio~dallas-tx-building-permit-records-and-contractor/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-dallas-tx-building-permit-records-and-contractor",
        "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/nimbryxo-studio~dallas-tx-building-permit-records-and-contractor/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-dallas-tx-building-permit-records-and-contractor",
        "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": [
              "search",
              "byPermitNumbers",
              "historicalPermits"
            ],
            "type": "string",
            "description": "Which Dallas permit source and lookup path to use.",
            "default": "search"
          },
          "permitType": {
            "title": "Permit type (live permits)",
            "enum": [
              "",
              "Backflow (BF) Commercial  Alteration",
              "Barricade (BA) Commercial  Alteration",
              "Barricade (BA) Commercial  New Construction",
              "Building (BU) Commercial  Addition",
              "Building (BU) Commercial  Alteration",
              "Building (BU) Commercial  Finish Out",
              "Building (BU) Commercial  New Construction",
              "Building (BU) Commercial  Reconstruction",
              "Building (BU) Commercial  Renovation",
              "Building (BU) Multi Family",
              "Building (BU) Multi Family  Addition",
              "Building (BU) Multi Family  Alteration",
              "Building (BU) Multi Family  Finish Out",
              "Building (BU) Multi Family  New Construction",
              "Building (BU) Multi Family  Reconstruction",
              "Building (BU) Multi Family  Renovation",
              "Building (BU) Single Family  Addition",
              "Building (BU) Single Family  Alteration",
              "Building (BU) Single Family  Finish Out",
              "Building (BU) Single Family  New Construction",
              "Building (BU) Single Family  Reconstruction",
              "Building (BU) Single Family  Renovation",
              "COMM MISC",
              "Commercial Accessory Structure Permit",
              "Commercial Alteration Addition Permit",
              "Commercial Demolition Permit",
              "Commercial Drive Approach and Sidewalk Permit",
              "Commercial Electrical Permit",
              "Commercial Foundation Repair",
              "Commercial Mechanical Permit",
              "Commercial New Construction Permit",
              "Commercial Plumbing Permit",
              "Commercial Pool/Spa Permit",
              "Commercial Roofing Permit",
              "Commercial Solar/PV Permit",
              "Demolition Permit Commercial",
              "Demolition Permit SFD/Duplex",
              "Electrical (EL) Commercial  Alteration",
              "Electrical (EL) Commercial  Renovation",
              "Electrical (EL) Multi Family  Alteration",
              "Electrical (EL) Single Family  Alteration",
              "Electrical (EL) Single Family  Reconstruction",
              "Electrical (EL) Single Family  Renovation",
              "Electrical (EW) Commercial  Alteration",
              "Electrical (EW) Commercial  Reconstruction",
              "Electrical (EW) Commercial  Renovation",
              "Electrical (EW) Multi Family  Alteration",
              "Electrical (EW) Single Family  Alteration",
              "Electrical Sign Alteration",
              "Electrical Sign New Construction",
              "Electrical Sign Reconstruction",
              "Electrical Sign Renovation",
              "Elevator (EV) Commercial  Alteration",
              "Elevator (EV) Single Family  Alteration",
              "Excavation (EX) Commercial  Alteration",
              "Excavation (EX) Commercial  Reconstruction",
              "Excavation (EX) Commercial  Renovation",
              "Excavation (EX) Multi Family  Renovation",
              "Fence (FE) Commercial  Alteration",
              "Fence (FE) Commercial  Reconstruction",
              "Fence (FE) Commercial  Renovation",
              "Fence (FE) Multi Family  Alteration",
              "Fence (FE) Multi Family  Renovation",
              "Fence (FE) Single Family  Alteration",
              "Fence (FE) Single Family  Reconstruction",
              "Fence (FE) Single Family  Renovation",
              "Fire Alarm (FA) Commercial  Alteration",
              "Fire Alarm (FA) Commercial  Reconstruction",
              "Fire Alarm (FA) Commercial  Renovation",
              "Fire Alarm (FA) Multi Family  Alteration",
              "Fire Alarm (FA) Multi Family  Renovation",
              "Fire Alarm (FA) Single Family  Alteration",
              "Fire Sprinkler (Major Work) (FI) Commercial  Alteration",
              "Fire Sprinkler (Major Work) (FI) Commercial  Renovation",
              "Fire Sprinkler (Major Work) (FI) Multi Family  Alteration",
              "Fire Sprinkler (Major Work) (FI) Single Family  Alteration",
              "Fire Sprinkler (Minor Work) (FS) Commercial  Alteration",
              "Fire Sprinkler (Minor Work) (FS) Commercial  New Construction",
              "Fire Sprinkler (Minor Work) (FS) Multi Family  Alteration",
              "Fire Sprinkler (Minor Work) (FS) Single Family  Alteration",
              "Flammable Liquid (FL) Commercial  Renovation",
              "Grading and Paving (GP) Commercial  Alteration",
              "Grading and Paving (GP) Commercial  New Construction",
              "Grading and Paving (GP) Commercial  Reconstruction",
              "Grading and Paving (GP) Commercial  Renovation",
              "Grading and Paving (GP) Multi Family  Renovation",
              "Grading and Paving (GP) Single Family  New Construction",
              "Grading and Paving (GP) Single Family  Reconstruction",
              "Grading and Paving (GP) Single Family  Renovation",
              "Lawn Sprinkler (LS) Commercial  Alteration",
              "Lawn Sprinkler (LS) Commercial  Renovation",
              "Lawn Sprinkler (LS) Multi Family  Alteration",
              "Lawn Sprinkler (LS) Single Family  Alteration",
              "Lawn Sprinkler (LS) Single Family  New Construction",
              "Lawn Sprinkler (LS) Single Family  Reconstruction",
              "Lawn Sprinkler (LS) Single Family  Renovation",
              "Liquor License (LL) Commercial  Alteration",
              "Liquor License (LL) Commercial  Reconstruction",
              "Liquor License (LL) Commercial  Renovation",
              "Liquor License (LL) Multi Family  Alteration",
              "Mechanical (ME) Commercial  Alteration",
              "Mechanical (ME) Commercial  Renovation",
              "Mechanical (ME) Multi Family  Alteration",
              "Mechanical (ME) Single Family  Alteration",
              "Mechanical (ME) Single Family  Reconstruction",
              "Mechanical Refrigeration (MR) Commercial  Alteration",
              "Mechanical Refrigeration (MR) Single Family  Alteration",
              "Medical Gas (MG) Commercial  Alteration",
              "Paving (Sidewalk, Drive Approaches) (PV) Commercial  Alteration",
              "Paving (Sidewalk, Drive Approaches) (PV) Commercial  Renovation",
              "Paving (Sidewalk, Drive Approaches) (PV) Multi Family  Alteration",
              "Paving (Sidewalk, Drive Approaches) (PV) Single Family  Alteration",
              "Paving (Sidewalk, Drive Approaches) (PV) Single Family  Reconstruction",
              "Paving (Sidewalk, Drive Approaches) (PV) Single Family  Renovation",
              "Phase - Alteration Addition",
              "Phase - New Construction",
              "Plumbing (PL) Commercial  Alteration",
              "Plumbing (PL) Commercial  Reconstruction",
              "Plumbing (PL) Commercial  Renovation",
              "Plumbing (PL) Multi Family  Alteration",
              "Plumbing (PL) Single Family  Alteration",
              "Plumbing (PL) Single Family  Reconstruction",
              "Plumbing (PL) Single Family  Renovation",
              "Residential Accessory Structure Permit",
              "Residential Alteration Addition Permit",
              "Residential Demolition Permit",
              "Residential Drive Approach and Sidewalk Permit",
              "Residential Electrical Permit",
              "Residential Foundation Repair",
              "Residential Mechanical Permit",
              "Residential New Construction Permit",
              "Residential Plumbing Permit",
              "Residential Pool/Spa Permit",
              "Residential Roofing Permit",
              "Residential Solar/PV Permit",
              "Security System (SE) Commercial  Alteration",
              "Security System (SE) Commercial  Reconstruction",
              "Security System (SE) Commercial  Renovation",
              "Security System (SE) Multi Family  Alteration",
              "Security System (SE) Multi Family  Renovation",
              "Security System (SE) Single Family  Alteration",
              "Security System (SE) Single Family  Renovation",
              "Sign Alteration",
              "Sign New Construction",
              "Sign Reconstruction",
              "Sign Renovation",
              "Special Purpose Sign New Construction",
              "Supergraphics Alteration",
              "Supergraphics New Construction",
              "Swimming Pool (SW) Commercial  Alteration",
              "Swimming Pool (SW) Commercial  New Construction",
              "Swimming Pool (SW) Commercial  Renovation",
              "Swimming Pool (SW) Multi Family  Alteration",
              "Swimming Pool (SW) Multi Family  Reconstruction",
              "Swimming Pool (SW) Multi Family  Renovation",
              "Swimming Pool (SW) Single Family  Alteration",
              "Swimming Pool (SW) Single Family  Reconstruction",
              "Swimming Pool (SW) Single Family  Renovation",
              "Tent (TE) Commercial  Alteration",
              "Tent (TE) Commercial  Reconstruction",
              "Tent (TE) Commercial  Renovation",
              "Tent (TE) Multi Family  Renovation",
              "Tent (TE) Single Family  Renovation",
              "Tree Removal (TR) Commercial  Alteration",
              "Tree Removal (TR) Commercial  Renovation",
              "Tree Removal (TR) Multi Family  Renovation",
              "Tree Removal (TR) Single Family  Renovation"
            ],
            "type": "string",
            "description": "Filter live permits to one exact type (mode=search). The list covers all 167 types in the current dataset, including the newer Accela-era names. Use 'Any permit type' to skip this filter.",
            "default": ""
          },
          "permitTypeCustom": {
            "title": "Permit type contains (live permits)",
            "type": "string",
            "description": "Free-text contains-match on the live permit type (mode=search). Takes precedence over 'Permit type (live permits)' when set. Example: 'Solar'."
          },
          "landUse": {
            "title": "Land use (live permits)",
            "enum": [
              "",
              "SINGLE FAMILY DWELLING",
              "MULTI-FAMILY DWELLING",
              "OFFICE BUILDING",
              "VACANT FLOOR SPACE",
              "RESTAURANT WITHOUT DRIVE-IN SERVICE",
              "GEN MERCHANDISE OR FOOD STORE < 3500 SQ. FT.",
              "OFFICE SHOWROOM/WAREHOUSE",
              "GEN MERCHANDISE OR FOOD STORE > 3500 SQ. FT.",
              "TWO FAMILY DWELLING",
              "TOWER/ANTENNA FOR CELLULAR COMMUNICATION",
              "COMMUNICATIONS",
              "PERSONAL SERVICE USE",
              "FAIRGROUNDS",
              "MEDICAL CLINIC OR AMBULATORY SURGICAL CENTER",
              "STREET BARRICADE",
              "RESTAURANT WITH DRIVE-IN SERVICE",
              "PUBLIC OR PRIVATE SCHOOL",
              "HOTEL",
              "CHURCH, SYNAGOGUE, TEMPLE, MOSQUE",
              "SHELL BUILDING",
              "HOSPITAL",
              "WAREHOUSE",
              "VEHICLE DISPLAY,SALES AND SERVICE",
              "INDUSTRIAL (INSIDE)",
              "COMMERCIAL AMUSEMENT (INSIDE)",
              "AUTO SERVICE CENTER",
              "PUBLIC PARK, PLAYGROUND, OR GOLF COURSE",
              "MANUFACTURED HOME PARK",
              "FINANCIAL INSTITUTION WITH DRIVE-IN WINDOW",
              "UTILITIES",
              "RETIREMENT HOUSING",
              "COMMERCIAL PARKING LOT OR GARAGE",
              "FINANCIAL INSTITUTION WITHOUT DRIVE-IN WINDOW",
              "VEHICLE OR ENGINE REPAIR OR MAINTENANCE",
              "COLLEGE, UNIVERSITY, OR SEMINARY",
              "MINI-WAREHOUSE",
              "ALCOHOLIC BEVERAGE ESTABLISHMENT",
              "INDUSTRIAL (INSIDE) FOR LIGHT MANUFACTURING",
              "COMMERCIAL",
              "SIDEWALK BARRICADE",
              "CHILD CARE FACILITY",
              "MIXED INCOME MULTI-FAMILY",
              "UNDEVELOPED LAND AREA",
              "ANIMAL SHELTER OR CLINIC",
              "MACHINERY, HEAVY EQUIP. OR TRUCK SALES & SERVICE",
              "PRIVATE RECREATION CENTER, CLUB OR AREA",
              "CONVALESCENT & NURSING HOMES & RELATED INSTITUTION",
              "CAR WASH",
              "DRY CLEANING OR LAUNDRY STORE",
              "UTILITY OR GOVERNMENTAL INSTALLATION (OTHER)",
              "AIRPORT OR LANDING FIELD",
              "GEN MERCHANDISE (NO FOOD) STORE < 3500 SQ. FT",
              "Motor Vehicle Fueling Station",
              "COMMUNITY SERVICE CENTER",
              "FURNITURE STORE",
              "LIQUOR STORE",
              "SHOPPING CENTER",
              "THEATER",
              "COUNTRY CLUB WITH PRIVATE MEMBERSHIP",
              "COMMON GREEN",
              "GEN MERCHANDISE OR FOOD STORE>=100000 SQ FT",
              "HOME IMPROVEMENT CENTER/ BLDG MATERIALS SALES YARD",
              "LOCAL UTILITIES",
              "CATERING SERVICE",
              "COMMERCIAL AMUSEMENT (OUTSIDE)",
              "FIRE STATION",
              "MEDICAL OR SCIENTIFIC LABORATORY",
              "TEMPORARY CONSTRUCTION OFFICE",
              "MUSEUM",
              "DETACHED NON-PREMISE SIGN",
              "FREIGHT TERMINAL",
              "MORTUARY, FUNERAL HOME, OR COMM. WEDDING CHAPEL",
              "SURFACE PARKING",
              "PAWN SHOP",
              "OUTSIDE STORAGE",
              "PRIMARY SCHOOL",
              "INDUSTRIAL (INSIDE) POTENTIALLY INCOMPATIBLE",
              "MOTEL",
              "TRANSIT PASSENGER STATION OR TRANSFER CENTER",
              "JOB OR LITHOGRAPHIC PRINTING",
              "BUSINESS SCHOOL",
              "COMMERCIAL BUS STATION AND TERMINAL",
              "NURSERY, GARDEN SHOP, OR PLANT SALES",
              "Truck Stop",
              "DEPARTMENT STORES-RETAIL",
              "TECHNICAL SCHOOL",
              "TRADE CENTER",
              "CUSTOM BUSINESS SERVICES",
              "OTHER TRNSP,CONMUN & UTILITIES",
              "MISCELLANEOUS",
              "FITNESS CENTER",
              "CONTRACTOR'S MAINTENANCE YARD",
              "LIBRARY",
              "INDUSTRIAL (OUTSIDE)",
              "Alcoholic beverage manufacturing",
              "OUTDOOR ADVERTISING",
              "MACHINE OR WELDING SHOP",
              "ELECTRONICS SERVICE CENTER",
              "HANDICAPPED GROUP DWELLING",
              "ART GALLERY",
              "CROP PRODUCTION",
              "BANK RELATED FUNCTIONS",
              "PERSONAL SERVICES",
              "GROUP HOME OR SHELTER",
              "COLLEGE DORMITORY",
              "COMMERCIAL MOTOR VEHICLE PARKING",
              "CUSTOM WOODWORKING, FURNITURE CONSTRUCTION OR REP",
              "FOOD OR BEVERAGE STORE  <= 3,500 SQ. FT.",
              "GROCERIES-RETAIL",
              "SECONDARY SCHOOL",
              "TEMPORARY CONCRETE OR ASPHALT BATCHING PLANT",
              "GROUP RESIDENTIAL FACILITY",
              "POLICE STATION",
              "ADULT DAY CARE FACILITY",
              "BUILDING REPAIR & MAINTENANCE SHOP",
              "BUS OR RAIL TRANSIT VEHICLE MAINTANCE OR STORAGE",
              "CEMETERY OR MAUSOLEUM",
              "COMMERCIAL CLEANING OR LAUNDRY PLANT",
              "TEMPORARY RETAIL USE (INCLUDES CHRISTMAS TREE LOT)",
              "TOOL OR EQUIPMENT RENTAL",
              "NURSERY SCHOOL",
              "FOSTER HOME",
              "AUTO AUCTION",
              "MUNICIPAL SERVICE CENTER",
              "METAL SALVAGE FACILITY",
              "ACCESSORY BUILDING TO SINGLE FAMILY DWELLING",
              "PARAPHERNALIA SHOP",
              "PETROLEUM PRODUCT STORAGE AND WHOLESALE",
              "WATER TREATMENT PLANT",
              "OVERNIGHT GENERAL PURPOSE SHELTER",
              "PROFESSIONAL SCHOOL",
              "BANKING SERVICES",
              "RESIDENTIAL HOTEL",
              "JUNIOR COLLEGE",
              "DENTIST",
              "VEHICLE STORAGE LOT",
              "AMUSEMENT",
              "LODGING OR BOARDING HOUSE",
              "TRANSIT PASSENGER SHELTER",
              "OTHER AUTO SERVICES",
              "FLOOD CONTROL PUMP STATION",
              "PRIVATE STABLE",
              "RADIO, TELEVISION OR MICROWAVE TOWER",
              "CONVENT OR MONASTERY",
              "Accessory Community Center (Private)",
              "TEMP SALES OFFICE - REAL ESTATE",
              "SANITARY LANDFILL",
              "COMMERCIAL RADIO TRANSMITTING STATION",
              "MTR VEH USED CAR ONLY RETAIL--CODE NO LONGER USED",
              "PETROLEUM REFIN & RELATED PR",
              "POST OFFICE",
              "HALFWAY HOUSE",
              "PUBLIC ASSEMBLY",
              "RAILROAD PASSENGER STATION",
              "RAILROAD YARD, ROUNDHOUSE, OR SHOPS",
              "REFUSE TRANSFER STATION",
              "INDUSTRIAL (OUTSIDE) POTENTIALLY INCOMPATIBLE",
              "CONV FROM 2 FAMILY TO SFD",
              "COMMERCIAL TELEVISION TRANSMITTING STATION",
              "BEAUTY SERVICES",
              "MISC MANUFACTURING, NEC",
              "ELECTRICAL SUBSTATION",
              "RETAIL TRADE APPAREL & ACCES NO LONGER USED",
              "RESIDENTIAL GARAGE OR CARPORT",
              "OUTSIDE SALVAGE & RECLAMATION",
              "REPAIR SERVICES",
              "TEMPORARY TENT - RETAIL",
              "RECYCLING COLLECTION CENTER",
              "GOVERNMENTAL SERVICES",
              "HOUSEHOLD EQUIPMENT & APPLIANCE REPAIR",
              "PRIVATE STREET OR ALLEY",
              "ANIMAL PRODUCTION",
              "ADVERTISING SERVICES GENERAL",
              "SAND, GRAVEL, OR EARTH SALES AND STORAGE",
              "SEWAGE TREATMENT PLANT",
              "HELIPORT",
              "AMBULANCE SERVICE",
              "OTHER ADVERTIS SERV, NEC",
              "CARNIVAL OR CIRCUS (TEMPORARY)",
              "JUNIOR HIGH SCHOOL",
              "PARK PUBLIC ROW",
              "Alternative Financial Institutions",
              "HAZARDOUS WASTE MANAGEMENT FACILITY",
              "MOTOR VEHICLE TRANSPORTATION",
              "Special Institutional Uses",
              "SPECIAL PURPOSE SIGN",
              "MUNICIPAL WASTE INCINERATOR",
              "STREET DECORATIONS",
              "COMMERCIAL STABLE",
              "PET SHOP/ANIMAL GROOMING",
              "SAVINGS & LOAN ASSOCIATION",
              "INSTITUTE FOR SPECIAL EDUCATION",
              "MANUFACTURED BUILDING SALES LOT",
              "FARM"
            ],
            "type": "string",
            "description": "Filter live permits to one exact land-use classification (mode=search). The list covers all 194 non-empty values currently in the dataset. Use 'Any land use' to skip this filter.",
            "default": ""
          },
          "landUseCustom": {
            "title": "Land use contains (live permits)",
            "type": "string",
            "description": "Free-text contains-match on the live land use (mode=search). Takes precedence over 'Land use (live permits)' when set. Example: 'HOSPITAL'."
          },
          "zipCode": {
            "title": "ZIP code",
            "enum": [
              "",
              "75001",
              "75006",
              "75007",
              "75019",
              "75024",
              "75039",
              "75040",
              "75041",
              "75042",
              "75050",
              "75051",
              "75052",
              "75062",
              "75063",
              "75080",
              "75081",
              "75088",
              "75089",
              "75104",
              "75115",
              "75116",
              "75134",
              "75141",
              "75149",
              "75150",
              "75159",
              "75180",
              "75182",
              "75201",
              "75202",
              "75203",
              "75204",
              "75205",
              "75206",
              "75207",
              "75208",
              "75209",
              "75210",
              "75211",
              "75212",
              "75214",
              "75215",
              "75216",
              "75217",
              "75218",
              "75219",
              "75220",
              "75223",
              "75224",
              "75225",
              "75226",
              "75227",
              "75228",
              "75229",
              "75230",
              "75231",
              "75232",
              "75233",
              "75234",
              "75235",
              "75236",
              "75237",
              "75238",
              "75240",
              "75241",
              "75243",
              "75244",
              "75246",
              "75247",
              "75248",
              "75249",
              "75251",
              "75252",
              "75253",
              "75254",
              "75270",
              "75287"
            ],
            "type": "string",
            "description": "Restrict results to one Dallas-area ZIP code. Works in both live and historical modes.",
            "default": ""
          },
          "workDescriptionKeyword": {
            "title": "Work description contains",
            "type": "string",
            "description": "Only include permits whose work description contains this text (case-insensitive), e.g. 'swimming pool', 'water heater', 'roof'. Works in both live and historical modes."
          },
          "streetAddressKeyword": {
            "title": "Street address contains",
            "type": "string",
            "description": "Only include permits whose street address contains this text (case-insensitive), e.g. 'MAIN ST', 'ELM'. Works in both live and historical modes."
          },
          "contractorKeyword": {
            "title": "Contractor contains (live permits)",
            "type": "string",
            "description": "Only include live permits whose contractor field contains this text (case-insensitive), e.g. a contractor company name. Historical GIS records do not publish contractor names."
          },
          "mapscoKeyword": {
            "title": "Mapsco grid contains (live permits)",
            "type": "string",
            "description": "Only include live permits whose Dallas Mapsco grid reference contains this text (case-insensitive), e.g. '54-B'. There are 3,000+ distinct values, so this is contains-match only."
          },
          "hasContractor": {
            "title": "Only permits with a contractor",
            "type": "boolean",
            "description": "Skip live permits whose contractor field is blank or the owner-builder placeholder. Useful for contractor lead lists. Historical records never carry contractor data.",
            "default": false
          },
          "issuedDateFrom": {
            "title": "Issued date from (YYYY-MM-DD)",
            "type": "string",
            "description": "Only include permits issued on or after this date. Live data covers 2018 to today; historical data covers 1971-02-01 through 2024-11-12."
          },
          "issuedDateTo": {
            "title": "Issued date to (YYYY-MM-DD)",
            "type": "string",
            "description": "Only include permits issued on or before this date. Live data covers 2018 to today; historical data covers 1971-02-01 through 2024-11-12."
          },
          "minValue": {
            "title": "Min permit value (USD)",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Drop permits with a declared value lower than this. Works in both live and historical modes."
          },
          "maxValue": {
            "title": "Max permit value (USD)",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Drop permits with a declared value higher than this. Works in both live and historical modes."
          },
          "minArea": {
            "title": "Min area (sq ft)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Drop permits with a declared area smaller than this. Works in both live and historical modes."
          },
          "maxArea": {
            "title": "Max area (sq ft)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Drop permits with a declared area larger than this. Works in both live and historical modes."
          },
          "sortBy": {
            "title": "Sort live permits by",
            "enum": [
              "default",
              "valueHighToLow",
              "valueLowToHigh",
              "areaHighToLow",
              "areaLowToHigh",
              "issuedDateNewestFirst",
              "issuedDateOldestFirst"
            ],
            "type": "string",
            "description": "Ordering for mode=search. Historical mode uses 'Historical sort by' instead.",
            "default": "default"
          },
          "historicalPermitType": {
            "title": "Historical permit type",
            "enum": [
              "",
              "Building (BU)",
              "Plumbing (PL)",
              "Electrical (EL)",
              "Mechanical (ME)",
              "Electrical (EW)",
              "Lawn Sprinkler (LS)",
              "Fence (FE)",
              "Paving (Sidewalk, Drive Approaches) (PV)",
              "Swimming Pool (SW)",
              "Security System (SE)",
              "Fire Alarm (FA)",
              "Barricade (BA)",
              "Fire Sprinkler (Minor Work) (FS)",
              "Flammable Liquid (FL)",
              "Liquor License (LL)",
              "Tent (TE)",
              "Fire Sprinkler (Major Work) (FI)",
              "Excavation (EX)",
              "Grading and Paving (GP)",
              "Mechanical Refrigeration (MR)",
              "Landscape (LA)",
              "Backflow (BF)",
              "Tree Removal (TR)",
              "Elevator (EV)",
              "Foundation (FO)",
              "Medical Gas (MG)",
              "Customer Service (CS)",
              "Water Treatment (WT)",
              "Tree Mitigation (MI)",
              "Health (HE)",
              "Demolition (DE)",
              "Electrical Sign (ES)",
              "Sign (SI)",
              "Special Purpose Sign (SP)",
              "Multi-Purpose for Fire Systems (MP)"
            ],
            "type": "string",
            "description": "Filter historical permits (mode=historicalPermits) to one of the City's 35 permit types. Historical records use the coarse pre-Accela type code, not the longer live permit-type labels.",
            "default": ""
          },
          "historicalActivity": {
            "title": "Historical activity",
            "enum": [
              "",
              "(B) Alteration",
              "(B) Alteration or Reconstruction or Renovation",
              "(A) New Construction",
              "(B) Renovation",
              "(G) Addition",
              "(B) Reconstruction",
              "(B) Finish Out"
            ],
            "type": "string",
            "description": "Filter historical permits by activity, such as new construction, alteration, renovation, addition, reconstruction, or finish out.",
            "default": ""
          },
          "historicalStatus": {
            "title": "Historical status",
            "enum": [
              "",
              "Complete",
              "Cancelled",
              "Expired",
              "Issued",
              "Revoked",
              "New",
              "Approved",
              "In Review",
              "New Web Application",
              "Rejected",
              "Not Approved",
              "Web Application Approved",
              "Unknown",
              "Customer Time",
              "Web Application Received",
              "Suspended",
              "Customer Time Express",
              "In Express Review"
            ],
            "type": "string",
            "description": "Filter historical permits by the status recorded when the City extracted the layer in November 2024. Some statuses occur only on unissued applications; those records are returned without an issuedDate.",
            "default": ""
          },
          "historicalCategory": {
            "title": "Historical category",
            "enum": [
              "",
              "Single Family",
              "Commercial",
              "Multi Family"
            ],
            "type": "string",
            "description": "Filter historical permits by the City's project category.",
            "default": ""
          },
          "councilDistrict": {
            "title": "Council district (historical)",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5",
              "6",
              "7",
              "8",
              "9",
              "10",
              "11",
              "12",
              "13",
              "14"
            ],
            "type": "string",
            "description": "Filter historical permits to one Dallas City Council district (1-14).",
            "default": ""
          },
          "historicalLandUseKeyword": {
            "title": "Historical land use contains",
            "type": "string",
            "description": "Contains-match on the historical land-use description. The layer has 600+ detailed values, so a free-text match is more practical than a dropdown. Example: 'RESTAURANT'."
          },
          "historicalSortBy": {
            "title": "Historical sort by",
            "enum": [
              "issuedDateNewestFirst",
              "issuedDateOldestFirst",
              "createdDateNewestFirst",
              "createdDateOldestFirst",
              "valueHighToLow",
              "valueLowToHigh",
              "areaHighToLow",
              "areaLowToHigh",
              "unitsHighToLow",
              "unitsLowToHigh"
            ],
            "type": "string",
            "description": "Ordering for mode=historicalPermits.",
            "default": "issuedDateNewestFirst"
          },
          "permitNumbers": {
            "title": "Permit numbers (mode=byPermitNumbers)",
            "type": "array",
            "description": "Exact Dallas permit numbers to look up, e.g. '2003133024', '2411126010', or 'RES-PLM-26-002314'. Live records are checked first; historical GIS records fill any missing permit and merge extra fields when both sources have it.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Hard cap on emitted records per run (maximum 10,000). To collect more, split by smaller date ranges, permit types, or council districts and combine the datasets.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}