{
  "data": {
    "id": "QTWURFBPdOZ8on8l5",
    "actId": "F0xcqUlCNCf9scVZH",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-17T13:15:58.957Z",
    "finishedAt": "2026-11-17T13:16:04.887Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 5826,
      "runTimeSecs": 5.826,
      "computeUnits": 0.0064733333333333335,
      "imageSizeBytes": 319333376
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Los Angeles Building Permits Scraper Input\",\n  \"description\": \"Search live LADBS permit records (building, electrical, mechanical; issued or submitted), certificates of occupancy, or the legacy detailed dataset - or look up exact permits by number, address, contractor, or assessor parcel.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"How to find permits. Search applies filters and returns a list; the lookup modes resolve exact numbers, an address, a contractor, or an assessor parcel.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"What to fetch\",\n      \"enum\": [\n        \"search\",\n        \"byPermitNumbers\",\n        \"byAddress\",\n        \"byContractor\",\n        \"byAssessorParcel\"\n      ],\n      \"enumTitles\": [\n        \"Search / filter permits\",\n        \"Look up by permit number(s)\",\n        \"Look up by property address\",\n        \"Look up by contractor name\",\n        \"Look up by assessor parcel (Book-Page-Parcel)\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"dataset\": {\n      \"title\": \"Dataset\",\n      \"type\": \"string\",\n      \"description\": \"Which LADBS record family to read. 'issuedBuilding' is the current live building-permit feed and the best default. 'submittedBuilding' returns applications before issuance (useful for early leads). Electrical and mechanical datasets carry trade permits. 'certificateOfOccupancy' returns completed/occupiable buildings with contractor details. 'legacyDetailed' is the frozen 2015-2023 detailed dataset.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"issuedBuilding\",\n        \"submittedBuilding\",\n        \"issuedElectrical\",\n        \"submittedElectrical\",\n        \"issuedMechanical\",\n        \"submittedMechanical\",\n        \"certificateOfOccupancy\",\n        \"legacyDetailed\"\n      ],\n      \"enumTitles\": [\n        \"Building permits - issued (current, recommended)\",\n        \"Building permit applications - submitted\",\n        \"Electrical permits - issued\",\n        \"Electrical permit applications - submitted\",\n        \"Mechanical permits - issued\",\n        \"Mechanical permit applications - submitted\",\n        \"Certificates of Occupancy\",\n        \"Legacy detailed permits (2015-2023, frozen)\"\n      ],\n      \"default\": \"issuedBuilding\",\n      \"prefill\": \"issuedBuilding\"\n    },\n    \"permitNumbers\": {\n      \"title\": \"Permit numbers\",\n      \"type\": \"array\",\n      \"description\": \"Exact PCIS permit numbers for mode=byPermitNumbers. Paste one or many, with hyphens or spaces. Example: 24016-20000-19408.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"streetNumber\": {\n      \"title\": \"Street number\",\n      \"type\": \"string\",\n      \"description\": \"Building street number for mode=byAddress. Optional: leave empty to return every permit on the street. Example: 6500.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Address lookup / street filters\"\n    },\n    \"streetName\": {\n      \"title\": \"Street name\",\n      \"type\": \"string\",\n      \"description\": \"Street name without direction or suffix. Required for mode=byAddress (exact street match); in search mode it is a substring filter on the address. Example: HARVARD.\",\n      \"editor\": \"textfield\"\n    },\n    \"streetDirection\": {\n      \"title\": \"Street direction\",\n      \"type\": \"string\",\n      \"description\": \"Filter to a single street direction prefix. Applied server-side on detailed datasets and to the published address on live feeds.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"N\",\n        \"S\",\n        \"E\",\n        \"W\"\n      ],\n      \"enumTitles\": [\n        \"Any direction\",\n        \"North\",\n        \"South\",\n        \"East\",\n        \"West\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"streetSuffix\": {\n      \"title\": \"Street suffix\",\n      \"type\": \"string\",\n      \"description\": \"Filter to a single street-suffix abbreviation. Applied server-side on detailed datasets and to the published address on live feeds.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"AVE\",\n        \"ST\",\n        \"BLVD\",\n        \"DR\",\n        \"PL\",\n        \"RD\",\n        \"WAY\",\n        \"LN\",\n        \"CT\",\n        \"CIR\",\n        \"TER\",\n        \"TERR\",\n        \"PKWY\",\n        \"HWY\",\n        \"TRL\",\n        \"WALK\",\n        \"CRK\",\n        \"GLN\",\n        \"PASS\",\n        \"SQ\",\n        \"VIS\",\n        \"ALY\",\n        \"PT\",\n        \"ROW\",\n        \"MALL\",\n        \"PARK\",\n        \"GRN\",\n        \"RIDGE\",\n        \"CYN\",\n        \"HILL\",\n        \"VIEW\",\n        \"COVE\",\n        \"PZ\",\n        \"CL\",\n        \"LOOP\"\n      ],\n      \"enumTitles\": [\n        \"Any suffix\",\n        \"Avenue\",\n        \"Street\",\n        \"Boulevard\",\n        \"Drive\",\n        \"Place\",\n        \"Road\",\n        \"Way\",\n        \"Lane\",\n        \"Court\",\n        \"Circle\",\n        \"Terrace\",\n        \"Terrace (TERR)\",\n        \"Parkway\",\n        \"Highway\",\n        \"Trail\",\n        \"Walk\",\n        \"Creek\",\n        \"Glen\",\n        \"Pass\",\n        \"Square\",\n        \"Vista\",\n        \"Alley\",\n        \"Point\",\n        \"Row\",\n        \"Mall\",\n        \"Park\",\n        \"Green\",\n        \"Ridge\",\n        \"Canyon\",\n        \"Hill\",\n        \"View\",\n        \"Cove\",\n        \"Plaza\",\n        \"Circle (CL)\",\n        \"Loop\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"assessorBook\": {\n      \"title\": \"Assessor book\",\n      \"type\": \"string\",\n      \"description\": \"LA County Assessor Identification Number (AIN) book component, for mode=byAssessorParcel. All three components are required. Example: 2405.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Assessor parcel lookup\"\n    },\n    \"assessorPage\": {\n      \"title\": \"Assessor page\",\n      \"type\": \"string\",\n      \"description\": \"AIN page component. Example: 003.\",\n      \"editor\": \"textfield\"\n    },\n    \"assessorParcel\": {\n      \"title\": \"Assessor parcel\",\n      \"type\": \"string\",\n      \"description\": \"AIN parcel component. Example: 032.\",\n      \"editor\": \"textfield\"\n    },\n    \"contractorName\": {\n      \"title\": \"Contractor business name\",\n      \"type\": \"string\",\n      \"description\": \"Exact contractor business name for mode=byContractor (Certificate of Occupancy + legacy detailed datasets, including the 2013-2023 all-trades file); substring filter in search mode (Certificate of Occupancy + 2015-2023 legacy detailed datasets). These are the only sources that publish contractor names; status is refreshed from the live feed.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Permit filters\"\n    },\n    \"workDescriptionKeyword\": {\n      \"title\": \"Work description contains\",\n      \"type\": \"string\",\n      \"description\": \"Case-insensitive substring match on the permit's work description. Example: swimming pool.\",\n      \"editor\": \"textfield\"\n    },\n    \"useDescriptionKeyword\": {\n      \"title\": \"Use description contains\",\n      \"type\": \"string\",\n      \"description\": \"Case-insensitive substring match on the LADBS use description. Example: Accessory Dwelling Unit, Office, Retail. Available on live feeds.\",\n      \"editor\": \"textfield\"\n    },\n    \"permitType\": {\n      \"title\": \"Permit type\",\n      \"type\": \"string\",\n      \"description\": \"Filter to one LADBS permit type. Building values include Bldg-New, Bldg-Addition, Bldg-Alter/Repair, Bldg-Demolition, Grading, Swimming-Pool/Spa and Sign. Electrical and mechanical types (Electrical, Plumbing, HVAC, Fire Sprinkler, Elevator, Pressure Vessel) automatically select the matching trade dataset when dataset is left at its default.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Bldg-New\",\n        \"Bldg-Addition\",\n        \"Bldg-Alter/Repair\",\n        \"Bldg-Demolition\",\n        \"Bldg-Relocation\",\n        \"Nonbldg-New\",\n        \"Nonbldg-Addition\",\n        \"Nonbldg-Alter/Repair\",\n        \"Nonbldg-Demolition\",\n        \"Grading\",\n        \"Swimming-Pool/Spa\",\n        \"Sign\",\n        \"Electrical\",\n        \"Plumbing\",\n        \"HVAC\",\n        \"Fire Sprinkler\",\n        \"Elevator\",\n        \"Pressure Vessel\"\n      ],\n      \"enumTitles\": [\n        \"Any permit type\",\n        \"New building\",\n        \"Addition\",\n        \"Alteration / repair\",\n        \"Demolition\",\n        \"Building relocation\",\n        \"New non-building structure\",\n        \"Non-building addition\",\n        \"Non-building alteration / repair\",\n        \"Non-building demolition\",\n        \"Grading\",\n        \"Swimming pool / spa\",\n        \"Sign\",\n        \"Electrical\",\n        \"Plumbing\",\n        \"HVAC\",\n        \"Fire sprinkler\",\n        \"Elevator\",\n        \"Pressure vessel\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"permitSubType\": {\n      \"title\": \"Permit sub-type\",\n      \"type\": \"string\",\n      \"description\": \"Filter to one building-use sub-type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"1 or 2 Family Dwelling\",\n        \"Apartment\",\n        \"Commercial\",\n        \"Onsite\",\n        \"Offsite\",\n        \"Public Safety Only\",\n        \"Special Equipment\"\n      ],\n      \"enumTitles\": [\n        \"Any sub-type\",\n        \"1 or 2 Family Dwelling\",\n        \"Apartment\",\n        \"Commercial\",\n        \"Onsite\",\n        \"Offsite\",\n        \"Public safety only\",\n        \"Special equipment\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"permitCategory\": {\n      \"title\": \"Plan check category\",\n      \"type\": \"string\",\n      \"description\": \"Filter by plan-check path. 'No Plan Check' means express/e-permit; 'Plan Check' means plans were reviewed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Plan Check\",\n        \"No Plan Check\"\n      ],\n      \"enumTitles\": [\n        \"Any category\",\n        \"Plan Check\",\n        \"No Plan Check (Express/e-Permit)\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"status\": {\n      \"title\": \"Status\",\n      \"type\": \"string\",\n      \"description\": \"Filter to one current status. The exact wording differs by dataset (issued, submitted, CoO).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"CofC Corrected\",\n        \"CofC Issued\",\n        \"CofO Corrected\",\n        \"CofO in Progress\",\n        \"CofO Issued\",\n        \"CofO Reactivated\",\n        \"CofO Revoked\",\n        \"CofO Superseded\",\n        \"Conditional Approval\",\n        \"Corrections Issued\",\n        \"Corrections Issued 2\",\n        \"Intent to Correct CofC\",\n        \"Intent to Revoke\",\n        \"Intent to Revoke CofC\",\n        \"Issued\",\n        \"No Progress\",\n        \"Not Ready to Issue\",\n        \"Not Required\",\n        \"OK for CofC\",\n        \"OK to Issue CofC\",\n        \"Order to Comply Issued\",\n        \"PC Approved\",\n        \"PC Assigned\",\n        \"PC in Progress\",\n        \"PC Info Complete\",\n        \"Permit Closed\",\n        \"Permit Expired\",\n        \"Permit Extended\",\n        \"Permit Finaled\",\n        \"Permit Revoked\",\n        \"Permit Withdrawn\",\n        \"Plans on Hold\",\n        \"Quality Review Completed\",\n        \"Re-Activate Permit\",\n        \"Ready to Issue\",\n        \"Refund Completed\",\n        \"Refund Denied\",\n        \"Refund in Progress\",\n        \"Reviewed by Supervisor\",\n        \"Submitted\",\n        \"Submitted for Quality Review\",\n        \"Verifications in Progress\"\n      ],\n      \"enumTitles\": [\n        \"Any status\",\n        \"CofC Corrected\",\n        \"CofC Issued\",\n        \"CofO Corrected\",\n        \"CofO in Progress\",\n        \"CofO Issued\",\n        \"CofO Reactivated\",\n        \"CofO Revoked\",\n        \"CofO Superseded\",\n        \"Conditional Approval\",\n        \"Corrections Issued\",\n        \"Corrections Issued 2\",\n        \"Intent to Correct CofC\",\n        \"Intent to Revoke\",\n        \"Intent to Revoke CofC\",\n        \"Issued\",\n        \"No Progress\",\n        \"Not Ready to Issue\",\n        \"Not Required\",\n        \"OK for CofC\",\n        \"OK to Issue CofC\",\n        \"Order to Comply Issued\",\n        \"PC Approved\",\n        \"PC Assigned\",\n        \"PC in Progress\",\n        \"PC Info Complete\",\n        \"Permit Closed\",\n        \"Permit Expired\",\n        \"Permit Extended\",\n        \"Permit Finaled\",\n        \"Permit Revoked\",\n        \"Permit Withdrawn\",\n        \"Plans on Hold\",\n        \"Quality Review Completed\",\n        \"Re-Activate Permit\",\n        \"Ready to Issue\",\n        \"Refund Completed\",\n        \"Refund Denied\",\n        \"Refund in Progress\",\n        \"Reviewed by Supervisor\",\n        \"Submitted\",\n        \"Submitted for Quality Review\",\n        \"Verifications in Progress\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"initiatingOffice\": {\n      \"title\": \"Initiating office\",\n      \"type\": \"string\",\n      \"description\": \"Filter to a single LADBS district office. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"METRO\",\n        \"VAN NUYS\",\n        \"INTERNET\",\n        \"WEST LA\",\n        \"SOUTH LA\",\n        \"SANPEDRO\"\n      ],\n      \"enumTitles\": [\n        \"Any office\",\n        \"Metro\",\n        \"Van Nuys\",\n        \"Internet (e-Permit)\",\n        \"West LA\",\n        \"South LA\",\n        \"San Pedro\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"occupancy\": {\n      \"title\": \"Occupancy group\",\n      \"type\": \"string\",\n      \"description\": \"Building-code occupancy classification. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"A1 Occ. Group\",\n        \"A2 Occ. Group\",\n        \"A3 Occ. Group\",\n        \"A5 Occ. Group\",\n        \"B Occ. Group\",\n        \"E Occ. Group\",\n        \"E1 Occ. Group\",\n        \"E3 Occ. Group\",\n        \"F1 Occ. Group\",\n        \"F2 Occ. Group\",\n        \"H4 Occ. Group\",\n        \"I2 Occ. Group\",\n        \"M Occ. Group\",\n        \"Misc. Occ. Group\",\n        \"R1 Occ. Group\",\n        \"R2 Occ. Group\",\n        \"R2.1 Occ. Group\",\n        \"R3 Occ. Group\",\n        \"R4 Occ. Group\",\n        \"S1 Occ. Group\",\n        \"S2 Occ. Group\",\n        \"S3 Occ. Group\",\n        \"U Occ. Group\",\n        \"U1 Occ. Group\",\n        \"U2 Occ. Group\"\n      ],\n      \"enumTitles\": [\n        \"Any occupancy\",\n        \"A1 - Assembly (fixed seats)\",\n        \"A2 - Assembly (food/drink)\",\n        \"A3 - Assembly (worship/amusement)\",\n        \"A5 - Assembly (outdoor)\",\n        \"B - Business\",\n        \"E - Educational\",\n        \"E1 - Educational\",\n        \"E3 - Educational\",\n        \"F1 - Factory (moderate hazard)\",\n        \"F2 - Factory (low hazard)\",\n        \"H4 - High hazard\",\n        \"I2 - Institutional (medical)\",\n        \"M - Mercantile\",\n        \"Miscellaneous\",\n        \"R1 - Residential (hotel/motel)\",\n        \"R2 - Residential (apartments)\",\n        \"R2.1 - Residential (assisted living)\",\n        \"R3 - Residential (1-2 family)\",\n        \"R4 - Residential (assisted living, small)\",\n        \"S1 - Storage (moderate hazard)\",\n        \"S2 - Storage (low hazard)\",\n        \"S3 - Storage (vehicles/repair)\",\n        \"U - Utility/Misc.\",\n        \"U1 - Utility/Misc.\",\n        \"U2 - Utility/Misc.\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"constructionType\": {\n      \"title\": \"Construction type\",\n      \"type\": \"string\",\n      \"description\": \"Building-code construction class, published on live feeds for a minority of permits.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Type I-A Construction\",\n        \"Type I-B Construction\",\n        \"Type I-F.R. Construction\",\n        \"Type II-A Construction\",\n        \"Type II-B Construction\",\n        \"Type II-F.R. Construction\",\n        \"Type III-A Construction\",\n        \"Type III-B Construction\",\n        \"Type III-N Construction\",\n        \"Type IV-H.T. Construction\",\n        \"Type V-A Construction\",\n        \"Type V-B Construction\",\n        \"Type V-N Construction\",\n        \"Type V-1HR Construction\"\n      ],\n      \"enumTitles\": [\n        \"Any construction type\",\n        \"Type I-A\",\n        \"Type I-B\",\n        \"Type I-F.R.\",\n        \"Type II-A\",\n        \"Type II-B\",\n        \"Type II-F.R.\",\n        \"Type III-A\",\n        \"Type III-B\",\n        \"Type III-N\",\n        \"Type IV-H.T.\",\n        \"Type V-A\",\n        \"Type V-B\",\n        \"Type V-N\",\n        \"Type V-1HR\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"businessUnit\": {\n      \"title\": \"Issuing business unit\",\n      \"type\": \"string\",\n      \"description\": \"How LADBS processed the permit. Express Permit is the same as No Plan Check.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Express Permit\",\n        \"Plan Check at Counter\",\n        \"Regular Plan Check\",\n        \"Expanded Counter Plan Check\",\n        \"Appointment Plan Check\"\n      ],\n      \"enumTitles\": [\n        \"Any business unit\",\n        \"Express Permit (no plan check)\",\n        \"Plan Check at Counter\",\n        \"Regular Plan Check\",\n        \"Expanded Counter Plan Check\",\n        \"Appointment Plan Check\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"zipCodes\": {\n      \"title\": \"Zip codes\",\n      \"type\": \"array\",\n      \"description\": \"Restrict results to one or more 5-digit LA zip codes. Example: 90047.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"issueDateFrom\": {\n      \"title\": \"Issue date from (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop permits issued before this date. The actor automatically reads the matching era dataset (2020+, 2010-2019, pre-2010).\",\n      \"editor\": \"textfield\"\n    },\n    \"issueDateTo\": {\n      \"title\": \"Issue date to (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop permits issued after this date.\",\n      \"editor\": \"textfield\"\n    },\n    \"submittedDateFrom\": {\n      \"title\": \"Submitted date from (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop applications submitted before this date. Select dataset=submittedBuilding (or a submitted trade dataset) to include applications before issuance.\",\n      \"editor\": \"textfield\"\n    },\n    \"submittedDateTo\": {\n      \"title\": \"Submitted date to (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop applications submitted after this date.\",\n      \"editor\": \"textfield\"\n    },\n    \"statusDateFrom\": {\n      \"title\": \"Status date from (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop permits whose latest status change is before this date.\",\n      \"editor\": \"textfield\"\n    },\n    \"statusDateTo\": {\n      \"title\": \"Status date to (YYYY-MM-DD)\",\n      \"type\": \"string\",\n      \"description\": \"Drop permits whose latest status change is after this date.\",\n      \"editor\": \"textfield\"\n    },\n    \"minValuation\": {\n      \"title\": \"Min valuation (USD)\",\n      \"type\": \"number\",\n      \"description\": \"Drop permits with a lower applicant-declared construction valuation. The figure is declared on the application, not a contract price.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 1000000000\n    },\n    \"maxValuation\": {\n      \"title\": \"Max valuation (USD)\",\n      \"type\": \"number\",\n      \"description\": \"Drop permits with a higher applicant-declared construction valuation.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 1000000000\n    },\n    \"minSquareFootage\": {\n      \"title\": \"Min square footage\",\n      \"type\": \"number\",\n      \"description\": \"Drop permits with a lower published square footage. Permits without a published figure are excluded when this is set.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"maxSquareFootage\": {\n      \"title\": \"Max square footage\",\n      \"type\": \"number\",\n      \"description\": \"Drop permits with a higher published square footage.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"minStories\": {\n      \"title\": \"Min number of stories\",\n      \"type\": \"integer\",\n      \"description\": \"Drop permits with fewer stories. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 200\n    },\n    \"maxStories\": {\n      \"title\": \"Max number of stories\",\n      \"type\": \"integer\",\n      \"description\": \"Drop permits with more stories. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 200\n    },\n    \"minResidentialUnits\": {\n      \"title\": \"Min residential dwelling units\",\n      \"type\": \"integer\",\n      \"description\": \"Drop permits with fewer residential dwelling units. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 10000\n    },\n    \"councilDistrict\": {\n      \"title\": \"Council district\",\n      \"type\": \"integer\",\n      \"description\": \"Filter to one Los Angeles city council district (1-15). Available on live permit feeds only, not on the CoO/legacy detailed datasets.\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 15\n    },\n    \"communityPlanArea\": {\n      \"title\": \"Community plan area contains\",\n      \"type\": \"string\",\n      \"description\": \"Case-insensitive substring match on the LADBS community plan area. Example: Venice. Available on live permit feeds only, not on the CoO/legacy detailed datasets.\",\n      \"editor\": \"textfield\"\n    },\n    \"neighborhoodCouncil\": {\n      \"title\": \"Neighborhood council contains\",\n      \"type\": \"string\",\n      \"description\": \"Case-insensitive substring match on the neighbourhood council name. Example: Encino. Available on live permit feeds only, not on the CoO/legacy detailed datasets.\",\n      \"editor\": \"textfield\"\n    },\n    \"aduOnly\": {\n      \"title\": \"ADU permits only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only permits that add at least one ADU or junior ADU. Available on live feeds.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"evChargingOnly\": {\n      \"title\": \"EV-charging permits only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only permits flagged by LADBS for electric-vehicle charging. Available on live feeds.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"solarOnly\": {\n      \"title\": \"Solar permits only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only permits flagged by LADBS as solar. Available on live feeds.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"nearLatitude\": {\n      \"title\": \"Near latitude (geo-radius search)\",\n      \"type\": \"number\",\n      \"description\": \"Latitude of a centre point. Combine with nearLongitude (and optionally radiusMeters) to return only permits within a radius. Example: 34.0522 (downtown LA).\",\n      \"editor\": \"number\",\n      \"sectionCaption\": \"Geo-radius search\",\n      \"minimum\": -90,\n      \"maximum\": 90\n    },\n    \"nearLongitude\": {\n      \"title\": \"Near longitude (geo-radius search)\",\n      \"type\": \"number\",\n      \"description\": \"Longitude of the centre point. Example: -118.2437 (downtown LA).\",\n      \"editor\": \"number\",\n      \"minimum\": -180,\n      \"maximum\": 180\n    },\n    \"radiusMeters\": {\n      \"title\": \"Radius (meters)\",\n      \"type\": \"number\",\n      \"description\": \"Search radius around the centre point. Only used when both coordinates are set.\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 50000,\n      \"default\": 500,\n      \"prefill\": 500\n    },\n    \"sortBy\": {\n      \"title\": \"Sort by\",\n      \"type\": \"string\",\n      \"description\": \"Order for live datasets. The stories / residential-unit options are kept for saved tasks and work on the Certificate of Occupancy and legacy detailed datasets; live feeds fall back to issue date with a status note.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"Output\",\n      \"enum\": [\n        \"issueDateDesc\",\n        \"issueDateAsc\",\n        \"statusDateDesc\",\n        \"statusDateAsc\",\n        \"submittedDateDesc\",\n        \"submittedDateAsc\",\n        \"cofoDateDesc\",\n        \"cofoDateAsc\",\n        \"valuationDesc\",\n        \"valuationAsc\",\n        \"squareFootageDesc\",\n        \"squareFootageAsc\",\n        \"storiesDesc\",\n        \"storiesAsc\",\n        \"residentialUnitsDesc\",\n        \"residentialUnitsAsc\"\n      ],\n      \"enumTitles\": [\n        \"Issue date (newest first)\",\n        \"Issue date (oldest first)\",\n        \"Status date (newest first)\",\n        \"Status date (oldest first)\",\n        \"Submitted date (newest first)\",\n        \"Submitted date (oldest first)\",\n        \"Certificate of Occupancy date (newest first)\",\n        \"Certificate of Occupancy date (oldest first)\",\n        \"Valuation (highest first)\",\n        \"Valuation (lowest first)\",\n        \"Square footage (largest first)\",\n        \"Square footage (smallest first)\",\n        \"Stories (highest first, CoO/legacy only)\",\n        \"Stories (lowest first, CoO/legacy only)\",\n        \"Residential units (highest first, CoO/legacy only)\",\n        \"Residential units (lowest first, CoO/legacy only)\"\n      ],\n      \"default\": \"issueDateDesc\",\n      \"prefill\": \"issueDateDesc\"\n    },\n    \"includeDetails\": {\n      \"title\": \"Include contractor / occupancy details\",\n      \"type\": \"boolean\",\n      \"description\": \"Batch-look up each live-feed permit in the Certificate of Occupancy and legacy detailed datasets to fill contractor, applicant, licence, occupancy, stories and residential-unit fields where LADBS publishes them. Adds a few requests per 100 permits. Detail-dataset records are always refreshed with current live status regardless of this setting.\",\n      \"editor\": \"checkbox\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"includeInspections\": {\n      \"title\": \"Include inspection summaries\",\n      \"type\": \"boolean\",\n      \"description\": \"Batch-look up the LADBS inspections dataset and add inspectionCount, first/last inspection date, and last inspection type/result. Only populated where inspections exist.\",\n      \"editor\": \"checkbox\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"default\": 50,\n      \"prefill\": 3\n    },\n    \"appToken\": {\n      \"title\": \"Socrata app token (optional)\",\n      \"type\": \"string\",\n      \"description\": \"Optional free Socrata app token to raise API rate limits. Not required.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Advanced\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# LA Building Permit Records & Contractor Lookup\r\n\r\nPull Los Angeles building records directly from the Department of Building & Safety's public open data. Every run reads the live Socrata API, so a permit issued last week is in the dataset — not a copy frozen years ago. Search the whole city, follow a single address or contractor, or pull a parcel's permit history. No account, API key, cookie or proxy is required.\r\n\r\n## Why this actor\r\n\r\nLADBS publishes its permits as a family of datasets, not one file: building, electrical and mechanical permits, each split into issued and submitted applications and into three date eras (pre-2010, 2010–2019, 2020 to today), plus Certificates of Occupancy and an older detailed dataset. This actor hides that split:\r\n\r\n- **Live data** — issued building permits through the latest published day (2026-11-14 at the time of the revamp), not the legacy feed that stopped in May 2023.\r\n- **Eight record families** — issued/submitted building, issued/submitted electrical, issued/submitted mechanical, Certificate of Occupancy, and the legacy 2015–2023 detailed dataset.\r\n- **Full history** — the pre-2010 and 2010–2019 datasets are queried automatically when you ask for older dates.\r\n- **Five ways in** — keyword/filter search, exact permit numbers, an address, a contractor business name, or an assessor Book-Page-Parcel.\r\n- **Contractor details where LADBS publishes them** — the live feed has no names, so the actor batch-enriches each permit from the Certificate of Occupancy plus two frozen detailed files (a 2015–2023 building-only file and a 2013–2023 all-trades file), filling contractor, applicant, licence, occupancy, stories and residential-unit fields when a matching row exists.\r\n- **Modern LADBS fields** — use code/description, council district, APN/PIN, community plan area, neighbourhood council, square footage, construction type, height, ADU/junior-ADU/dwelling-unit change, EV and solar flags, issuing business unit, and certificate-of-occupancy dates.\r\n- **Optional inspection summaries** — inspection count and last inspection date/type/result from the LADBS inspections dataset.\r\n- **Empty values are omitted** — no `null`, no placeholders.\r\n\r\n## Modes\r\n\r\n| Mode | What it does | Required input |\r\n|---|---|---|\r\n| `search` | Filter the selected dataset and return matching permits | none |\r\n| `byPermitNumbers` | Resolve exact PCIS permit numbers, searching every LADBS dataset family | `permitNumbers` |\r\n| `byAddress` | Find permits at a street address (or anywhere on a street) | `streetName` |\r\n| `byContractor` | Pull a contractor's permit history (CoO + legacy detailed datasets, including the 2013–2023 all-trades file, refreshed with live status) | `contractorName` |\r\n| `byAssessorParcel` | Find permits for an LA County assessor Book-Page-Parcel / AIN | `assessorBook`, `assessorPage`, `assessorParcel` |\r\n\r\n## Datasets\r\n\r\n| `dataset` value | Rows at revamp | What it contains |\r\n|---|---|---|\r\n| `issuedBuilding` (default) | 1.60 M across three eras | Building permits LADBS has issued, 1988 → today |\r\n| `submittedBuilding` | 1.08 M across three eras | Building permit applications, including ones not yet issued |\r\n| `issuedElectrical` | 1.12 M across three eras | Electrical permits issued, 1988 → today |\r\n| `submittedElectrical` | 197 K across three eras | Electrical permit applications |\r\n| `issuedMechanical` | 1.39 M across three eras | Plumbing, HVAC, fire-sprinkler, elevator and pressure-vessel permits issued |\r\n| `submittedMechanical` | 211 K across three eras | Mechanical permit applications |\r\n| `certificateOfOccupancy` | 146 K | Certificates of Occupancy, 2005 → today, with contractor/applicant details |\r\n| `legacyDetailed` | 375 K | The old detailed permit dataset, frozen 2015-11-03 → 2023-05-19 |\r\n\r\nThe actor also reads `hbkd-qubn` (LADBS-Permits, 1.6 M rows, 2013-01-01 → 2023-05-19, all trades) as an identity-enrichment source and for `byContractor` lookups. It is not a selectable dataset; it fills contractor/applicant fields on older records where the richer CoO/legacy rows are missing.\r\n\r\nWhen `dataset` is left at its default and you choose an electrical or mechanical permit type, the matching trade dataset is selected automatically and reported in the run status. To search applications before issuance, choose one of the `submitted*` datasets explicitly.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `search` | `search`, `byPermitNumbers`, `byAddress`, `byContractor` or `byAssessorParcel` |\r\n| `dataset` | string | `issuedBuilding` | One of the eight datasets listed above |\r\n| `permitNumbers` | array | – | Exact PCIS permit numbers; hyphens or spaces both work |\r\n| `streetNumber` | string | – | Street number for `byAddress`; optional |\r\n| `streetName` | string | – | Street name; exact street match in `byAddress`, substring filter in `search` |\r\n| `streetDirection` | string | Any | `N`, `S`, `E` or `W` |\r\n| `streetSuffix` | string | Any | `AVE`, `ST`, `BLVD`, `DR`, `PL`, `RD`, `WAY`, … |\r\n| `assessorBook` | string | – | Assessor book component (4 digits) |\r\n| `assessorPage` | string | – | Assessor page component (3 digits) |\r\n| `assessorParcel` | string | – | Assessor parcel component (3 digits) |\r\n| `contractorName` | string | – | Exact business name in `byContractor` (CoO + legacy detailed datasets, including the 2013–2023 all-trades file); substring filter in `search` (CoO + 2015–2023 legacy detailed) |\r\n| `workDescriptionKeyword` | string | – | Substring match on the work description |\r\n| `useDescriptionKeyword` | string | – | Substring match on the use description (`Accessory Dwelling Unit`, `Office`, `Retail`, …) |\r\n| `permitType` | string | Any | `Bldg-New`, `Bldg-Addition`, `Bldg-Alter/Repair`, `Bldg-Demolition`, `Bldg-Relocation`, `Nonbldg-*`, `Grading`, `Swimming-Pool/Spa`, `Sign`, `Electrical`, `Plumbing`, `HVAC`, `Fire Sprinkler`, `Elevator`, `Pressure Vessel` |\r\n| `permitSubType` | string | Any | `1 or 2 Family Dwelling`, `Apartment`, `Commercial`, `Onsite`, `Offsite`, `Public Safety Only`, `Special Equipment` |\r\n| `permitCategory` | string | Any | `Plan Check` or `No Plan Check` |\r\n| `status` | string | Any | Current status (`Issued`, `Permit Finaled`, `CofO Issued`, `PC Approved`, …) |\r\n| `initiatingOffice` | string | Any | LADBS district office (CoO/legacy only; the actor switches to those) |\r\n| `occupancy` | string | Any | Building-code occupancy group (CoO/legacy only) |\r\n| `constructionType` | string | Any | `Type V-B Construction`, `Type III-A Construction`, … |\r\n| `businessUnit` | string | Any | `Express Permit`, `Plan Check at Counter`, `Regular Plan Check`, … |\r\n| `zipCodes` | array | – | One or more 5-digit ZIP codes |\r\n| `issueDateFrom` | string | – | `YYYY-MM-DD`; earlier permits are dropped |\r\n| `issueDateTo` | string | – | `YYYY-MM-DD`; later permits are dropped |\r\n| `submittedDateFrom` | string | – | `YYYY-MM-DD`; earlier applications are dropped |\r\n| `submittedDateTo` | string | – | `YYYY-MM-DD`; later applications are dropped |\r\n| `statusDateFrom` | string | – | `YYYY-MM-DD`; earlier status updates are dropped |\r\n| `statusDateTo` | string | – | `YYYY-MM-DD`; later status updates are dropped |\r\n| `minValuation` | number | – | Minimum applicant-declared construction valuation (USD) |\r\n| `maxValuation` | number | – | Maximum applicant-declared construction valuation (USD) |\r\n| `minSquareFootage` | number | – | Minimum published square footage |\r\n| `maxSquareFootage` | number | – | Maximum published square footage |\r\n| `minStories` | integer | – | Minimum stories (CoO/legacy only) |\r\n| `maxStories` | integer | – | Maximum stories (CoO/legacy only) |\r\n| `minResidentialUnits` | integer | – | Minimum residential dwelling units (CoO/legacy only) |\r\n| `councilDistrict` | integer | – | City council district, 1–15 (live permit feeds only) |\r\n| `communityPlanArea` | string | – | Substring match on the community plan area (live permit feeds only) |\r\n| `neighborhoodCouncil` | string | – | Substring match on the neighbourhood council (live permit feeds only) |\r\n| `aduOnly` | boolean | `false` | Keep only permits adding an ADU or junior ADU |\r\n| `evChargingOnly` | boolean | `false` | Keep only EV-charging permits |\r\n| `solarOnly` | boolean | `false` | Keep only solar permits |\r\n| `nearLatitude` | number | – | Centre latitude for a radius search |\r\n| `nearLongitude` | number | – | Centre longitude for a radius search |\r\n| `radiusMeters` | number | `500` | Radius in metres; used only with both coordinates |\r\n| `sortBy` | string | `issueDateDesc` | Issue/status/submitted/CoO date, valuation or square footage (live), or stories/residential units (CoO/legacy only) |\r\n| `includeDetails` | boolean | `true` | Enrich live-feed records from CoO + legacy detailed datasets: contractor, applicant, occupancy, stories, units. Detail-dataset records are always refreshed with current live status |\r\n| `includeInspections` | boolean | `false` | Add inspection count and last inspection date/type/result |\r\n| `maxItems` | integer | `50` | Hard cap on emitted records (1–10,000) |\r\n| `appToken` | string | – | Optional free Socrata app token to raise rate limits |\r\n\r\n### Example: newest issued building permits\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedBuilding\",\r\n  \"maxItems\": 25\r\n}\r\n```\r\n\r\n### Example: new-construction apartment or commercial permits over $1M\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedBuilding\",\r\n  \"permitType\": \"Bldg-New\",\r\n  \"permitSubType\": \"Apartment\",\r\n  \"minValuation\": 1000000,\r\n  \"issueDateFrom\": \"2026-01-01\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: ADU applications submitted in the last 90 days\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"submittedBuilding\",\r\n  \"aduOnly\": true,\r\n  \"submittedDateFrom\": \"2026-08-01\",\r\n  \"maxItems\": 200\r\n}\r\n```\r\n\r\n### Example: solar and EV electrical permits in one ZIP\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedElectrical\",\r\n  \"zipCodes\": [\"90047\"],\r\n  \"solarOnly\": true,\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: look up permit numbers\r\n\r\n```json\r\n{\r\n  \"mode\": \"byPermitNumbers\",\r\n  \"permitNumbers\": [\"24016-20000-19408\", \"23016-10000-03206\"]\r\n}\r\n```\r\n\r\n### Example: permits at a specific address\r\n\r\n```json\r\n{\r\n  \"mode\": \"byAddress\",\r\n  \"streetNumber\": \"6500\",\r\n  \"streetName\": \"SEABLUFF\"\r\n}\r\n```\r\n\r\n### Example: a contractor's permit history\r\n\r\n```json\r\n{\r\n  \"mode\": \"byContractor\",\r\n  \"contractorName\": \"OWNER-BUILDER\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: assessor parcel lookup (Book-Page-Parcel / AIN)\r\n\r\n```json\r\n{\r\n  \"mode\": \"byAssessorParcel\",\r\n  \"assessorBook\": \"2405\",\r\n  \"assessorPage\": \"003\",\r\n  \"assessorParcel\": \"032\"\r\n}\r\n```\r\n\r\n### Example: certificates of occupancy in a ZIP code\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"certificateOfOccupancy\",\r\n  \"zipCodes\": [\"91606\"],\r\n  \"issueDateFrom\": \"2026-01-01\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: permits within 500 m of downtown LA\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"nearLatitude\": 34.0522,\r\n  \"nearLongitude\": -118.2437,\r\n  \"radiusMeters\": 500,\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n## Output\r\n\r\nOne dataset item per permit. Field names are camelCase and stable; empty values are omitted rather than written as `null`.\r\n\r\n**Identity and type:** `permitNumber`, `permitGroup`, `permitType`, `permitSubType`, `permitCategory`, `useCode`, `useDescription`, `recordType`, `recordSource`, `sourceDataset`, `sourceDatasetName`, `documentationUrl`, `sourceUrl`, `rowId`, `scrapedAt`, `refreshTime`.\r\n\r\n**Status and dates:** `status`, `statusDate`, `submittedDate`, `issueDate`, `cofoDate`, `cofoNumber`, `cofoIssueDate`.\r\n\r\n**Location:** `fullAddress`, `addressStart`, `addressEnd`, `streetDirection`, `streetName`, `streetSuffix`, `unitRangeStart`, `unitRangeEnd`, `city`, `state`, `zipCode`, `councilDistrict`, `communityPlanArea`, `areaPlanningCommission`, `neighborhoodCouncil`, `censusTract`, `zone`, `latitude`, `longitude`, `geocodeType`.\r\n\r\n**Parcel:** `apn`, `assessorBook`, `assessorPage`, `assessorParcel`, `pinNumber`, `tract`, `block`, `lot`.\r\n\r\n**Project:** `workDescription`, `valuation`, `squareFootage`, `constructionType`, `buildingHeight`, `businessUnit`, `aduChanged`, `juniorAduChanged`, `dwellingUnitsChanged`, `evCharging`, `solar`.\r\n\r\n**Contractor / people (when LADBS publishes them):** `contractorBusinessName`, `contractorAddress`, `contractorCity`, `contractorState`, `licenseType`, `licenseNumber`, `licenseExpirationDate`, `principalFirstName`, `principalMiddleName`, `principalLastName`, `applicantFirstName`, `applicantLastName`, `applicantBusinessName`, `applicantAddress1`, `applicantAddress2`, `applicantAddress3`, `occupancy`, `numberOfStories`, `residentialDwellingUnits`, `floorAreaZoningCode`, `floorAreaBuildingCode`, `initiatingOffice`, `referenceOldPermit`, `projectNumber`, `eventCode`, `detailSource`, `detailSourceUrl`, `currentSource`.\r\n\r\n**Optional inspections (`includeInspections=true`):** `inspectionCount`, `firstInspectionDate`, `lastInspectionDate`, `lastInspectionType`, `lastInspectionResult`.\r\n\r\n## Freshness and coverage\r\n\r\n- **Live feeds** are refreshed by LADBS roughly daily; the newest row seen during the revamp was 2026-11-14. The city usually publishes a day's permits a few days later, so a one-day window can be empty.\r\n- **History** is split by era and queried automatically: 1988–2009, 2010–2019, 2020 → today.\r\n- **Submitted applications** are the earliest signal — they exist before a permit is issued.\r\n- **Contractor identity** is not in the live feed. The actor reads the Certificate of Occupancy dataset (146 K rows, 2005 → today), the legacy detailed dataset (2015–2023, building only) and the all-trades legacy file (2013–2023) to fill it. That covers most older permits but only a minority of 2024+ permits; see the FAQ.\r\n- **Detail-dataset freshness** — CoO, legacy and all-trades records are always refreshed against the matching live feed (building, electrical or mechanical) so their status and dates are current; `includeDetails` controls identity enrichment on live-feed records, not this refresh.\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with the City of Los Angeles?**\r\nNo. It is a third-party reader of the City's public open data.\r\n\r\n**Why do some records lack a contractor?**\r\nLADBS stopped publishing contractor/owner/applicant names in the current permit feed. The names remain in the Certificate of Occupancy file, a frozen 2015–2023 building-only detailed file, and a frozen 2013–2023 all-trades file. The actor fills them when a matching row exists and omits the fields otherwise. For 2024+ permits only the CoO file can help: roughly 15 % of sampled 2024 permits, 4.5 % of 2025 permits and 0 % of 2026 permits had a CoO row at revamp time.\r\n\r\n**Can I get owner names?**\r\nNo. LADBS does not publish owner names in any of these public datasets.\r\n\r\n**What does \"submitted\" mean?**\r\nA permit application filed with LADBS. It may later be issued, corrected or withdrawn. The same permit number can appear in both a submitted and an issued dataset; use `issueDateFrom` if you only want issued work.\r\n\r\n**Is the valuation the project cost?**\r\nNo. It is the figure the applicant declares on the permit. It is useful for ranking leads but is not an appraisal or a contract price.\r\n\r\n**Why are some fields missing on some permits?**\r\nLADBS only publishes a field when the permit type has it. Square footage, height, construction type, ADU/EV/solar flags and geolocation are populated on a minority of records. Empty fields are omitted, never filled with a guess.\r\n\r\n**How fresh is the data?**\r\nEach run queries the live API. LADBS refreshes the feeds about daily and usually publishes a day's permits a few days later.\r\n\r\n**Can I search a neighbourhood or ZIP?**\r\nYes. `zipCodes`, street and keyword filters work on every dataset. `communityPlanArea`, `neighborhoodCouncil`, `councilDistrict` and the ADU/EV/solar flags are published only on the live permit feeds, so they are not available when `dataset` is `certificateOfOccupancy` or `legacyDetailed`.\r\n\r\n**Are there rate limits?**\r\nThe public API allows a reasonable number of requests without a token. Large enriched runs make one request per 100 permits for CoO/legacy lookups; a free Socrata `appToken` raises the limit if you run big jobs often.\r\n\r\n**Does this cover LA County, Santa Monica or Pasadena?**\r\nNo. It covers permits issued by the City of Los Angeles Department of Building & Safety only.\r\n\r\n**Can I get every permit for a contractor?**\r\nYes, within the limits of the CoO/legacy datasets (including the 2013–2023 all-trades file). Contractor names are not in the live feed, so a contractor lookup cannot see a 2024+ permit unless LADBS also published it in the CoO file.\r\n\r\n**Does sorting by stories or residential units work?**\r\nYes on the Certificate of Occupancy and legacy datasets. The current live feed no longer carries those columns, so those two sort values fall back to issue date on live feeds and report the fallback in the run status. They remain in the input schema so saved tasks keep validating.\r\n\r\n**Does it include inspections?**\r\nOnly when `includeInspections` is enabled. The inspections dataset is large and most new permits have not been inspected yet, so it is off by default.\r\n\r\n**Is a proxy or cookie required?**\r\nNo. The actor reads public JSON APIs with plain HTTP.\r\n\r\n## Data source and attribution\r\n\r\nData: City of Los Angeles Open Data (data.lacity.org), published by the Los Angeles Department of Building & Safety. Datasets include the Building/Electrical/Mechanical permits issued and submitted families, the Certificate of Occupancy file, the legacy LA BUILD PERMITS file, and the Building and Safety Inspections file. Use is subject to the portal's terms of use. Each record carries `sourceDataset`, `documentationUrl` and a `sourceUrl` that resolves the exact row.\r\n\r\nThis actor is not affiliated with or endorsed by the City of Los Angeles.\r\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "la-building-permit-records-and-contractor-lookup",
      "title": "LA Building Permit Records & Contractor Lookup",
      "description": "Search live LA (LADBS) building, electrical and mechanical permits, certificates of occupancy and legacy records by permit number, address, contractor or parcel. Filter by type, status, ZIP, valuation, dates, ADU/EV/solar.",
      "version": "2.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# LA Building Permit Records & Contractor Lookup\r\n\r\nPull Los Angeles building records directly from the Department of Building & Safety's public open data. Every run reads the live Socrata API, so a permit issued last week is in the dataset — not a copy frozen years ago. Search the whole city, follow a single address or contractor, or pull a parcel's permit history. No account, API key, cookie or proxy is required.\r\n\r\n## Why this actor\r\n\r\nLADBS publishes its permits as a family of datasets, not one file: building, electrical and mechanical permits, each split into issued and submitted applications and into three date eras (pre-2010, 2010–2019, 2020 to today), plus Certificates of Occupancy and an older detailed dataset. This actor hides that split:\r\n\r\n- **Live data** — issued building permits through the latest published day (2026-11-14 at the time of the revamp), not the legacy feed that stopped in May 2023.\r\n- **Eight record families** — issued/submitted building, issued/submitted electrical, issued/submitted mechanical, Certificate of Occupancy, and the legacy 2015–2023 detailed dataset.\r\n- **Full history** — the pre-2010 and 2010–2019 datasets are queried automatically when you ask for older dates.\r\n- **Five ways in** — keyword/filter search, exact permit numbers, an address, a contractor business name, or an assessor Book-Page-Parcel.\r\n- **Contractor details where LADBS publishes them** — the live feed has no names, so the actor batch-enriches each permit from the Certificate of Occupancy plus two frozen detailed files (a 2015–2023 building-only file and a 2013–2023 all-trades file), filling contractor, applicant, licence, occupancy, stories and residential-unit fields when a matching row exists.\r\n- **Modern LADBS fields** — use code/description, council district, APN/PIN, community plan area, neighbourhood council, square footage, construction type, height, ADU/junior-ADU/dwelling-unit change, EV and solar flags, issuing business unit, and certificate-of-occupancy dates.\r\n- **Optional inspection summaries** — inspection count and last inspection date/type/result from the LADBS inspections dataset.\r\n- **Empty values are omitted** — no `null`, no placeholders.\r\n\r\n## Modes\r\n\r\n| Mode | What it does | Required input |\r\n|---|---|---|\r\n| `search` | Filter the selected dataset and return matching permits | none |\r\n| `byPermitNumbers` | Resolve exact PCIS permit numbers, searching every LADBS dataset family | `permitNumbers` |\r\n| `byAddress` | Find permits at a street address (or anywhere on a street) | `streetName` |\r\n| `byContractor` | Pull a contractor's permit history (CoO + legacy detailed datasets, including the 2013–2023 all-trades file, refreshed with live status) | `contractorName` |\r\n| `byAssessorParcel` | Find permits for an LA County assessor Book-Page-Parcel / AIN | `assessorBook`, `assessorPage`, `assessorParcel` |\r\n\r\n## Datasets\r\n\r\n| `dataset` value | Rows at revamp | What it contains |\r\n|---|---|---|\r\n| `issuedBuilding` (default) | 1.60 M across three eras | Building permits LADBS has issued, 1988 → today |\r\n| `submittedBuilding` | 1.08 M across three eras | Building permit applications, including ones not yet issued |\r\n| `issuedElectrical` | 1.12 M across three eras | Electrical permits issued, 1988 → today |\r\n| `submittedElectrical` | 197 K across three eras | Electrical permit applications |\r\n| `issuedMechanical` | 1.39 M across three eras | Plumbing, HVAC, fire-sprinkler, elevator and pressure-vessel permits issued |\r\n| `submittedMechanical` | 211 K across three eras | Mechanical permit applications |\r\n| `certificateOfOccupancy` | 146 K | Certificates of Occupancy, 2005 → today, with contractor/applicant details |\r\n| `legacyDetailed` | 375 K | The old detailed permit dataset, frozen 2015-11-03 → 2023-05-19 |\r\n\r\nThe actor also reads `hbkd-qubn` (LADBS-Permits, 1.6 M rows, 2013-01-01 → 2023-05-19, all trades) as an identity-enrichment source and for `byContractor` lookups. It is not a selectable dataset; it fills contractor/applicant fields on older records where the richer CoO/legacy rows are missing.\r\n\r\nWhen `dataset` is left at its default and you choose an electrical or mechanical permit type, the matching trade dataset is selected automatically and reported in the run status. To search applications before issuance, choose one of the `submitted*` datasets explicitly.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `search` | `search`, `byPermitNumbers`, `byAddress`, `byContractor` or `byAssessorParcel` |\r\n| `dataset` | string | `issuedBuilding` | One of the eight datasets listed above |\r\n| `permitNumbers` | array | – | Exact PCIS permit numbers; hyphens or spaces both work |\r\n| `streetNumber` | string | – | Street number for `byAddress`; optional |\r\n| `streetName` | string | – | Street name; exact street match in `byAddress`, substring filter in `search` |\r\n| `streetDirection` | string | Any | `N`, `S`, `E` or `W` |\r\n| `streetSuffix` | string | Any | `AVE`, `ST`, `BLVD`, `DR`, `PL`, `RD`, `WAY`, … |\r\n| `assessorBook` | string | – | Assessor book component (4 digits) |\r\n| `assessorPage` | string | – | Assessor page component (3 digits) |\r\n| `assessorParcel` | string | – | Assessor parcel component (3 digits) |\r\n| `contractorName` | string | – | Exact business name in `byContractor` (CoO + legacy detailed datasets, including the 2013–2023 all-trades file); substring filter in `search` (CoO + 2015–2023 legacy detailed) |\r\n| `workDescriptionKeyword` | string | – | Substring match on the work description |\r\n| `useDescriptionKeyword` | string | – | Substring match on the use description (`Accessory Dwelling Unit`, `Office`, `Retail`, …) |\r\n| `permitType` | string | Any | `Bldg-New`, `Bldg-Addition`, `Bldg-Alter/Repair`, `Bldg-Demolition`, `Bldg-Relocation`, `Nonbldg-*`, `Grading`, `Swimming-Pool/Spa`, `Sign`, `Electrical`, `Plumbing`, `HVAC`, `Fire Sprinkler`, `Elevator`, `Pressure Vessel` |\r\n| `permitSubType` | string | Any | `1 or 2 Family Dwelling`, `Apartment`, `Commercial`, `Onsite`, `Offsite`, `Public Safety Only`, `Special Equipment` |\r\n| `permitCategory` | string | Any | `Plan Check` or `No Plan Check` |\r\n| `status` | string | Any | Current status (`Issued`, `Permit Finaled`, `CofO Issued`, `PC Approved`, …) |\r\n| `initiatingOffice` | string | Any | LADBS district office (CoO/legacy only; the actor switches to those) |\r\n| `occupancy` | string | Any | Building-code occupancy group (CoO/legacy only) |\r\n| `constructionType` | string | Any | `Type V-B Construction`, `Type III-A Construction`, … |\r\n| `businessUnit` | string | Any | `Express Permit`, `Plan Check at Counter`, `Regular Plan Check`, … |\r\n| `zipCodes` | array | – | One or more 5-digit ZIP codes |\r\n| `issueDateFrom` | string | – | `YYYY-MM-DD`; earlier permits are dropped |\r\n| `issueDateTo` | string | – | `YYYY-MM-DD`; later permits are dropped |\r\n| `submittedDateFrom` | string | – | `YYYY-MM-DD`; earlier applications are dropped |\r\n| `submittedDateTo` | string | – | `YYYY-MM-DD`; later applications are dropped |\r\n| `statusDateFrom` | string | – | `YYYY-MM-DD`; earlier status updates are dropped |\r\n| `statusDateTo` | string | – | `YYYY-MM-DD`; later status updates are dropped |\r\n| `minValuation` | number | – | Minimum applicant-declared construction valuation (USD) |\r\n| `maxValuation` | number | – | Maximum applicant-declared construction valuation (USD) |\r\n| `minSquareFootage` | number | – | Minimum published square footage |\r\n| `maxSquareFootage` | number | – | Maximum published square footage |\r\n| `minStories` | integer | – | Minimum stories (CoO/legacy only) |\r\n| `maxStories` | integer | – | Maximum stories (CoO/legacy only) |\r\n| `minResidentialUnits` | integer | – | Minimum residential dwelling units (CoO/legacy only) |\r\n| `councilDistrict` | integer | – | City council district, 1–15 (live permit feeds only) |\r\n| `communityPlanArea` | string | – | Substring match on the community plan area (live permit feeds only) |\r\n| `neighborhoodCouncil` | string | – | Substring match on the neighbourhood council (live permit feeds only) |\r\n| `aduOnly` | boolean | `false` | Keep only permits adding an ADU or junior ADU |\r\n| `evChargingOnly` | boolean | `false` | Keep only EV-charging permits |\r\n| `solarOnly` | boolean | `false` | Keep only solar permits |\r\n| `nearLatitude` | number | – | Centre latitude for a radius search |\r\n| `nearLongitude` | number | – | Centre longitude for a radius search |\r\n| `radiusMeters` | number | `500` | Radius in metres; used only with both coordinates |\r\n| `sortBy` | string | `issueDateDesc` | Issue/status/submitted/CoO date, valuation or square footage (live), or stories/residential units (CoO/legacy only) |\r\n| `includeDetails` | boolean | `true` | Enrich live-feed records from CoO + legacy detailed datasets: contractor, applicant, occupancy, stories, units. Detail-dataset records are always refreshed with current live status |\r\n| `includeInspections` | boolean | `false` | Add inspection count and last inspection date/type/result |\r\n| `maxItems` | integer | `50` | Hard cap on emitted records (1–10,000) |\r\n| `appToken` | string | – | Optional free Socrata app token to raise rate limits |\r\n\r\n### Example: newest issued building permits\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedBuilding\",\r\n  \"maxItems\": 25\r\n}\r\n```\r\n\r\n### Example: new-construction apartment or commercial permits over $1M\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedBuilding\",\r\n  \"permitType\": \"Bldg-New\",\r\n  \"permitSubType\": \"Apartment\",\r\n  \"minValuation\": 1000000,\r\n  \"issueDateFrom\": \"2026-01-01\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: ADU applications submitted in the last 90 days\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"submittedBuilding\",\r\n  \"aduOnly\": true,\r\n  \"submittedDateFrom\": \"2026-08-01\",\r\n  \"maxItems\": 200\r\n}\r\n```\r\n\r\n### Example: solar and EV electrical permits in one ZIP\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"issuedElectrical\",\r\n  \"zipCodes\": [\"90047\"],\r\n  \"solarOnly\": true,\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: look up permit numbers\r\n\r\n```json\r\n{\r\n  \"mode\": \"byPermitNumbers\",\r\n  \"permitNumbers\": [\"24016-20000-19408\", \"23016-10000-03206\"]\r\n}\r\n```\r\n\r\n### Example: permits at a specific address\r\n\r\n```json\r\n{\r\n  \"mode\": \"byAddress\",\r\n  \"streetNumber\": \"6500\",\r\n  \"streetName\": \"SEABLUFF\"\r\n}\r\n```\r\n\r\n### Example: a contractor's permit history\r\n\r\n```json\r\n{\r\n  \"mode\": \"byContractor\",\r\n  \"contractorName\": \"OWNER-BUILDER\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Example: assessor parcel lookup (Book-Page-Parcel / AIN)\r\n\r\n```json\r\n{\r\n  \"mode\": \"byAssessorParcel\",\r\n  \"assessorBook\": \"2405\",\r\n  \"assessorPage\": \"003\",\r\n  \"assessorParcel\": \"032\"\r\n}\r\n```\r\n\r\n### Example: certificates of occupancy in a ZIP code\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"dataset\": \"certificateOfOccupancy\",\r\n  \"zipCodes\": [\"91606\"],\r\n  \"issueDateFrom\": \"2026-01-01\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: permits within 500 m of downtown LA\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"nearLatitude\": 34.0522,\r\n  \"nearLongitude\": -118.2437,\r\n  \"radiusMeters\": 500,\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n## Output\r\n\r\nOne dataset item per permit. Field names are camelCase and stable; empty values are omitted rather than written as `null`.\r\n\r\n**Identity and type:** `permitNumber`, `permitGroup`, `permitType`, `permitSubType`, `permitCategory`, `useCode`, `useDescription`, `recordType`, `recordSource`, `sourceDataset`, `sourceDatasetName`, `documentationUrl`, `sourceUrl`, `rowId`, `scrapedAt`, `refreshTime`.\r\n\r\n**Status and dates:** `status`, `statusDate`, `submittedDate`, `issueDate`, `cofoDate`, `cofoNumber`, `cofoIssueDate`.\r\n\r\n**Location:** `fullAddress`, `addressStart`, `addressEnd`, `streetDirection`, `streetName`, `streetSuffix`, `unitRangeStart`, `unitRangeEnd`, `city`, `state`, `zipCode`, `councilDistrict`, `communityPlanArea`, `areaPlanningCommission`, `neighborhoodCouncil`, `censusTract`, `zone`, `latitude`, `longitude`, `geocodeType`.\r\n\r\n**Parcel:** `apn`, `assessorBook`, `assessorPage`, `assessorParcel`, `pinNumber`, `tract`, `block`, `lot`.\r\n\r\n**Project:** `workDescription`, `valuation`, `squareFootage`, `constructionType`, `buildingHeight`, `businessUnit`, `aduChanged`, `juniorAduChanged`, `dwellingUnitsChanged`, `evCharging`, `solar`.\r\n\r\n**Contractor / people (when LADBS publishes them):** `contractorBusinessName`, `contractorAddress`, `contractorCity`, `contractorState`, `licenseType`, `licenseNumber`, `licenseExpirationDate`, `principalFirstName`, `principalMiddleName`, `principalLastName`, `applicantFirstName`, `applicantLastName`, `applicantBusinessName`, `applicantAddress1`, `applicantAddress2`, `applicantAddress3`, `occupancy`, `numberOfStories`, `residentialDwellingUnits`, `floorAreaZoningCode`, `floorAreaBuildingCode`, `initiatingOffice`, `referenceOldPermit`, `projectNumber`, `eventCode`, `detailSource`, `detailSourceUrl`, `currentSource`.\r\n\r\n**Optional inspections (`includeInspections=true`):** `inspectionCount`, `firstInspectionDate`, `lastInspectionDate`, `lastInspectionType`, `lastInspectionResult`.\r\n\r\n## Freshness and coverage\r\n\r\n- **Live feeds** are refreshed by LADBS roughly daily; the newest row seen during the revamp was 2026-11-14. The city usually publishes a day's permits a few days later, so a one-day window can be empty.\r\n- **History** is split by era and queried automatically: 1988–2009, 2010–2019, 2020 → today.\r\n- **Submitted applications** are the earliest signal — they exist before a permit is issued.\r\n- **Contractor identity** is not in the live feed. The actor reads the Certificate of Occupancy dataset (146 K rows, 2005 → today), the legacy detailed dataset (2015–2023, building only) and the all-trades legacy file (2013–2023) to fill it. That covers most older permits but only a minority of 2024+ permits; see the FAQ.\r\n- **Detail-dataset freshness** — CoO, legacy and all-trades records are always refreshed against the matching live feed (building, electrical or mechanical) so their status and dates are current; `includeDetails` controls identity enrichment on live-feed records, not this refresh.\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with the City of Los Angeles?**\r\nNo. It is a third-party reader of the City's public open data.\r\n\r\n**Why do some records lack a contractor?**\r\nLADBS stopped publishing contractor/owner/applicant names in the current permit feed. The names remain in the Certificate of Occupancy file, a frozen 2015–2023 building-only detailed file, and a frozen 2013–2023 all-trades file. The actor fills them when a matching row exists and omits the fields otherwise. For 2024+ permits only the CoO file can help: roughly 15 % of sampled 2024 permits, 4.5 % of 2025 permits and 0 % of 2026 permits had a CoO row at revamp time.\r\n\r\n**Can I get owner names?**\r\nNo. LADBS does not publish owner names in any of these public datasets.\r\n\r\n**What does \"submitted\" mean?**\r\nA permit application filed with LADBS. It may later be issued, corrected or withdrawn. The same permit number can appear in both a submitted and an issued dataset; use `issueDateFrom` if you only want issued work.\r\n\r\n**Is the valuation the project cost?**\r\nNo. It is the figure the applicant declares on the permit. It is useful for ranking leads but is not an appraisal or a contract price.\r\n\r\n**Why are some fields missing on some permits?**\r\nLADBS only publishes a field when the permit type has it. Square footage, height, construction type, ADU/EV/solar flags and geolocation are populated on a minority of records. Empty fields are omitted, never filled with a guess.\r\n\r\n**How fresh is the data?**\r\nEach run queries the live API. LADBS refreshes the feeds about daily and usually publishes a day's permits a few days later.\r\n\r\n**Can I search a neighbourhood or ZIP?**\r\nYes. `zipCodes`, street and keyword filters work on every dataset. `communityPlanArea`, `neighborhoodCouncil`, `councilDistrict` and the ADU/EV/solar flags are published only on the live permit feeds, so they are not available when `dataset` is `certificateOfOccupancy` or `legacyDetailed`.\r\n\r\n**Are there rate limits?**\r\nThe public API allows a reasonable number of requests without a token. Large enriched runs make one request per 100 permits for CoO/legacy lookups; a free Socrata `appToken` raises the limit if you run big jobs often.\r\n\r\n**Does this cover LA County, Santa Monica or Pasadena?**\r\nNo. It covers permits issued by the City of Los Angeles Department of Building & Safety only.\r\n\r\n**Can I get every permit for a contractor?**\r\nYes, within the limits of the CoO/legacy datasets (including the 2013–2023 all-trades file). Contractor names are not in the live feed, so a contractor lookup cannot see a 2024+ permit unless LADBS also published it in the CoO file.\r\n\r\n**Does sorting by stories or residential units work?**\r\nYes on the Certificate of Occupancy and legacy datasets. The current live feed no longer carries those columns, so those two sort values fall back to issue date on live feeds and report the fallback in the run status. They remain in the input schema so saved tasks keep validating.\r\n\r\n**Does it include inspections?**\r\nOnly when `includeInspections` is enabled. The inspections dataset is large and most new permits have not been inspected yet, so it is off by default.\r\n\r\n**Is a proxy or cookie required?**\r\nNo. The actor reads public JSON APIs with plain HTTP.\r\n\r\n## Data source and attribution\r\n\r\nData: City of Los Angeles Open Data (data.lacity.org), published by the Los Angeles Department of Building & Safety. Datasets include the Building/Electrical/Mechanical permits issued and submitted families, the Certificate of Occupancy file, the legacy LA BUILD PERMITS file, and the Building and Safety Inspections file. Use is subject to the portal's terms of use. Each record carries `sourceDataset`, `documentationUrl` and a `sourceUrl` that resolves the exact row.\r\n\r\nThis actor is not affiliated with or endorsed by the City of Los Angeles.\r\n",
      "input": {
        "title": "Los Angeles Building Permits Scraper Input",
        "description": "Search live LADBS permit records (building, electrical, mechanical; issued or submitted), certificates of occupancy, or the legacy detailed dataset - or look up exact permits by number, address, contractor, or assessor parcel.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "How to find permits. Search applies filters and returns a list; the lookup modes resolve exact numbers, an address, a contractor, or an assessor parcel.",
            "editor": "select",
            "sectionCaption": "What to fetch",
            "enum": [
              "search",
              "byPermitNumbers",
              "byAddress",
              "byContractor",
              "byAssessorParcel"
            ],
            "enumTitles": [
              "Search / filter permits",
              "Look up by permit number(s)",
              "Look up by property address",
              "Look up by contractor name",
              "Look up by assessor parcel (Book-Page-Parcel)"
            ],
            "default": "search",
            "prefill": "search"
          },
          "dataset": {
            "title": "Dataset",
            "type": "string",
            "description": "Which LADBS record family to read. 'issuedBuilding' is the current live building-permit feed and the best default. 'submittedBuilding' returns applications before issuance (useful for early leads). Electrical and mechanical datasets carry trade permits. 'certificateOfOccupancy' returns completed/occupiable buildings with contractor details. 'legacyDetailed' is the frozen 2015-2023 detailed dataset.",
            "editor": "select",
            "enum": [
              "issuedBuilding",
              "submittedBuilding",
              "issuedElectrical",
              "submittedElectrical",
              "issuedMechanical",
              "submittedMechanical",
              "certificateOfOccupancy",
              "legacyDetailed"
            ],
            "enumTitles": [
              "Building permits - issued (current, recommended)",
              "Building permit applications - submitted",
              "Electrical permits - issued",
              "Electrical permit applications - submitted",
              "Mechanical permits - issued",
              "Mechanical permit applications - submitted",
              "Certificates of Occupancy",
              "Legacy detailed permits (2015-2023, frozen)"
            ],
            "default": "issuedBuilding",
            "prefill": "issuedBuilding"
          },
          "permitNumbers": {
            "title": "Permit numbers",
            "type": "array",
            "description": "Exact PCIS permit numbers for mode=byPermitNumbers. Paste one or many, with hyphens or spaces. Example: 24016-20000-19408.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "streetNumber": {
            "title": "Street number",
            "type": "string",
            "description": "Building street number for mode=byAddress. Optional: leave empty to return every permit on the street. Example: 6500.",
            "editor": "textfield",
            "sectionCaption": "Address lookup / street filters"
          },
          "streetName": {
            "title": "Street name",
            "type": "string",
            "description": "Street name without direction or suffix. Required for mode=byAddress (exact street match); in search mode it is a substring filter on the address. Example: HARVARD.",
            "editor": "textfield"
          },
          "streetDirection": {
            "title": "Street direction",
            "type": "string",
            "description": "Filter to a single street direction prefix. Applied server-side on detailed datasets and to the published address on live feeds.",
            "editor": "select",
            "enum": [
              "",
              "N",
              "S",
              "E",
              "W"
            ],
            "enumTitles": [
              "Any direction",
              "North",
              "South",
              "East",
              "West"
            ],
            "default": "",
            "prefill": ""
          },
          "streetSuffix": {
            "title": "Street suffix",
            "type": "string",
            "description": "Filter to a single street-suffix abbreviation. Applied server-side on detailed datasets and to the published address on live feeds.",
            "editor": "select",
            "enum": [
              "",
              "AVE",
              "ST",
              "BLVD",
              "DR",
              "PL",
              "RD",
              "WAY",
              "LN",
              "CT",
              "CIR",
              "TER",
              "TERR",
              "PKWY",
              "HWY",
              "TRL",
              "WALK",
              "CRK",
              "GLN",
              "PASS",
              "SQ",
              "VIS",
              "ALY",
              "PT",
              "ROW",
              "MALL",
              "PARK",
              "GRN",
              "RIDGE",
              "CYN",
              "HILL",
              "VIEW",
              "COVE",
              "PZ",
              "CL",
              "LOOP"
            ],
            "enumTitles": [
              "Any suffix",
              "Avenue",
              "Street",
              "Boulevard",
              "Drive",
              "Place",
              "Road",
              "Way",
              "Lane",
              "Court",
              "Circle",
              "Terrace",
              "Terrace (TERR)",
              "Parkway",
              "Highway",
              "Trail",
              "Walk",
              "Creek",
              "Glen",
              "Pass",
              "Square",
              "Vista",
              "Alley",
              "Point",
              "Row",
              "Mall",
              "Park",
              "Green",
              "Ridge",
              "Canyon",
              "Hill",
              "View",
              "Cove",
              "Plaza",
              "Circle (CL)",
              "Loop"
            ],
            "default": "",
            "prefill": ""
          },
          "assessorBook": {
            "title": "Assessor book",
            "type": "string",
            "description": "LA County Assessor Identification Number (AIN) book component, for mode=byAssessorParcel. All three components are required. Example: 2405.",
            "editor": "textfield",
            "sectionCaption": "Assessor parcel lookup"
          },
          "assessorPage": {
            "title": "Assessor page",
            "type": "string",
            "description": "AIN page component. Example: 003.",
            "editor": "textfield"
          },
          "assessorParcel": {
            "title": "Assessor parcel",
            "type": "string",
            "description": "AIN parcel component. Example: 032.",
            "editor": "textfield"
          },
          "contractorName": {
            "title": "Contractor business name",
            "type": "string",
            "description": "Exact contractor business name for mode=byContractor (Certificate of Occupancy + legacy detailed datasets, including the 2013-2023 all-trades file); substring filter in search mode (Certificate of Occupancy + 2015-2023 legacy detailed datasets). These are the only sources that publish contractor names; status is refreshed from the live feed.",
            "editor": "textfield",
            "sectionCaption": "Permit filters"
          },
          "workDescriptionKeyword": {
            "title": "Work description contains",
            "type": "string",
            "description": "Case-insensitive substring match on the permit's work description. Example: swimming pool.",
            "editor": "textfield"
          },
          "useDescriptionKeyword": {
            "title": "Use description contains",
            "type": "string",
            "description": "Case-insensitive substring match on the LADBS use description. Example: Accessory Dwelling Unit, Office, Retail. Available on live feeds.",
            "editor": "textfield"
          },
          "permitType": {
            "title": "Permit type",
            "type": "string",
            "description": "Filter to one LADBS permit type. Building values include Bldg-New, Bldg-Addition, Bldg-Alter/Repair, Bldg-Demolition, Grading, Swimming-Pool/Spa and Sign. Electrical and mechanical types (Electrical, Plumbing, HVAC, Fire Sprinkler, Elevator, Pressure Vessel) automatically select the matching trade dataset when dataset is left at its default.",
            "editor": "select",
            "enum": [
              "",
              "Bldg-New",
              "Bldg-Addition",
              "Bldg-Alter/Repair",
              "Bldg-Demolition",
              "Bldg-Relocation",
              "Nonbldg-New",
              "Nonbldg-Addition",
              "Nonbldg-Alter/Repair",
              "Nonbldg-Demolition",
              "Grading",
              "Swimming-Pool/Spa",
              "Sign",
              "Electrical",
              "Plumbing",
              "HVAC",
              "Fire Sprinkler",
              "Elevator",
              "Pressure Vessel"
            ],
            "enumTitles": [
              "Any permit type",
              "New building",
              "Addition",
              "Alteration / repair",
              "Demolition",
              "Building relocation",
              "New non-building structure",
              "Non-building addition",
              "Non-building alteration / repair",
              "Non-building demolition",
              "Grading",
              "Swimming pool / spa",
              "Sign",
              "Electrical",
              "Plumbing",
              "HVAC",
              "Fire sprinkler",
              "Elevator",
              "Pressure vessel"
            ],
            "default": "",
            "prefill": ""
          },
          "permitSubType": {
            "title": "Permit sub-type",
            "type": "string",
            "description": "Filter to one building-use sub-type.",
            "editor": "select",
            "enum": [
              "",
              "1 or 2 Family Dwelling",
              "Apartment",
              "Commercial",
              "Onsite",
              "Offsite",
              "Public Safety Only",
              "Special Equipment"
            ],
            "enumTitles": [
              "Any sub-type",
              "1 or 2 Family Dwelling",
              "Apartment",
              "Commercial",
              "Onsite",
              "Offsite",
              "Public safety only",
              "Special equipment"
            ],
            "default": "",
            "prefill": ""
          },
          "permitCategory": {
            "title": "Plan check category",
            "type": "string",
            "description": "Filter by plan-check path. 'No Plan Check' means express/e-permit; 'Plan Check' means plans were reviewed.",
            "editor": "select",
            "enum": [
              "",
              "Plan Check",
              "No Plan Check"
            ],
            "enumTitles": [
              "Any category",
              "Plan Check",
              "No Plan Check (Express/e-Permit)"
            ],
            "default": "",
            "prefill": ""
          },
          "status": {
            "title": "Status",
            "type": "string",
            "description": "Filter to one current status. The exact wording differs by dataset (issued, submitted, CoO).",
            "editor": "select",
            "enum": [
              "",
              "CofC Corrected",
              "CofC Issued",
              "CofO Corrected",
              "CofO in Progress",
              "CofO Issued",
              "CofO Reactivated",
              "CofO Revoked",
              "CofO Superseded",
              "Conditional Approval",
              "Corrections Issued",
              "Corrections Issued 2",
              "Intent to Correct CofC",
              "Intent to Revoke",
              "Intent to Revoke CofC",
              "Issued",
              "No Progress",
              "Not Ready to Issue",
              "Not Required",
              "OK for CofC",
              "OK to Issue CofC",
              "Order to Comply Issued",
              "PC Approved",
              "PC Assigned",
              "PC in Progress",
              "PC Info Complete",
              "Permit Closed",
              "Permit Expired",
              "Permit Extended",
              "Permit Finaled",
              "Permit Revoked",
              "Permit Withdrawn",
              "Plans on Hold",
              "Quality Review Completed",
              "Re-Activate Permit",
              "Ready to Issue",
              "Refund Completed",
              "Refund Denied",
              "Refund in Progress",
              "Reviewed by Supervisor",
              "Submitted",
              "Submitted for Quality Review",
              "Verifications in Progress"
            ],
            "enumTitles": [
              "Any status",
              "CofC Corrected",
              "CofC Issued",
              "CofO Corrected",
              "CofO in Progress",
              "CofO Issued",
              "CofO Reactivated",
              "CofO Revoked",
              "CofO Superseded",
              "Conditional Approval",
              "Corrections Issued",
              "Corrections Issued 2",
              "Intent to Correct CofC",
              "Intent to Revoke",
              "Intent to Revoke CofC",
              "Issued",
              "No Progress",
              "Not Ready to Issue",
              "Not Required",
              "OK for CofC",
              "OK to Issue CofC",
              "Order to Comply Issued",
              "PC Approved",
              "PC Assigned",
              "PC in Progress",
              "PC Info Complete",
              "Permit Closed",
              "Permit Expired",
              "Permit Extended",
              "Permit Finaled",
              "Permit Revoked",
              "Permit Withdrawn",
              "Plans on Hold",
              "Quality Review Completed",
              "Re-Activate Permit",
              "Ready to Issue",
              "Refund Completed",
              "Refund Denied",
              "Refund in Progress",
              "Reviewed by Supervisor",
              "Submitted",
              "Submitted for Quality Review",
              "Verifications in Progress"
            ],
            "default": "",
            "prefill": ""
          },
          "initiatingOffice": {
            "title": "Initiating office",
            "type": "string",
            "description": "Filter to a single LADBS district office. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.",
            "editor": "select",
            "enum": [
              "",
              "METRO",
              "VAN NUYS",
              "INTERNET",
              "WEST LA",
              "SOUTH LA",
              "SANPEDRO"
            ],
            "enumTitles": [
              "Any office",
              "Metro",
              "Van Nuys",
              "Internet (e-Permit)",
              "West LA",
              "South LA",
              "San Pedro"
            ],
            "default": "",
            "prefill": ""
          },
          "occupancy": {
            "title": "Occupancy group",
            "type": "string",
            "description": "Building-code occupancy classification. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.",
            "editor": "select",
            "enum": [
              "",
              "A1 Occ. Group",
              "A2 Occ. Group",
              "A3 Occ. Group",
              "A5 Occ. Group",
              "B Occ. Group",
              "E Occ. Group",
              "E1 Occ. Group",
              "E3 Occ. Group",
              "F1 Occ. Group",
              "F2 Occ. Group",
              "H4 Occ. Group",
              "I2 Occ. Group",
              "M Occ. Group",
              "Misc. Occ. Group",
              "R1 Occ. Group",
              "R2 Occ. Group",
              "R2.1 Occ. Group",
              "R3 Occ. Group",
              "R4 Occ. Group",
              "S1 Occ. Group",
              "S2 Occ. Group",
              "S3 Occ. Group",
              "U Occ. Group",
              "U1 Occ. Group",
              "U2 Occ. Group"
            ],
            "enumTitles": [
              "Any occupancy",
              "A1 - Assembly (fixed seats)",
              "A2 - Assembly (food/drink)",
              "A3 - Assembly (worship/amusement)",
              "A5 - Assembly (outdoor)",
              "B - Business",
              "E - Educational",
              "E1 - Educational",
              "E3 - Educational",
              "F1 - Factory (moderate hazard)",
              "F2 - Factory (low hazard)",
              "H4 - High hazard",
              "I2 - Institutional (medical)",
              "M - Mercantile",
              "Miscellaneous",
              "R1 - Residential (hotel/motel)",
              "R2 - Residential (apartments)",
              "R2.1 - Residential (assisted living)",
              "R3 - Residential (1-2 family)",
              "R4 - Residential (assisted living, small)",
              "S1 - Storage (moderate hazard)",
              "S2 - Storage (low hazard)",
              "S3 - Storage (vehicles/repair)",
              "U - Utility/Misc.",
              "U1 - Utility/Misc.",
              "U2 - Utility/Misc."
            ],
            "default": "",
            "prefill": ""
          },
          "constructionType": {
            "title": "Construction type",
            "type": "string",
            "description": "Building-code construction class, published on live feeds for a minority of permits.",
            "editor": "select",
            "enum": [
              "",
              "Type I-A Construction",
              "Type I-B Construction",
              "Type I-F.R. Construction",
              "Type II-A Construction",
              "Type II-B Construction",
              "Type II-F.R. Construction",
              "Type III-A Construction",
              "Type III-B Construction",
              "Type III-N Construction",
              "Type IV-H.T. Construction",
              "Type V-A Construction",
              "Type V-B Construction",
              "Type V-N Construction",
              "Type V-1HR Construction"
            ],
            "enumTitles": [
              "Any construction type",
              "Type I-A",
              "Type I-B",
              "Type I-F.R.",
              "Type II-A",
              "Type II-B",
              "Type II-F.R.",
              "Type III-A",
              "Type III-B",
              "Type III-N",
              "Type IV-H.T.",
              "Type V-A",
              "Type V-B",
              "Type V-N",
              "Type V-1HR"
            ],
            "default": "",
            "prefill": ""
          },
          "businessUnit": {
            "title": "Issuing business unit",
            "type": "string",
            "description": "How LADBS processed the permit. Express Permit is the same as No Plan Check.",
            "editor": "select",
            "enum": [
              "",
              "Express Permit",
              "Plan Check at Counter",
              "Regular Plan Check",
              "Expanded Counter Plan Check",
              "Appointment Plan Check"
            ],
            "enumTitles": [
              "Any business unit",
              "Express Permit (no plan check)",
              "Plan Check at Counter",
              "Regular Plan Check",
              "Expanded Counter Plan Check",
              "Appointment Plan Check"
            ],
            "default": "",
            "prefill": ""
          },
          "zipCodes": {
            "title": "Zip codes",
            "type": "array",
            "description": "Restrict results to one or more 5-digit LA zip codes. Example: 90047.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "issueDateFrom": {
            "title": "Issue date from (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop permits issued before this date. The actor automatically reads the matching era dataset (2020+, 2010-2019, pre-2010).",
            "editor": "textfield"
          },
          "issueDateTo": {
            "title": "Issue date to (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop permits issued after this date.",
            "editor": "textfield"
          },
          "submittedDateFrom": {
            "title": "Submitted date from (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop applications submitted before this date. Select dataset=submittedBuilding (or a submitted trade dataset) to include applications before issuance.",
            "editor": "textfield"
          },
          "submittedDateTo": {
            "title": "Submitted date to (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop applications submitted after this date.",
            "editor": "textfield"
          },
          "statusDateFrom": {
            "title": "Status date from (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop permits whose latest status change is before this date.",
            "editor": "textfield"
          },
          "statusDateTo": {
            "title": "Status date to (YYYY-MM-DD)",
            "type": "string",
            "description": "Drop permits whose latest status change is after this date.",
            "editor": "textfield"
          },
          "minValuation": {
            "title": "Min valuation (USD)",
            "type": "number",
            "description": "Drop permits with a lower applicant-declared construction valuation. The figure is declared on the application, not a contract price.",
            "editor": "number",
            "minimum": 0,
            "maximum": 1000000000
          },
          "maxValuation": {
            "title": "Max valuation (USD)",
            "type": "number",
            "description": "Drop permits with a higher applicant-declared construction valuation.",
            "editor": "number",
            "minimum": 0,
            "maximum": 1000000000
          },
          "minSquareFootage": {
            "title": "Min square footage",
            "type": "number",
            "description": "Drop permits with a lower published square footage. Permits without a published figure are excluded when this is set.",
            "editor": "number",
            "minimum": 0,
            "maximum": 100000000
          },
          "maxSquareFootage": {
            "title": "Max square footage",
            "type": "number",
            "description": "Drop permits with a higher published square footage.",
            "editor": "number",
            "minimum": 0,
            "maximum": 100000000
          },
          "minStories": {
            "title": "Min number of stories",
            "type": "integer",
            "description": "Drop permits with fewer stories. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.",
            "editor": "number",
            "minimum": 0,
            "maximum": 200
          },
          "maxStories": {
            "title": "Max number of stories",
            "type": "integer",
            "description": "Drop permits with more stories. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.",
            "editor": "number",
            "minimum": 0,
            "maximum": 200
          },
          "minResidentialUnits": {
            "title": "Min residential dwelling units",
            "type": "integer",
            "description": "Drop permits with fewer residential dwelling units. Only published in the Certificate of Occupancy and legacy detailed datasets; when set, the actor searches those.",
            "editor": "number",
            "minimum": 0,
            "maximum": 10000
          },
          "councilDistrict": {
            "title": "Council district",
            "type": "integer",
            "description": "Filter to one Los Angeles city council district (1-15). Available on live permit feeds only, not on the CoO/legacy detailed datasets.",
            "editor": "number",
            "minimum": 1,
            "maximum": 15
          },
          "communityPlanArea": {
            "title": "Community plan area contains",
            "type": "string",
            "description": "Case-insensitive substring match on the LADBS community plan area. Example: Venice. Available on live permit feeds only, not on the CoO/legacy detailed datasets.",
            "editor": "textfield"
          },
          "neighborhoodCouncil": {
            "title": "Neighborhood council contains",
            "type": "string",
            "description": "Case-insensitive substring match on the neighbourhood council name. Example: Encino. Available on live permit feeds only, not on the CoO/legacy detailed datasets.",
            "editor": "textfield"
          },
          "aduOnly": {
            "title": "ADU permits only",
            "type": "boolean",
            "description": "Keep only permits that add at least one ADU or junior ADU. Available on live feeds.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "evChargingOnly": {
            "title": "EV-charging permits only",
            "type": "boolean",
            "description": "Keep only permits flagged by LADBS for electric-vehicle charging. Available on live feeds.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "solarOnly": {
            "title": "Solar permits only",
            "type": "boolean",
            "description": "Keep only permits flagged by LADBS as solar. Available on live feeds.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "nearLatitude": {
            "title": "Near latitude (geo-radius search)",
            "type": "number",
            "description": "Latitude of a centre point. Combine with nearLongitude (and optionally radiusMeters) to return only permits within a radius. Example: 34.0522 (downtown LA).",
            "editor": "number",
            "sectionCaption": "Geo-radius search",
            "minimum": -90,
            "maximum": 90
          },
          "nearLongitude": {
            "title": "Near longitude (geo-radius search)",
            "type": "number",
            "description": "Longitude of the centre point. Example: -118.2437 (downtown LA).",
            "editor": "number",
            "minimum": -180,
            "maximum": 180
          },
          "radiusMeters": {
            "title": "Radius (meters)",
            "type": "number",
            "description": "Search radius around the centre point. Only used when both coordinates are set.",
            "editor": "number",
            "minimum": 1,
            "maximum": 50000,
            "default": 500,
            "prefill": 500
          },
          "sortBy": {
            "title": "Sort by",
            "type": "string",
            "description": "Order for live datasets. The stories / residential-unit options are kept for saved tasks and work on the Certificate of Occupancy and legacy detailed datasets; live feeds fall back to issue date with a status note.",
            "editor": "select",
            "sectionCaption": "Output",
            "enum": [
              "issueDateDesc",
              "issueDateAsc",
              "statusDateDesc",
              "statusDateAsc",
              "submittedDateDesc",
              "submittedDateAsc",
              "cofoDateDesc",
              "cofoDateAsc",
              "valuationDesc",
              "valuationAsc",
              "squareFootageDesc",
              "squareFootageAsc",
              "storiesDesc",
              "storiesAsc",
              "residentialUnitsDesc",
              "residentialUnitsAsc"
            ],
            "enumTitles": [
              "Issue date (newest first)",
              "Issue date (oldest first)",
              "Status date (newest first)",
              "Status date (oldest first)",
              "Submitted date (newest first)",
              "Submitted date (oldest first)",
              "Certificate of Occupancy date (newest first)",
              "Certificate of Occupancy date (oldest first)",
              "Valuation (highest first)",
              "Valuation (lowest first)",
              "Square footage (largest first)",
              "Square footage (smallest first)",
              "Stories (highest first, CoO/legacy only)",
              "Stories (lowest first, CoO/legacy only)",
              "Residential units (highest first, CoO/legacy only)",
              "Residential units (lowest first, CoO/legacy only)"
            ],
            "default": "issueDateDesc",
            "prefill": "issueDateDesc"
          },
          "includeDetails": {
            "title": "Include contractor / occupancy details",
            "type": "boolean",
            "description": "Batch-look up each live-feed permit in the Certificate of Occupancy and legacy detailed datasets to fill contractor, applicant, licence, occupancy, stories and residential-unit fields where LADBS publishes them. Adds a few requests per 100 permits. Detail-dataset records are always refreshed with current live status regardless of this setting.",
            "editor": "checkbox",
            "default": true,
            "prefill": false
          },
          "includeInspections": {
            "title": "Include inspection summaries",
            "type": "boolean",
            "description": "Batch-look up the LADBS inspections dataset and add inspectionCount, first/last inspection date, and last inspection type/result. Only populated where inspections exist.",
            "editor": "checkbox",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 10000,
            "default": 50,
            "prefill": 3
          },
          "appToken": {
            "title": "Socrata app token (optional)",
            "type": "string",
            "description": "Optional free Socrata app token to raise API rate limits. Not required.",
            "editor": "textfield",
            "sectionCaption": "Advanced"
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "LA Building Permit Records & Contractor Lookup Output",
        "description": "Live City of Los Angeles Department of Building & Safety permit records across building, electrical and mechanical trades (issued or submitted), Certificates of Occupancy, and legacy detailed permits. Fields include permit identity/type/status, submitted/issue/status/CoO dates, address and zoning, council district, APN/PIN, community plan area, neighbourhood council, use code/description, valuation, square footage, construction type, height, ADU/EV/solar flags, geolocation, and contractor/applicant/occupancy details where LADBS publishes them.",
        "properties": {
          "permits": {
            "type": "string",
            "title": "Permits",
            "description": "Dataset containing all scraped LA permit records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "defaultRunOptions": {
        "memoryMbytes": 1024
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Building permits",
              "transformation": {
                "fields": [
                  "permitNumber",
                  "permitGroup",
                  "permitType",
                  "status",
                  "fullAddress",
                  "zipCode",
                  "submittedDate",
                  "issueDate",
                  "valuation",
                  "useDescription",
                  "workDescription",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "2.0.2",
    "imageDigest": "f9a92871cc8096aac0d00d36cc0894c9a3cdef9afb794041a57e9fcf72c914c6",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "2.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0064733333333333335
    }
  }
}