---
type: "firecrawl-provider"
description: "Building permits issued by the City of Miami Building Department since 2014 (about 236,000 permits, reloaded daily), from the Building Permits Since 2014 layer the City publishes on its ArcGIS Hub open data site, datahub-miamigis.opendata.arcgis.com. Search permits by street address, contractor, permit type or work item, status, Miami-Dade folio, application number, issue or application date, status-change date (to poll for new and changed permits) and total cost; read one permit with every published column; rank contractors by permits issued and total cost for a date window. Records carry address, coordinates, folio, cost, square feet and the contractor company; the City publishes no owner, site ZIP, contractor licence number or expiry date. Licensed CC BY 4.0: every response and record carries the licence and the City of Miami attribution."
use_when: "Building permits issued by the City of Miami Building Department since 2014 (about 236,000 permits, reloaded daily), from the Building Permits Since 2014 layer the City publishes on its ArcGIS Hub open data site, datahub-miamigis.opendata.arcgis.com. Search permits by street address, contractor, permit type or work item, status, Miami-Dade folio, application number, issue or application date, status-change date (to poll for new and changed permits) and total cost; read one permit with every published column; rank contractors by permits issued and total cost for a date window. Records carry address, coordinates, folio, cost, square feet and the contractor company; the City publishes no owner, site ZIP, contractor licence number or expiry date. Licensed CC BY 4.0: every response and record carries the licence and the City of Miami attribution."
categories: "Real estate"
capabilities: 3
credits_per_call: 5
---
# City of Miami Open Data: building permits on Firecrawl Alexandria

Building permits issued by the City of Miami Building Department since 2014 (about 236,000 permits, reloaded daily), from the Building Permits Since 2014 layer the City publishes on its ArcGIS Hub open data site, datahub-miamigis.opendata.arcgis.com. Search permits by street address, contractor, permit type or work item, status, Miami-Dade folio, application number, issue or application date, status-change date (to poll for new and changed permits) and total cost; read one permit with every published column; rank contractors by permits issued and total cost for a date window. Records carry address, coordinates, folio, cost, square feet and the contractor company; the City publishes no owner, site ZIP, contractor licence number or expiry date. Licensed CC BY 4.0: every response and record carries the licence and the City of Miami attribution.

- Categories: Real estate
- Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate)
- Provider key: `datahub-miamigis-opendata-arcgis-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/datahub-miamigis-opendata-arcgis-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/openapi.json)

## Capabilities

- [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/contractor_activity): Rank the contractor companies named on City of Miami permits issued in a date window by permit count, then total cost, in one grouped ArcGIS statistics request. Permit type words narrow it (roof, electrical, new construction, residential). Names are grouped after trimming and upper-casing; spellings that differ otherwise (punctuation, doubled spaces) stay separate rows. Each row links to that contractor's permits. A window with no named contractor is a successful result with count 0.
- [Get permit](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/get_permit): Read one City of Miami building permit by permit number: the normalized permit record plus raw, every column as published (application and process numbers, plan created and accepted dates, plan review days, Miami 21 zone, private provider flag, required and issued certificate, final inspection, addition and remodeling cost and square feet, contractor city and ZIP). The contractor street address is withheld. An unknown permit is not_found.
- [Search permits](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/search_permits): Search City of Miami building permits (Building Department, 2014 onward) by street address, contractor company, permit type or work item, status, application or process number, Miami-Dade folio, issue date, application date, status-change date and minimum total cost. Newest issued first by default, or newest application, most recent status change or largest cost. Each record has the shared permit fields (permit number, scope of work, residential or commercial, work items, status and reason, applied, issued and finalized dates, address, coordinates, folio, cost, square feet, contractor company), the process number and status date, source_url and licence. An empty page is a valid result.

## 1. Choose this provider when

Building permits issued by the City of Miami Building Department since 2014 (about 236,000 permits, reloaded daily), from the Building Permits Since 2014 layer the City publishes on its ArcGIS Hub open data site, datahub-miamigis.opendata.arcgis.com. Search permits by street address, contractor, permit type or work item, status, Miami-Dade folio, application number, issue or application date, status-change date (to poll for new and changed permits) and total cost; read one permit with every published column; rank contractors by permits issued and total cost for a date window. Records carry address, coordinates, folio, cost, square feet and the contractor company; the City publishes no owner, site ZIP, contractor licence number or expiry date. Licensed CC BY 4.0: every response and record carries the licence and the City of Miami attribution.

## 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": "datahub-miamigis-opendata-arcgis-com",
  "capability": "building-permits/contractor_activity",
  "options": {
    "issued_since": "2025-01-01",
    "issued_until": "2025-12-31",
    "limit": 10
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `cursor` (string): next_cursor from the previous page. Pattern: ^[0-9]+$. Example: `<cursor>`
- `issued_since` (string, required): First issue day, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `issued_until` (string): Last issue day, inclusive (YYYY-MM-DD); open-ended when omitted. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_until>`
- `limit` (number): Contractors per page. Example: `25`
- `permit_type` (string): Only permits whose scope of work, property type or work items contain these words (roof, electrical, new construction, residential). Example: `<permit_type>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "datahub-miamigis-opendata-arcgis-com",
    capability: "building-permits/contractor_activity",
    options: {
      issued_since: "2025-01-01",
      issued_until: "2025-12-31",
      limit: 10,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "datahub-miamigis-opendata-arcgis-com",
  "capability": "building-permits/contractor_activity",
  "options": {
    "issued_since": "2025-01-01",
    "issued_until": "2025-12-31",
    "limit": 10
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "datahub-miamigis-opendata-arcgis-com",
    "capability": "building-permits/contractor_activity",
    "options": {
      "issued_since": "2025-01-01",
      "issued_until": "2025-12-31",
      "limit": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'datahub-miamigis-opendata-arcgis-com/building-permits/contractor_activity' \
  --options '{"issued_since":"2025-01-01","issued_until":"2025-12-31","limit":10}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "datahub-miamigis-opendata-arcgis-com",
  "capability": "building-permits/contractor_activity",
  "options": {
    "issued_since": "2025-01-01",
    "issued_until": "2025-12-31",
    "limit": 10
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "datahub-miamigis-opendata-arcgis-com",
  "capability": "building-permits/contractor_activity",
  "options": {
    "issued_since": "2025-01-01",
    "issued_until": "2025-12-31",
    "limit": 10
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "count": 10,
  "dataset": {
    "id": "1d6fc60b087c4bcaa22345f429a2ec5a_0",
    "name": "Building Permits Since 2014",
    "portal": "datahub-miamigis.opendata.arcgis.com",
    "updated_at": "2026-10-27T13:02:23Z",
    "url": "https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "Miami-Dade County",
    "name": "City of Miami",
    "state": "FL"
  },
  "license": {
    "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
    "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793151151800,
  "records": [
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "POWER DESIGN INC",
      "permits": 187,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27POWER+DESIGN+INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 97084111.8
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-26",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "INFINITY AT YOUR SERVICE LLC",
      "permits": 138,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27INFINITY+AT+YOUR+SERVICE+LLC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 3966666
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "SUNSHINE ELECTRICAL CONTRACTORS CORP",
      "permits": 129,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27SUNSHINE+ELECTRICAL+CONTRACTORS+CORP%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 2707332.2
    },
    {
      "first_issued_date": "2025-03-17",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "MESA ELECTRIC SYSTEMS  CORP.",
      "permits": 113,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27MESA+ELECTRIC+SYSTEMS++CORP.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 1620394
    },
    {
      "first_issued_date": "2025-01-15",
      "last_issued_date": "2025-12-10",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "DIANGO GROUP  INC",
      "permits": 112,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27DIANGO+GROUP++INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 10384301
    },
    {
      "first_issued_date": "2025-01-14",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "THYSSENKRUPP ELEVATOR CORP  MIAMI/DBA TK ELEVATOR CORP MIAMI",
      "permits": 108,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27THYSSENKRUPP+ELEVATOR+CORP++MIAMI%2FDBA+TK+ELEVATOR+CORP+MIAMI%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 25642879
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-10-07",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "MAR B PLUMBING CORP.",
      "permits": 102,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27MAR+B+PLUMBING+CORP.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 363200
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "CONVERGINT TECHNOLOGIES LLC",
      "permits": 97,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27CONVERGINT+TECHNOLOGIES+LLC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 2867761
    },
    {
      "first_issued_date": "2025-01-06",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "FRIENDLY JOHN INC",
      "permits": 85,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27FRIENDLY+JOHN+INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 320338.6
    },
    {
      "first_issued_date": "2025-01-09",
      "last_issued_date": "2025-12-23",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "C.G. ELECTRICAL & CONSULTING SERVICES INC.",
      "permits": 83,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27C.G.+ELECTRICAL+%26+CONSULTING+SERVICES+INC.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 15259390.06
    }
  ],
  "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=CompanyName+IS+NOT+NULL+AND+UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3C%3E+%27%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outStatistics=%5B%7B%22statisticType%22%3A%22count%22%2C%22onStatisticField%22%3A%22ObjectId%22%2C%22outStatisticFieldName%22%3A%22permits%22%7D%2C%7B%22statisticType%22%3A%22sum%22%2C%22onStatisticField%22%3A%22CAST%28TotalCost+AS+FLOAT%29%22%2C%22outStatisticFieldName%22%3A%22valuation%22%7D%2C%7B%22statisticType%22%3A%22min%22%2C%22onStatisticField%22%3A%22IssuedDate%22%2C%22outStatisticFieldName%22%3A%22first_issued%22%7D%2C%7B%22statisticType%22%3A%22max%22%2C%22onStatisticField%22%3A%22IssuedDate%22%2C%22outStatisticFieldName%22%3A%22last_issued%22%7D%5D&groupByFieldsForStatistics=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29&orderByFields=COUNT%28ObjectId%29+DESC%2C+SUM%28CAST%28TotalCost+AS+FLOAT%29%29+DESC%2C+UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+ASC&resultOffset=0&resultRecordCount=10&f=json"
}
```

## 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 contractor companies named on City of Miami permits issued in a date window by permit count, then total cost, in one grouped ArcGIS statistics request. Permit type words narrow it (roof, electrical, new construction, residential). Names are grouped after trimming and upper-casing; spellings that differ otherwise (punctuation, doubled spaces) stay separate rows. Each row links to that contractor's permits. A window with no named contractor is a successful result with count 0.
- Instructions: Who is most active in Miami for a kind of work or period, or contractor market share; then search_permits with contractor for one company's permits.
- Cost: 5 credits per call
- Capability file: [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/contractor_activity)

Accepted options:
- `cursor` (string): next_cursor from the previous page. Pattern: ^[0-9]+$. Example: `<cursor>`
- `issued_since` (string, required): First issue day, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `issued_until` (string): Last issue day, inclusive (YYYY-MM-DD); open-ended when omitted. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_until>`
- `limit` (number): Contractors per page. Example: `25`
- `permit_type` (string): Only permits whose scope of work, property type or work items contain these words (roof, electrical, new construction, residential). Example: `<permit_type>`

Response schema example:
```json
{
  "count": 10,
  "dataset": {
    "id": "1d6fc60b087c4bcaa22345f429a2ec5a_0",
    "name": "Building Permits Since 2014",
    "portal": "datahub-miamigis.opendata.arcgis.com",
    "updated_at": "2026-10-27T13:02:23Z",
    "url": "https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "Miami-Dade County",
    "name": "City of Miami",
    "state": "FL"
  },
  "license": {
    "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
    "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793151151800,
  "records": [
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "POWER DESIGN INC",
      "permits": 187,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27POWER+DESIGN+INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 97084111.8
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-26",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "INFINITY AT YOUR SERVICE LLC",
      "permits": 138,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27INFINITY+AT+YOUR+SERVICE+LLC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 3966666
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "SUNSHINE ELECTRICAL CONTRACTORS CORP",
      "permits": 129,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27SUNSHINE+ELECTRICAL+CONTRACTORS+CORP%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 2707332.2
    },
    {
      "first_issued_date": "2025-03-17",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "MESA ELECTRIC SYSTEMS  CORP.",
      "permits": 113,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27MESA+ELECTRIC+SYSTEMS++CORP.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 1620394
    },
    {
      "first_issued_date": "2025-01-15",
      "last_issued_date": "2025-12-10",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "DIANGO GROUP  INC",
      "permits": 112,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27DIANGO+GROUP++INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 10384301
    },
    {
      "first_issued_date": "2025-01-14",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "THYSSENKRUPP ELEVATOR CORP  MIAMI/DBA TK ELEVATOR CORP MIAMI",
      "permits": 108,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27THYSSENKRUPP+ELEVATOR+CORP++MIAMI%2FDBA+TK+ELEVATOR+CORP+MIAMI%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 25642879
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-10-07",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "MAR B PLUMBING CORP.",
      "permits": 102,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27MAR+B+PLUMBING+CORP.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 363200
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "CONVERGINT TECHNOLOGIES LLC",
      "permits": 97,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27CONVERGINT+TECHNOLOGIES+LLC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 2867761
    },
    {
      "first_issued_date": "2025-01-06",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "FRIENDLY JOHN INC",
      "permits": 85,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27FRIENDLY+JOHN+INC%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 320338.6
    },
    {
      "first_issued_date": "2025-01-09",
      "last_issued_date": "2025-12-23",
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "name": "C.G. ELECTRICAL & CONSULTING SERVICES INC.",
      "permits": 83,
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3D+%27C.G.+ELECTRICAL+%26+CONSULTING+SERVICES+INC.%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=IssuedDate+DESC%2C+PermitNumber+ASC&returnGeometry=false&f=json",
      "total_valuation_usd": 15259390.06
    }
  ],
  "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=CompanyName+IS+NOT+NULL+AND+UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+%3C%3E+%27%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272025-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outStatistics=%5B%7B%22statisticType%22%3A%22count%22%2C%22onStatisticField%22%3A%22ObjectId%22%2C%22outStatisticFieldName%22%3A%22permits%22%7D%2C%7B%22statisticType%22%3A%22sum%22%2C%22onStatisticField%22%3A%22CAST%28TotalCost+AS+FLOAT%29%22%2C%22outStatisticFieldName%22%3A%22valuation%22%7D%2C%7B%22statisticType%22%3A%22min%22%2C%22onStatisticField%22%3A%22IssuedDate%22%2C%22outStatisticFieldName%22%3A%22first_issued%22%7D%2C%7B%22statisticType%22%3A%22max%22%2C%22onStatisticField%22%3A%22IssuedDate%22%2C%22outStatisticFieldName%22%3A%22last_issued%22%7D%5D&groupByFieldsForStatistics=UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29&orderByFields=COUNT%28ObjectId%29+DESC%2C+SUM%28CAST%28TotalCost+AS+FLOAT%29%29+DESC%2C+UPPER%28TRIM%28BOTH+%27+%27+FROM+CompanyName%29%29+ASC&resultOffset=0&resultRecordCount=10&f=json"
}
```

### Get permit

- Capability: `building-permits/get_permit`
- Description: Read one City of Miami building permit by permit number: the normalized permit record plus raw, every column as published (application and process numbers, plan created and accepted dates, plan review days, Miami 21 zone, private provider flag, required and issued certificate, final inspection, addition and remodeling cost and square feet, contractor city and ZIP). The contractor street address is withheld. An unknown permit is not_found.
- Instructions: A permit number from search_permits or a City document, when every published detail is needed. For an application or process number (BD26009977, BD26009977001), use search_permits with application_number.
- Cost: 5 credits per call
- Capability file: [Get permit](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/get_permit)

Accepted options:
- `permit_number` (string, required): City of Miami permit number, case-insensitive (BD21013681001B001). Pattern: ^[A-Za-z]{2}[0-9]{8}[0-9A-Za-z]{0,12}$. Example: `<permit_number>`

Response schema example:
```json
{
  "address": "2900 BISCAYNE BLVD",
  "applied_date": "2021-06-17",
  "city": "Miami",
  "completed_date": "2025-09-08",
  "contractors": [
    {
      "company": "STILES MCHUGH LLC",
      "license_number": null,
      "name": null,
      "phone": null,
      "role": "contractor"
    }
  ],
  "description": null,
  "expires_date": null,
  "housing_units": null,
  "issued_date": "2022-12-30",
  "latitude": 25.8044928934784,
  "license": {
    "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
    "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "longitude": -80.1895248448728,
  "observed_at_ms": 1793151150865,
  "parcel_id": "0132300131220",
  "permit_class": "Commercial",
  "permit_number": "BD21013681001B001",
  "permit_type": "NEW CONSTRUCTION",
  "process_number": "BD21013681001",
  "raw": {
    "AdditionSQFT": 942759,
    "ApplicationNumber": "BD21013681",
    "BuildingFinalLastInspDate": 1757323980000,
    "BuildingFinalLastInspResult": null,
    "BuildingPermitStatusDescription": "Final",
    "BuildingPermitStatusReasonDescription": "All Inspections are finalized.",
    "Certificatecode": "CO",
    "Certificatedate": "2025-09-08 09:33:00",
    "CompanyCity": "FORT LAUDERDALE ",
    "CompanyName": "STILES MCHUGH LLC",
    "CompanyZip": 33301,
    "DaysInCity": null,
    "DaysInCityNumeric": null,
    "DeliveryAddress": "2900 BISCAYNE BLVD",
    "FirstSubmissionDate": null,
    "FolioNumber": 132300131220,
    "ID": 103449,
    "IsPermitFinal": "YES",
    "IsPrivateProvider": "True",
    "IssuedDate": 1672404960000,
    "Latitude": 25.8044928934784,
    "Longitude": -80.1895248448728,
    "Miami21Zone": "T6-36A-O",
    "NewAdditionCost": "164982826",
    "ObjectId": 103639,
    "PermitNumber": "BD21013681001B001",
    "PlanAcceptedDate": 1632819840000,
    "PlanCreatedDate": 1623951240000,
    "ProcessNumber": "BD21013681001",
    "PropertyType": "Commercial",
    "RemSQFT": 0,
    "RemodelingCost": "0",
    "RequiredCertificate": "CO",
    "ScopeofWork": "NEW CONSTRUCTION",
    "Statusdate": 1757323980000,
    "TotalCost": "164982826",
    "TotalDaysInPlanReview": "458 Day(s) 3 Hour(s) 52 Minute(s) ",
    "TotalDaysInPlanReviewNumeric": 458,
    "TotalSQFT": 942759,
    "WorkItems": "MULTI-FAMILY (CONDO)|GENERAL COMMERCIAL"
  },
  "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681001B001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
  "square_feet": 942759,
  "state": "FL",
  "status": "Final",
  "status_date": "2025-09-08",
  "status_reason": "All Inspections are finalized.",
  "valuation_usd": 164982826,
  "work_class": "MULTI-FAMILY (CONDO)|GENERAL COMMERCIAL",
  "zip": null
}
```

### Search permits

- Capability: `building-permits/search_permits`
- Description: Search City of Miami building permits (Building Department, 2014 onward) by street address, contractor company, permit type or work item, status, application or process number, Miami-Dade folio, issue date, application date, status-change date and minimum total cost. Newest issued first by default, or newest application, most recent status change or largest cost. Each record has the shared permit fields (permit number, scope of work, residential or commercial, work items, status and reason, applied, issued and finalized dates, address, coordinates, folio, cost, square feet, contractor company), the process number and status date, source_url and licence. An empty page is a valid result.
- Instructions: Permits at a Miami address or folio, one contractor's Miami permits, new construction or roofing activity, or polling for what changed: pass updated_since (the last day you checked) with sort updated_desc. Addresses match in the City's spelling (1341 NW 55 ST); forms such as 1341 Northwest 55th Street, Miami, FL are converted. Use get_permit for every published column of one permit and contractor_activity to rank companies.
- Cost: 5 credits per call
- Capability file: [Search permits](https://firecrawl.dev/alexandria/agents/providers/datahub-miamigis-opendata-arcgis-com/building-permits/search_permits)

Accepted options:
- `address` (string): Street address or part of it, matched case-insensitively as a substring of the site address. It is converted to the City's spelling first: ordinals become numbers, street types and directions are abbreviated (Avenue to AV, Northwest to NW), and unit, city, state and ZIP are dropped, so the match covers the whole building. Example: `<address>`
- `application_number` (string): City application number (BD26009977) or process number (BD26009977001): every permit filed under it, such as the building, electrical, plumbing and mechanical permits of one job. Pattern: ^[A-Za-z]{2}[0-9]{8}([0-9]{3})?$. Example: `<application_number>`
- `applied_since` (string): Only permits whose application was created (PlanCreatedDate) on or after this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<applied_since>`
- `applied_until` (string): Only permits whose application was created on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<applied_until>`
- `contractor` (string): Case-insensitive substring of the contractor company name (power design, roofing). Example: `<contractor>`
- `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. Example: `<cursor>`
- `issued_since` (string): Only permits issued on or after this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `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: `<issued_until>`
- `limit` (number): Records per page. Example: `25`
- `min_valuation` (number): Only permits whose total cost is at least this many USD. Example: `10`
- `parcel_id` (string): Miami-Dade folio number, 13 digits with or without dashes (0141220010740 or 01-4122-001-0740). Exact match. Pattern: ^[0-9][0-9 .-]{10,15}[0-9]$. Example: `<parcel_id>`
- `permit_type` (string): Case-insensitive substring over scope of work (new construction, roofing, electrical, demolition), property type (residential, commercial) and work items (single family residence, pool, flat roof). Example: `<permit_type>`
- `sort` (string): issued_desc: newest issue date first; applied_desc: newest application first; updated_desc: most recent status change first; valuation_desc: largest total cost first. Example: `issued_desc`
- `status` (string): Case-insensitive substring over status (Active, Final, Expired, Revoked, Hold) and its reason (stop work order). Example: `<status>`
- `updated_since` (string): YYYY-MM-DD or RFC 3339 timestamp: only permits whose status date is on or after that day. The status date moves when a permit is issued, finalized, expires, is revoked, put on hold or reactivated; edits that keep the status do not move it. The time part is ignored because the layer records Miami local times. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}([Tt ][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2}))?$. Example: `<updated_since>`

Response schema example:
```json
{
  "count": 5,
  "dataset": {
    "id": "1d6fc60b087c4bcaa22345f429a2ec5a_0",
    "name": "Building Permits Since 2014",
    "portal": "datahub-miamigis.opendata.arcgis.com",
    "updated_at": "2026-10-27T13:02:23Z",
    "url": "https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014"
  },
  "jurisdiction": {
    "county": "Miami-Dade County",
    "name": "City of Miami",
    "state": "FL"
  },
  "license": {
    "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
    "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "next_cursor": "5",
  "observed_at_ms": 1793151146781,
  "records": [
    {
      "address": "2900 BISCAYNE BLVD",
      "applied_date": "2021-06-17",
      "city": "Miami",
      "completed_date": "2025-09-08",
      "contractors": [
        {
          "company": "STILES MCHUGH LLC",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": null,
      "expires_date": null,
      "housing_units": null,
      "issued_date": "2022-12-30",
      "latitude": 25.8044928934784,
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "longitude": -80.1895248448728,
      "parcel_id": "0132300131220",
      "permit_class": "Commercial",
      "permit_number": "BD21013681001B001",
      "permit_type": "NEW CONSTRUCTION",
      "process_number": "BD21013681001",
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681001B001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
      "square_feet": 942759,
      "state": "FL",
      "status": "Final",
      "status_date": "2025-09-08",
      "status_reason": "All Inspections are finalized.",
      "valuation_usd": 164982826,
      "work_class": "MULTI-FAMILY (CONDO)|GENERAL COMMERCIAL",
      "zip": null
    },
    {
      "address": "2900 BISCAYNE BLVD",
      "applied_date": "2021-06-17",
      "city": "Miami",
      "completed_date": "2025-09-04",
      "contractors": [
        {
          "company": "POWER DESIGN INC",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": null,
      "expires_date": null,
      "housing_units": null,
      "issued_date": "2023-01-18",
      "latitude": 25.8044928934784,
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "longitude": -80.1895248448728,
      "parcel_id": "0132300131220",
      "permit_class": "Commercial",
      "permit_number": "BD21013681001E001",
      "permit_type": "NEW CONSTRUCTION",
      "process_number": "BD21013681001",
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681001E001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
      "square_feet": 942759,
      "state": "FL",
      "status": "Final",
      "status_date": "2025-09-04",
      "status_reason": "All Inspections are finalized.",
      "valuation_usd": 15555000,
      "work_class": "A/C  CENTRAL|CLOTHES WASHERS|DISH WASHER|DRYERS|EXHAUST / BATHROOM FAN|GARBAGE DISPOSAL|LIGHT SOCKET|MOTOR|NEW METER|ROUGH WIRING OUTLETS|RANGE|REFRIGERATORS DOMESTIC|NEW SERVICE|SUB-FEEDS|SERVICE &gt;600 AMPS AND 240V|WATER HEATER / BOILER",
      "zip": null
    },
    {
      "address": "2900 BISCAYNE BLVD",
      "applied_date": "2021-06-17",
      "city": "Miami",
      "completed_date": "2025-02-04",
      "contractors": [
        {
          "company": "Professional Plumbing Corporation",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": null,
      "expires_date": null,
      "housing_units": null,
      "issued_date": "2023-01-12",
      "latitude": 25.8044928934784,
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "longitude": -80.1895248448728,
      "parcel_id": "0132300131220",
      "permit_class": "Commercial",
      "permit_number": "BD21013681001P001",
      "permit_type": "NEW CONSTRUCTION",
      "process_number": "BD21013681001",
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681001P001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
      "square_feet": 942759,
      "state": "FL",
      "status": "Final",
      "status_date": "2025-02-04",
      "status_reason": "All Inspections are finalized.",
      "valuation_usd": 7843879.47,
      "work_class": "ALL TYPES OF AIR CONDITIONER DRAINS|AREA DRAIN INLET              |AREA DRAIN/CATCH BASIN/INLET  |ROUGHING FIXTURE: MISCELLANEOUS SINK|SETTING FIXTURE: MISCELLANEOUS SINK|ROUGHING FIXTURE: BATHTUB|SETTING FIXTURE: BATHTUB|ROUGHING FIXTURE: BIDET|SETTING FIXTURE: BIDET|ROUGHING FIXTURE: DISHWASHER|SETTING FIXTURE: DISHWASHER|ROUGHING FIXTURE: DISPOSAL|SETTING FIXTURE: DISPOSAL|ROUGHING FIXTURE: DRINKING FOUNTAIN|SETTING FIXTURE: DRINKING FOUNTAIN|ROUGHING FIXTURE: ELECTRIC WATER HEATER|SETTING FIXTURE: ELECTRIC WATER HEATER|ROUGHING FIXTURE: FLOOR DRAIN|SETTING FIXTURE: FLOOR DRAIN|FRENCH DRAIN     |HOSE BIB                      |ROUGHING FIXTURE: ICE MAKER|SETTING FIXTURE: ICE MAKER|ROUGHING FIXTURE: INDIRECT WASTE|SETTING FIXTURE: INDIRECT WASTE|INTERCEPTORS &amp; SEPARATORS     |ROUGHING FIXTURE: KITCHEN SINK|SETTING FIXTURE: KITCHEN SINK|ROUGHING FIXTURE: LAUNDRY TRAY / WASHER|SETTING FIXTURE: LAUNDRY TRAY / WASHER|ROUGHING FIXTURE: LAVATORY|SETTING FIXTURE: LAVATORY|MISCELLANEOUS SIPHON-BREAKERS               |ROOF DRAIN / ROUGH &amp; INLET      |ROUGHING IN FOR ROOF DRAIN    |ROUGHING FIXTURE: SHOWER|SETTING FIXTURE: SHOWER|STORM SEWER |ROUGHING FIXTURE: TOILET / WATER CLOSET|SETTING FIXTURE: TOILET / WATER CLOSET|ROUGHING FIXTURE: URINAL|SETTING FIXTURE: URINAL|BACKFLOW &gt; 2\"\"|DOMESTIC PUMP|COMMERCIAL BUILDING CONNECTION OUTSIDE",
      "zip": null
    },
    {
      "address": "2900 BISCAYNE BLVD",
      "applied_date": "2023-01-24",
      "city": "Miami",
      "completed_date": "2024-11-27",
      "contractors": [
        {
          "company": "ALL AMERICAN WINDOWS AND DOORS  INCORPORATED",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": null,
      "expires_date": null,
      "housing_units": null,
      "issued_date": "2023-08-07",
      "latitude": 25.8044928934784,
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "longitude": -80.1895248448728,
      "parcel_id": "0132300131220",
      "permit_class": "Commercial",
      "permit_number": "BD21013681007B001",
      "permit_type": "NEW CONSTRUCTION",
      "process_number": "BD21013681007",
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681007B001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
      "square_feet": 0,
      "state": "FL",
      "status": "Final",
      "status_date": "2024-11-27",
      "status_reason": "All Inspections are finalized.",
      "valuation_usd": 6656800,
      "work_class": "REGULAR EXTERIOR:DOORS",
      "zip": null
    },
    {
      "address": "2900 BISCAYNE BLVD",
      "applied_date": "2021-06-17",
      "city": "Miami",
      "completed_date": "2025-04-04",
      "contractors": [
        {
          "company": "CAILIS MECHANICAL CORP.",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": null,
      "expires_date": null,
      "housing_units": null,
      "issued_date": "2023-03-15",
      "latitude": 25.8044928934784,
      "license": {
        "attribution": "City of Miami, Department of Innovation and Technology, GIS Team: Building Permits Since 2014 (City of Miami Building Department), https://datahub-miamigis.opendata.arcgis.com/datasets/MiamiGIS::building-permits-since-2014",
        "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
        "url": "https://creativecommons.org/licenses/by/4.0/"
      },
      "longitude": -80.1895248448728,
      "parcel_id": "0132300131220",
      "permit_class": "Commercial",
      "permit_number": "BD21013681001MA001",
      "permit_type": "NEW CONSTRUCTION",
      "process_number": "BD21013681001",
      "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=PermitNumber+%3D+%27BD21013681001MA001%27&outFields=*&returnGeometry=false&resultRecordCount=2&f=json",
      "square_feet": 942759,
      "state": "FL",
      "status": "Final",
      "status_date": "2025-04-04",
      "status_reason": "All Inspections are finalized.",
      "valuation_usd": 5500000,
      "work_class": "COOLING TOWER|AC CENTRAL / HEATING SYSTEM|PRESSURE / PROCESS PIPING     |SHEET METAL WORK|EXHAUST VENTILATION|FIBERGLASS DUCTWORK|STATIONARY GENERATOR (MECH)|DUCTLESS MINI-SPLIT SYSTEM",
      "zip": null
    }
  ],
  "source_url": "https://services1.arcgis.com/CvuPhqcTQpZPT9qY/arcgis/rest/services/Building_Permits_Since_2014/FeatureServer/0/query?where=UPPER%28DeliveryAddress%29+LIKE+%27%252900+BISCAYNE+BLVD%25%27+ESCAPE+%27%21%27+AND+IssuedDate+%3E%3D+TIMESTAMP+%272019-01-01+00%3A00%3A00%27+AND+IssuedDate+%3C%3D+TIMESTAMP+%272025-12-31+23%3A59%3A59%27&outFields=PermitNumber%2CProcessNumber%2CScopeofWork%2CPropertyType%2CWorkItems%2CBuildingPermitStatusDescription%2CBuildingPermitStatusReasonDescription%2CPlanCreatedDate%2CIssuedDate%2CStatusdate%2CDeliveryAddress%2CLatitude%2CLongitude%2CFolioNumber%2CTotalCost%2CTotalSQFT%2CCompanyName&orderByFields=CAST%28TotalCost+AS+FLOAT%29+DESC%2C+PermitNumber+ASC&returnGeometry=false&resultOffset=0&resultRecordCount=5&f=json"
}
```
