--- type: "firecrawl-provider" description: "Building, roof, siding, solar, electrical, mechanical and plumbing permits issued by the City of Cambridge, Massachusetts Inspectional Services Department, from nine datasets on the Cambridge Open Data Portal (data.cambridgema.gov, Socrata), reloaded daily from the city's permitting system. Search one category, or the five building permit datasets merged, by address, ZIP, map-block-lot parcel, contractor, permit type, work description, status, equipment (heat pumps, ductless splits, EV chargers, solar PV, batteries, generators, electric water heaters), issue and application dates and declared cost, newest first; read one permit with every published column; and rank contractors by permits and declared cost in a date window. Records follow the shared permits shape with typed equipment details for solar (kW, panels, inverter, battery), electrical, mechanical and plumbing permits. The data is dedicated to the public domain under the ODC PDDL: every response and record carries its licence, attribution and source URL." use_when: "Building, roof, siding, solar, electrical, mechanical and plumbing permits issued by the City of Cambridge, Massachusetts Inspectional Services Department, from nine datasets on the Cambridge Open Data Portal (data.cambridgema.gov, Socrata), reloaded daily from the city's permitting system. Search one category, or the five building permit datasets merged, by address, ZIP, map-block-lot parcel, contractor, permit type, work description, status, equipment (heat pumps, ductless splits, EV chargers, solar PV, batteries, generators, electric water heaters), issue and application dates and declared cost, newest first; read one permit with every published column; and rank contractors by permits and declared cost in a date window. Records follow the shared permits shape with typed equipment details for solar (kW, panels, inverter, battery), electrical, mechanical and plumbing permits. The data is dedicated to the public domain under the ODC PDDL: every response and record carries its licence, attribution and source URL." categories: "Real estate" capabilities: 3 credits_per_call: 5 --- # City of Cambridge, MA permits (data.cambridgema.gov) on Firecrawl Alexandria Building, roof, siding, solar, electrical, mechanical and plumbing permits issued by the City of Cambridge, Massachusetts Inspectional Services Department, from nine datasets on the Cambridge Open Data Portal (data.cambridgema.gov, Socrata), reloaded daily from the city's permitting system. Search one category, or the five building permit datasets merged, by address, ZIP, map-block-lot parcel, contractor, permit type, work description, status, equipment (heat pumps, ductless splits, EV chargers, solar PV, batteries, generators, electric water heaters), issue and application dates and declared cost, newest first; read one permit with every published column; and rank contractors by permits and declared cost in a date window. Records follow the shared permits shape with typed equipment details for solar (kW, panels, inverter, battery), electrical, mechanical and plumbing permits. The data is dedicated to the public domain under the ODC PDDL: every response and record carries its licence, attribution and source URL. - Categories: Real estate - Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate) - Provider key: `data-cambridgema-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/data-cambridgema-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/openapi.json) ## Capabilities - [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/contractor_activity): Rank the contractors on City of Cambridge permits of one category issued in a date window by permit count, then total declared cost, in one grouped SODA request: solar installers, electrical licensees, mechanical and plumbing companies, alteration and short form firms, roof firms, new construction supervisors and siding licence numbers. Optional permit type, ZIP and equipment filters, so heat pump installers rank by heat pump permits. Each contractor has permits, total cost, first and last issue date in the window and a source_url listing those permits. A window without contractors is a successful result with count 0. - [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/get_permit): Read one City of Cambridge permit by its permit number: the shared permit record, its dataset, and raw with every published column (applicant and homeowner names left out). Pass category for solar, electrical, mechanical and plumbing permits; without it the five building permit datasets are checked. An unknown number is not_found. - [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/search_permits): Search City of Cambridge, MA permits in one category (new_construction, alteration, short_form, roof, siding, solar, electrical, mechanical, plumbing) or, with no category, the five building permit datasets merged in sort order. Filters: address or ZIP, map-block-lot parcel, contractor name, company or licence number, permit type and building use, work description, status, equipment (heat_pump, ductless_split, ev_charger, solar_pv, battery_storage, generator, electric_water_heater), issue and application date windows and minimum declared cost. Newest issued first by default, or newest application, or largest cost. Each record has the shared permit fields, its category, the licensed contractors, typed equipment details for solar, electrical, mechanical and plumbing permits, source_url and licence. An empty page is a valid result. ## 1. Choose this provider when Building, roof, siding, solar, electrical, mechanical and plumbing permits issued by the City of Cambridge, Massachusetts Inspectional Services Department, from nine datasets on the Cambridge Open Data Portal (data.cambridgema.gov, Socrata), reloaded daily from the city's permitting system. Search one category, or the five building permit datasets merged, by address, ZIP, map-block-lot parcel, contractor, permit type, work description, status, equipment (heat pumps, ductless splits, EV chargers, solar PV, batteries, generators, electric water heaters), issue and application dates and declared cost, newest first; read one permit with every published column; and rank contractors by permits and declared cost in a date window. Records follow the shared permits shape with typed equipment details for solar (kW, panels, inverter, battery), electrical, mechanical and plumbing permits. The data is dedicated to the public domain under the ODC PDDL: every response and record carries its licence, attribution and source URL. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "data-cambridgema-gov", "capability": "building-permits/contractor_activity", "options": { "category": "solar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` ## 3. Add provider options Use only the options needed for the task: - `category` (string, required): Which dataset to rank contractors in. Example: `new_construction` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]{1,7}$. Example: `` - `equipment` (string): Only permits with this equipment, by the dataset's own counts: electrical (heat_pump, ductless_split, ev_charger, solar_pv, generator), mechanical (heat_pump, ductless_split), solar (solar_pv, battery_storage), plumbing (electric_water_heater). Needs category; other pairs are invalid_input. Example: `heat_pump` - `issued_since` (string, required): First issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Last issue date, inclusive (YYYY-MM-DD); open-ended when omitted. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Records per page. Example: `25` - `permit_type` (string): Case-insensitive substring over permit type, building use and work type, as in search_permits. Example: `` - `zip` (string): Only permits whose address ends in this ZIP (02138, 02139, 02140, 02141, 02142). Pattern: ^[0-9]{5}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-cambridgema-gov", capability: "building-permits/contractor_activity", options: { category: "solar", issued_since: "2025-01-01", issued_until: "2025-12-31", limit: 5, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-cambridgema-gov", "capability": "building-permits/contractor_activity", "options": { "category": "solar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-cambridgema-gov", "capability": "building-permits/contractor_activity", "options": { "category": "solar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } }' ``` ### CLI ```sh firecrawl scrape 'data-cambridgema-gov/building-permits/contractor_activity' \ --options '{"category":"solar","issued_since":"2025-01-01","issued_until":"2025-12-31","limit":5}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-cambridgema-gov", "capability": "building-permits/contractor_activity", "options": { "category": "solar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-cambridgema-gov", "capability": "building-permits/contractor_activity", "options": { "category": "solar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "category": "solar", "count": 5, "dataset": { "category": "solar", "id": "whpw-w55x", "name": "Solar Installation Permits", "portal": "data.cambridgema.gov", "updated_at": "2026-10-27T09:55:05Z", "url": "https://data.cambridgema.gov/d/whpw-w55x" }, "issued_since": "2025-01-01", "issued_until": "2025-12-31", "jurisdiction": { "county": "Middlesex County", "name": "City of Cambridge", "state": "MA" }, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "next_cursor": "5", "observed_at_ms": 1793149568566, "records": [ { "first_issued_date": "2025-01-14", "last_issued_date": "2025-11-14", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Great Sky Solar", "permits": 11, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27GREAT+SKY+SOLAR%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 349909.4 }, { "first_issued_date": "2025-10-16", "last_issued_date": "2025-10-28", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "The Boston Solar Company LLC", "permits": 10, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27THE+BOSTON+SOLAR+COMPANY+LLC%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 652356.15 }, { "first_issued_date": "2025-05-08", "last_issued_date": "2025-11-24", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Boston Solar", "permits": 8, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27BOSTON+SOLAR%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 422403.88 }, { "first_issued_date": "2025-03-11", "last_issued_date": "2025-12-02", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "ReVision Energy", "permits": 8, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27REVISION+ENERGY%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 275262 }, { "first_issued_date": "2025-01-23", "last_issued_date": "2025-12-29", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Trinity Solar LLC", "permits": 6, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27TRINITY+SOLAR+LLC%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 206430.82 } ], "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24select=upper%28trim%28firm_name%29%29+AS+contractor_key%2Cmax%28firm_name%29+AS+contractor_name%2Ccount%28*%29+AS+permits%2Csum%28total_cost%29+AS+valuation%2Cmin%28issue_date%29+AS+first_issued%2Cmax%28issue_date%29+AS+last_issued&%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+firm_name+IS+NOT+NULL&%24group=upper%28trim%28firm_name%29%29&%24order=permits+DESC%2C+valuation+DESC+NULL+LAST%2C+contractor_key&%24limit=5" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Contractor activity - Capability: `building-permits/contractor_activity` - Description: Rank the contractors on City of Cambridge permits of one category issued in a date window by permit count, then total declared cost, in one grouped SODA request: solar installers, electrical licensees, mechanical and plumbing companies, alteration and short form firms, roof firms, new construction supervisors and siding licence numbers. Optional permit type, ZIP and equipment filters, so heat pump installers rank by heat pump permits. Each contractor has permits, total cost, first and last issue date in the window and a source_url listing those permits. A window without contractors is a successful result with count 0. - Instructions: Use for contractor market share in Cambridge: who installs the most solar, heat pumps or EV chargers, or who pulls the most roof or alteration permits. Then search_permits with contractor set to the name for that contractor's jobs. - Cost: 5 credits per call - Capability file: [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/contractor_activity) Accepted options: - `category` (string, required): Which dataset to rank contractors in. Example: `new_construction` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]{1,7}$. Example: `` - `equipment` (string): Only permits with this equipment, by the dataset's own counts: electrical (heat_pump, ductless_split, ev_charger, solar_pv, generator), mechanical (heat_pump, ductless_split), solar (solar_pv, battery_storage), plumbing (electric_water_heater). Needs category; other pairs are invalid_input. Example: `heat_pump` - `issued_since` (string, required): First issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Last issue date, inclusive (YYYY-MM-DD); open-ended when omitted. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Records per page. Example: `25` - `permit_type` (string): Case-insensitive substring over permit type, building use and work type, as in search_permits. Example: `` - `zip` (string): Only permits whose address ends in this ZIP (02138, 02139, 02140, 02141, 02142). Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "category": "solar", "count": 5, "dataset": { "category": "solar", "id": "whpw-w55x", "name": "Solar Installation Permits", "portal": "data.cambridgema.gov", "updated_at": "2026-10-27T09:55:05Z", "url": "https://data.cambridgema.gov/d/whpw-w55x" }, "issued_since": "2025-01-01", "issued_until": "2025-12-31", "jurisdiction": { "county": "Middlesex County", "name": "City of Cambridge", "state": "MA" }, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "next_cursor": "5", "observed_at_ms": 1793149568566, "records": [ { "first_issued_date": "2025-01-14", "last_issued_date": "2025-11-14", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Great Sky Solar", "permits": 11, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27GREAT+SKY+SOLAR%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 349909.4 }, { "first_issued_date": "2025-10-16", "last_issued_date": "2025-10-28", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "The Boston Solar Company LLC", "permits": 10, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27THE+BOSTON+SOLAR+COMPANY+LLC%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 652356.15 }, { "first_issued_date": "2025-05-08", "last_issued_date": "2025-11-24", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Boston Solar", "permits": 8, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27BOSTON+SOLAR%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 422403.88 }, { "first_issued_date": "2025-03-11", "last_issued_date": "2025-12-02", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "ReVision Energy", "permits": 8, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27REVISION+ENERGY%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 275262 }, { "first_issued_date": "2025-01-23", "last_issued_date": "2025-12-29", "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "license_number": null, "name": "Trinity Solar LLC", "permits": 6, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+upper%28trim%28firm_name%29%29+%3D+%27TRINITY+SOLAR+LLC%27&%24order=issue_date+DESC%2C+id", "total_valuation_usd": 206430.82 } ], "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24select=upper%28trim%28firm_name%29%29+AS+contractor_key%2Cmax%28firm_name%29+AS+contractor_name%2Ccount%28*%29+AS+permits%2Csum%28total_cost%29+AS+valuation%2Cmin%28issue_date%29+AS+first_issued%2Cmax%28issue_date%29+AS+last_issued&%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issue_date+%3C%3D+%272025-12-31T23%3A59%3A59.999%27+AND+firm_name+IS+NOT+NULL&%24group=upper%28trim%28firm_name%29%29&%24order=permits+DESC%2C+valuation+DESC+NULL+LAST%2C+contractor_key&%24limit=5" } ``` ### Get permit - Capability: `building-permits/get_permit` - Description: Read one City of Cambridge permit by its permit number: the shared permit record, its dataset, and raw with every published column (applicant and homeowner names left out). Pass category for solar, electrical, mechanical and plumbing permits; without it the five building permit datasets are checked. An unknown number is not_found. - Instructions: Use after search_permits for the full record: costs by trade, construction details, review flags, Mass Save ids, equipment counts, inspection districts. Pass the record's category so one dataset is read. - Cost: 5 credits per call - Capability file: [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/get_permit) Accepted options: - `category` (string): The permit's category, from the record. Omit to look in the five building permit datasets only; solar, electrical, mechanical and plumbing permits need it. Example: `new_construction` - `permit_number` (string, required): Cambridge permit id, from a record's permit_number (1223282). Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "address": "7 Woodrow Wilson Ct", "applied_date": "2026-07-28", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "The Boston Solar Company, LLC", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "dataset": { "category": "solar", "id": "whpw-w55x", "name": "Solar Installation Permits", "portal": "data.cambridgema.gov", "updated_at": "2026-10-27T09:55:05Z", "url": "https://data.cambridgema.gov/d/whpw-w55x" }, "description": "Installation of a 33.32 kW DC / 20 kW AC rooftop solar system (56 modules). DC connected EPO to be installed per Fire Prevention.", "details": { "battery_storage": false, "inverter_count": 2, "inverter_model": "SOLAR EDGE SE10KUS", "inverter_type": "String Inverter", "mount_type": "Roof-Mount", "panel_count": 56, "panel_watts": 590, "system_size_kw": 33.32 }, "expires_date": null, "housing_units": null, "issued_date": "2026-10-16", "jurisdiction": { "county": "Middlesex County", "name": "City of Cambridge", "state": "MA" }, "latitude": 42.361197, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.109678, "observed_at_ms": 1793149561854, "parcel_id": "104-130", "permit_class": "Commercial / Mixed Use", "permit_number": "1223282", "permit_type": "Solar Installation", "raw": { "additional_cost": "-97170.64", "applicant_role": "Authorized Agent", "applicant_signature": "true", "applicant_submit_date": "2026-07-28T00:00:00.000", "authorized_agent": "Yes", "battery_storage_capacity": false, "building_construction_type": "Steel/Concrete, Non-Combustible (Type I/II)", "building_cost": "32390.21", "building_use": "Commercial / Mixed Use", "coordinates": { "coordinates": [ -71.109678, 42.361197 ], "type": "Point" }, "debris_removal_date": "2026-07-28T00:00:00.000", "debris_removal_location": "Boston Solar Warehouse - 10 Gill Street, Unit U, Woburn, MA 01801", "demolition_type": "No demolition required", "electrical_cost": "64780.43", "firm_name": "The Boston Solar Company, LLC", "full_address": "7 Woodrow Wilson Ct, Cambridge, MA 02139", "height": "40", "id": "1223282", "insurance_company": "QBE Insurance Corporation", "inverter_count": "2", "inverter_make_and_model": "SOLAR EDGE SE10KUS", "inverter_type": "String Inverter", "issue_date": "2026-10-16T00:00:00.000", "latitude": "42.361197", "location_flags": "Building Inspection District: Cambridgeport East, Electric Inspection District: East Cambridge, Fire Company Inspection District: E-6, Housing Inspection District: Mid Cambridge, Neighborhood: Cambridgeport, Plumbing/Gas Inspection District: East Cambridge, Sanitary Inspection District: The Port, Zone Type: C-1", "longitude": "-71.109678", "mbl": "104-130", "method_of_removal": "Daily Removal", "mount_type": "Roof-Mount", "permit_type": "Solar Installation", "photovoltaic_panel_count": "56", "plumbing_cost": "0", "solar_energy_type": "Photovoltaic", "solar_system_size": "33.32", "status": "Active", "stories_above_grade": "2", "total_cost": "97170.64", "viewpoint_id": "1470810", "watt_capacity": "590", "work_description": "Installation of a 33.32 kW DC / 20 kW AC rooftop solar system (56 modules). DC connected EPO to be installed per Fire Prevention." }, "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1223282", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 97170.64, "work_class": "Photovoltaic", "zip": "02139" } ``` ### Search permits - Capability: `building-permits/search_permits` - Description: Search City of Cambridge, MA permits in one category (new_construction, alteration, short_form, roof, siding, solar, electrical, mechanical, plumbing) or, with no category, the five building permit datasets merged in sort order. Filters: address or ZIP, map-block-lot parcel, contractor name, company or licence number, permit type and building use, work description, status, equipment (heat_pump, ductless_split, ev_charger, solar_pv, battery_storage, generator, electric_water_heater), issue and application date windows and minimum declared cost. Newest issued first by default, or newest application, or largest cost. Each record has the shared permit fields, its category, the licensed contractors, typed equipment details for solar, electrical, mechanical and plumbing permits, source_url and licence. An empty page is a valid result. - Instructions: Use for permits at a Cambridge address or parcel, a contractor's Cambridge jobs, or electrification work: heat pump installs (category electrical or mechanical with equipment heat_pump), solar (category solar, kW in details), EV chargers and panel upgrades (electrical). To poll for new permits pass issued_since (the last day you checked) with the default newest-first sort; the portal rewrites every row's system timestamp on its daily reload, so there is no updated_since. Pass a record's permit_number and category to get_permit for every published column. - Cost: 5 credits per call - Capability file: [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-cambridgema-gov/building-permits/search_permits) Accepted options: - `address` (string): Case-insensitive substring of the published address (Massachusetts Ave, 44 Russell St). Example: `
` - `applied_since` (string): Only applications submitted on or after this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `applied_until` (string): Only applications submitted on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `category` (string): Which dataset to search. Omit to search the five building permit datasets (new_construction, alteration, short_form, roof, siding) merged in sort order; solar, electrical, mechanical and plumbing are searched only when named. Example: `new_construction` - `contractor` (string): Case-insensitive substring of the contractor names, companies and licence numbers the category publishes (solar installer, electrical licensee, mechanical or plumbing company, firm or construction supervisor and CS licence number on building permits). Example: `` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^([0-9]{1,7}|([0-9]{1,7}|x)(\.([0-9]{1,7}|x)){4})$. Example: `` - `description` (string): Case-insensitive substring of the work description: heat pump, insulation, solar, kitchen. Mechanical and plumbing publish no description. Example: `` - `equipment` (string): Only permits with this equipment, by the dataset's own counts: electrical (heat_pump, ductless_split, ev_charger, solar_pv, generator), mechanical (heat_pump, ductless_split), solar (solar_pv, battery_storage), plumbing (electric_water_heater). Needs category; other pairs are invalid_input. Example: `heat_pump` - `issued_since` (string): Only permits issued on or after this day, YYYY-MM-DD. Poll for new permits with issued_since set to the last day you checked. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Only permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Records per page. Example: `25` - `min_valuation` (number): Only permits whose declared cost is at least this many USD (not mechanical or plumbing, which publish none). Example: `10` - `parcel_id` (string): Exact Cambridge map-block-lot (MBL) as in records' parcel_id: 180-14, 1A-210, 190-109-1. Pattern: ^[0-9A-Za-z-]+$. Example: `` - `permit_type` (string): Case-insensitive substring over permit type, building use and work type: one or two family, multi family, commercial, roof-mount, replacement, renovation. Example: `` - `sort` (string): issued_desc: newest issue date first; applied_desc: newest application first; valuation_desc: largest declared cost first (not mechanical or plumbing). Example: `issued_desc` - `status` (string): Case-insensitive substring of status: Active or Complete. Example: `` - `zip` (string): Only permits whose address ends in this ZIP (02138, 02139, 02140, 02141, 02142). Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "category": "solar", "count": 5, "dataset": { "category": "solar", "id": "whpw-w55x", "name": "Solar Installation Permits", "portal": "data.cambridgema.gov", "updated_at": "2026-10-27T09:55:05Z", "url": "https://data.cambridgema.gov/d/whpw-w55x" }, "datasets": [ { "category": "solar", "id": "whpw-w55x", "name": "Solar Installation Permits", "portal": "data.cambridgema.gov", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24select=id%2Cpermit_type%2Cstatus%2Capplicant_submit_date%2Cissue_date%2Cfull_address%2Clatitude%2Clongitude%2Cmbl%2Cbuilding_use%2Csolar_energy_type%2Cwork_description%2Ctotal_cost%2Cfirm_name%2Csolar_system_size%2Cphotovoltaic_panel_count%2Cwatt_capacity%2Cinverter_count%2Cinverter_type%2Cinverter_make_and_model%2Cmount_type%2Cbattery_storage_capacity&%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27&%24order=issue_date+DESC%2C+id&%24limit=5", "updated_at": "2026-10-27T09:55:05Z", "url": "https://data.cambridgema.gov/d/whpw-w55x" } ], "jurisdiction": { "county": "Middlesex County", "name": "City of Cambridge", "state": "MA" }, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "next_cursor": "5", "observed_at_ms": 1793149559648, "records": [ { "address": "7 Woodrow Wilson Ct", "applied_date": "2026-07-28", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "The Boston Solar Company, LLC", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "description": "Installation of a 33.32 kW DC / 20 kW AC rooftop solar system (56 modules). DC connected EPO to be installed per Fire Prevention.", "details": { "battery_storage": false, "inverter_count": 2, "inverter_model": "SOLAR EDGE SE10KUS", "inverter_type": "String Inverter", "mount_type": "Roof-Mount", "panel_count": 56, "panel_watts": 590, "system_size_kw": 33.32 }, "expires_date": null, "housing_units": null, "issued_date": "2026-10-16", "latitude": 42.361197, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.109678, "parcel_id": "104-130", "permit_class": "Commercial / Mixed Use", "permit_number": "1223282", "permit_type": "Solar Installation", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1223282", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 97170.64, "work_class": "Photovoltaic", "zip": "02139" }, { "address": "15 EDMUNDS ST, Unit B", "applied_date": "2026-09-28", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "New England Clean Energy", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "description": "Roof top installation of 24 solar panels and micro inverters with pest and snow guards", "details": { "battery_storage": false, "inverter_count": 24, "inverter_model": "Enphase : Microinverter, Dom, IQ8X", "inverter_type": "Micro-Inverter", "mount_type": "Roof-Mount", "panel_count": 24, "panel_watts": 470, "system_size_kw": 11.04 }, "expires_date": null, "housing_units": null, "issued_date": "2026-10-07", "latitude": 42.398549, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.132539, "parcel_id": "189-81-B", "permit_class": "One or Two Family Dwelling", "permit_number": "1232253", "permit_type": "Solar Installation", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1232253", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 32854, "work_class": "Photovoltaic", "zip": "02140" }, { "address": "17 Gray Gdns E", "applied_date": "2026-07-14", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "Revision Energy", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "description": "Installation of (27) 440w solar modules, (2) Tesla Powerwall 3.0s battery/ESS units, and associated electrical work", "details": { "battery_storage": true, "inverter_count": 24, "inverter_model": "ENPHASE IQ8MC-72-M-US", "inverter_type": "Micro-Inverter", "mount_type": "Roof-Mount", "panel_count": 27, "panel_watts": 8.64, "system_size_kw": 11.88 }, "expires_date": null, "housing_units": null, "issued_date": "2026-10-06", "latitude": 42.384263, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.127019, "parcel_id": "207-42", "permit_class": "One or Two Family Dwelling", "permit_number": "1221094", "permit_type": "Solar Installation", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1221094", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 68238, "work_class": "Photovoltaic", "zip": "02138" }, { "address": "101 Reed St", "applied_date": "2026-09-04", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "Second Generation Energy LLC", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "description": "Rooftop PV Install of 18 modules ( 8.28kwDC) with an ESS (2 Enphase 5kw batteries)", "details": { "battery_storage": true, "inverter_count": 18, "inverter_model": "Enphase IQ8X-80-M-US", "inverter_type": "Micro-Inverter", "mount_type": "Roof-Mount", "panel_count": 18, "panel_watts": 460, "system_size_kw": 8.28 }, "expires_date": null, "housing_units": null, "issued_date": "2026-10-05", "latitude": 42.396302, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.132097, "parcel_id": "191-28", "permit_class": "One or Two Family Dwelling", "permit_number": "1229601", "permit_type": "Solar Installation", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1229601", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 43700, "work_class": "Photovoltaic", "zip": "02140" }, { "address": "52 New St", "applied_date": "2026-05-12", "category": "solar", "city": "Cambridge", "completed_date": null, "contractors": [ { "company": "Solect Energy", "license_number": null, "name": null, "phone": null, "role": "installer" } ], "description": "Installing rooftop solar PV of 50 KW, 94 modules and racking.", "details": { "battery_storage": false, "inverter_count": 1, "inverter_model": "Solaredge SE50K-US", "inverter_type": "String Inverter", "mount_type": "Roof-Mount", "panel_count": 94, "panel_watts": 550, "system_size_kw": 51.7 }, "expires_date": null, "housing_units": null, "issued_date": "2026-09-17", "latitude": 42.388524, "license": { "attribution": "City of Cambridge, MA, Inspectional Services Department, via the Cambridge Open Data Portal (data.cambridgema.gov)", "name": "Open Data Commons Public Domain Dedication and License", "url": "http://opendatacommons.org/licenses/pddl/1.0/" }, "longitude": -71.14025, "parcel_id": "273-47", "permit_class": "Commercial / Mixed Use", "permit_number": "1211244", "permit_type": "Solar Installation", "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?id=1211244", "square_feet": null, "state": "MA", "status": "Active", "valuation_usd": 178805.9, "work_class": "Photovoltaic", "zip": "02138" } ], "source_url": "https://data.cambridgema.gov/resource/whpw-w55x.json?%24select=id%2Cpermit_type%2Cstatus%2Capplicant_submit_date%2Cissue_date%2Cfull_address%2Clatitude%2Clongitude%2Cmbl%2Cbuilding_use%2Csolar_energy_type%2Cwork_description%2Ctotal_cost%2Cfirm_name%2Csolar_system_size%2Cphotovoltaic_panel_count%2Cwatt_capacity%2Cinverter_count%2Cinverter_type%2Cinverter_make_and_model%2Cmount_type%2Cbattery_storage_capacity&%24where=issue_date+%3E%3D+%272025-01-01T00%3A00%3A00%27&%24order=issue_date+DESC%2C+id&%24limit=5" } ```