---
type: "firecrawl-provider"
description: "City of Seattle permits from the Seattle Department of Construction and Inspections (SDCI) on data.seattle.gov, Seattle's Socrata open data portal: building, trade, electrical and land use permits (master use permits and design review, the land use decisions that precede building permits) as one normalized permit record. Search by address, ZIP, contractor, type, status or work description, filter by application, issue or decision date, value and the land use decision a building permit implements; read one permit with every published column; rank contractors by permits issued. Public Domain, refreshed nightly."
use_when: "City of Seattle permits from the Seattle Department of Construction and Inspections (SDCI) on data.seattle.gov, Seattle's Socrata open data portal: building, trade, electrical and land use permits (master use permits and design review, the land use decisions that precede building permits) as one normalized permit record. Search by address, ZIP, contractor, type, status or work description, filter by application, issue or decision date, value and the land use decision a building permit implements; read one permit with every published column; rank contractors by permits issued. Public Domain, refreshed nightly."
categories: "Real estate"
capabilities: 3
credits_per_call: 5
---
# City of Seattle Open Data: permits and land use decisions on Firecrawl Alexandria

City of Seattle permits from the Seattle Department of Construction and Inspections (SDCI) on data.seattle.gov, Seattle's Socrata open data portal: building, trade, electrical and land use permits (master use permits and design review, the land use decisions that precede building permits) as one normalized permit record. Search by address, ZIP, contractor, type, status or work description, filter by application, issue or decision date, value and the land use decision a building permit implements; read one permit with every published column; rank contractors by permits issued. Public Domain, refreshed nightly.

- Categories: Real estate
- Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate)
- Provider key: `data-seattle-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/data-seattle-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/openapi.json)

## Capabilities

- [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/building-permits/contractor_activity): Rank the contractors named on City of Seattle permits issued in a date window by permit count, then total estimated project value, in one grouped SODA request. Building permits by default; trade and electrical permits name a contractor far more often. Optional permit type words and ZIP. Contractor names are grouped case-insensitively; 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/data-seattle-gov/building-permits/get_permit): Read one City of Seattle permit by SDCI permit number: the normalized permit record plus raw, every column exactly as published (for building permits the related land use permit, parent permit, zoning, dwelling unit type, housing category and plan review day counts). The dataset is inferred from the permit number suffix unless kind is given. An unknown permit is not_found.
- [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/building-permits/search_permits): Search City of Seattle permits, newest first: building (default), trade, electrical or land use decisions. Filter by site address words, ZIP, contractor, permit type or class, status, work description, application, issue or land use decision date windows, minimum project value, and for building permits the land use permit they implement. Every record has the same shape (permit number, type, status, dates, address, coordinates, value, housing units, contractor, SDCI detail link, licence); land use records add a land_use object with the decision date. Seattle reloads the data nightly with a lag of a few days, so to monitor new permits poll applied_since, issued_since or decided_since; dataset.updated_at says when it last reloaded. An empty page is a successful result with count 0.

## 1. Choose this provider when

City of Seattle permits from the Seattle Department of Construction and Inspections (SDCI) on data.seattle.gov, Seattle's Socrata open data portal: building, trade, electrical and land use permits (master use permits and design review, the land use decisions that precede building permits) as one normalized permit record. Search by address, ZIP, contractor, type, status or work description, filter by application, issue or decision date, value and the land use decision a building permit implements; read one permit with every published column; rank contractors by permits issued. Public Domain, refreshed nightly.

## 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-seattle-gov",
  "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): The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. Example: `<cursor>`
- `issued_since` (string, required): First issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `issued_until` (string): Last issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_until>`
- `kind` (string): Which dataset to rank: building (Building Permits; contractor named on about a sixth of permits), trade or electrical (contractor named on most permits). Example: `building`
- `limit` (number): Records per page. Example: `25`
- `permit_type` (string): Only permits whose type, class or work type matches these words, for example New, Roof, Furnace, Commercial. Example: `<permit_type>`
- `zip` (string): Only permits at sites in this ZIP code. Pattern: ^[0-9]{5}$. Example: `<zip>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "data-seattle-gov",
    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": "data-seattle-gov",
  "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": "data-seattle-gov",
    "capability": "building-permits/contractor_activity",
    "options": {
      "issued_since": "2025-01-01",
      "issued_until": "2025-12-31",
      "limit": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'data-seattle-gov/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": "data-seattle-gov",
  "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": "data-seattle-gov",
  "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": "76t5-zqzr",
    "name": "Building Permits",
    "portal": "data.seattle.gov",
    "updated_at": "2026-10-27T01:15:43Z",
    "url": "https://data.seattle.gov/d/76t5-zqzr"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "King County",
    "name": "City of Seattle",
    "state": "WA"
  },
  "license": {
    "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
    "name": "Public Domain",
    "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793141562840,
  "records": [
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "VALENTINE ROOFING",
      "permits": 195,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27VALENTINE+ROOFING%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 3839623.77
    },
    {
      "first_issued_date": "2025-01-28",
      "last_issued_date": "2025-12-11",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "STATE ROOFING INC",
      "permits": 26,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27STATE+ROOFING+INC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 810438.41
    },
    {
      "first_issued_date": "2025-01-16",
      "last_issued_date": "2025-09-03",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "FLAT ROOF PROS INC",
      "permits": 8,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27FLAT+ROOF+PROS+INC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 327283.21
    },
    {
      "first_issued_date": "2025-08-20",
      "last_issued_date": "2025-11-19",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "JAMES KING ROOFING, LLC",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27JAMES+KING+ROOFING%2C+LLC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 646980
    },
    {
      "first_issued_date": "2025-01-28",
      "last_issued_date": "2025-04-30",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "JAMES KING ROOFING",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27JAMES+KING+ROOFING%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 486467
    },
    {
      "first_issued_date": "2025-01-18",
      "last_issued_date": "2025-12-02",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "FOUR SEASONS ROOF",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27FOUR+SEASONS+ROOF%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 279541
    },
    {
      "first_issued_date": "2025-03-04",
      "last_issued_date": "2025-08-27",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ALTERNATIVE ROOFING SYSTEMS INC.",
      "permits": 6,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ALTERNATIVE+ROOFING+SYSTEMS+INC.%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 1105713.5
    },
    {
      "first_issued_date": "2025-03-07",
      "last_issued_date": "2025-07-25",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ELITE OFFICE",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ELITE+OFFICE%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 451501
    },
    {
      "first_issued_date": "2025-02-20",
      "last_issued_date": "2025-04-10",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ARLETTA L VANHOOF",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ARLETTA+L+VANHOOF%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 120001
    },
    {
      "first_issued_date": "2025-04-22",
      "last_issued_date": "2025-06-23",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ROOFWORX LLC",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ROOFWORX+LLC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 67177.65
    }
  ],
  "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24select=upper%28trim%28contractorcompanyname%29%29+AS+contractor%2C+count%28*%29+AS+permits%2C+sum%28estprojectcost%29+AS+total_valuation%2C+min%28issueddate%29+AS+first_issued%2C+max%28issueddate%29+AS+last_issued&%24where=contractorcompanyname+IS+NOT+NULL+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24group=contractor&%24order=permits+DESC%2C+total_valuation+DESC+NULL+LAST%2C+contractor&%24limit=10"
}
```

## 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 named on City of Seattle permits issued in a date window by permit count, then total estimated project value, in one grouped SODA request. Building permits by default; trade and electrical permits name a contractor far more often. Optional permit type words and ZIP. Contractor names are grouped case-insensitively; 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 Seattle for a permit type, area or period; market share of contractors.
- Cost: 5 credits per call
- Capability file: [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/building-permits/contractor_activity)

Accepted options:
- `cursor` (string): The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. Example: `<cursor>`
- `issued_since` (string, required): First issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `issued_until` (string): Last issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_until>`
- `kind` (string): Which dataset to rank: building (Building Permits; contractor named on about a sixth of permits), trade or electrical (contractor named on most permits). Example: `building`
- `limit` (number): Records per page. Example: `25`
- `permit_type` (string): Only permits whose type, class or work type matches these words, for example New, Roof, Furnace, Commercial. Example: `<permit_type>`
- `zip` (string): Only permits at sites in this ZIP code. Pattern: ^[0-9]{5}$. Example: `<zip>`

Response schema example:
```json
{
  "count": 10,
  "dataset": {
    "id": "76t5-zqzr",
    "name": "Building Permits",
    "portal": "data.seattle.gov",
    "updated_at": "2026-10-27T01:15:43Z",
    "url": "https://data.seattle.gov/d/76t5-zqzr"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "King County",
    "name": "City of Seattle",
    "state": "WA"
  },
  "license": {
    "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
    "name": "Public Domain",
    "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793141562840,
  "records": [
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "VALENTINE ROOFING",
      "permits": 195,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27VALENTINE+ROOFING%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 3839623.77
    },
    {
      "first_issued_date": "2025-01-28",
      "last_issued_date": "2025-12-11",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "STATE ROOFING INC",
      "permits": 26,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27STATE+ROOFING+INC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 810438.41
    },
    {
      "first_issued_date": "2025-01-16",
      "last_issued_date": "2025-09-03",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "FLAT ROOF PROS INC",
      "permits": 8,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27FLAT+ROOF+PROS+INC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 327283.21
    },
    {
      "first_issued_date": "2025-08-20",
      "last_issued_date": "2025-11-19",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "JAMES KING ROOFING, LLC",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27JAMES+KING+ROOFING%2C+LLC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 646980
    },
    {
      "first_issued_date": "2025-01-28",
      "last_issued_date": "2025-04-30",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "JAMES KING ROOFING",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27JAMES+KING+ROOFING%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 486467
    },
    {
      "first_issued_date": "2025-01-18",
      "last_issued_date": "2025-12-02",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "FOUR SEASONS ROOF",
      "permits": 7,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27FOUR+SEASONS+ROOF%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 279541
    },
    {
      "first_issued_date": "2025-03-04",
      "last_issued_date": "2025-08-27",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ALTERNATIVE ROOFING SYSTEMS INC.",
      "permits": 6,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ALTERNATIVE+ROOFING+SYSTEMS+INC.%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 1105713.5
    },
    {
      "first_issued_date": "2025-03-07",
      "last_issued_date": "2025-07-25",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ELITE OFFICE",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ELITE+OFFICE%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 451501
    },
    {
      "first_issued_date": "2025-02-20",
      "last_issued_date": "2025-04-10",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ARLETTA L VANHOOF",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ARLETTA+L+VANHOOF%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 120001
    },
    {
      "first_issued_date": "2025-04-22",
      "last_issued_date": "2025-06-23",
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "name": "ROOFWORX LLC",
      "permits": 5,
      "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28trim%28contractorcompanyname%29%29+%3D+%27ROOFWORX+LLC%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid",
      "total_valuation_usd": 67177.65
    }
  ],
  "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24select=upper%28trim%28contractorcompanyname%29%29+AS+contractor%2C+count%28*%29+AS+permits%2C+sum%28estprojectcost%29+AS+total_valuation%2C+min%28issueddate%29+AS+first_issued%2C+max%28issueddate%29+AS+last_issued&%24where=contractorcompanyname+IS+NOT+NULL+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%24group=contractor&%24order=permits+DESC%2C+total_valuation+DESC+NULL+LAST%2C+contractor&%24limit=10"
}
```

### Get permit

- Capability: `building-permits/get_permit`
- Description: Read one City of Seattle permit by SDCI permit number: the normalized permit record plus raw, every column exactly as published (for building permits the related land use permit, parent permit, zoning, dwelling unit type, housing category and plan review day counts). The dataset is inferred from the permit number suffix unless kind is given. An unknown permit is not_found.
- Instructions: A permit number from search_permits, an SDCI link or a document, when every published detail is needed.
- Cost: 5 credits per call
- Capability file: [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/building-permits/get_permit)

Accepted options:
- `kind` (string): Dataset to look in. Optional: inferred from the permit number suffix (EL electrical; LU and EG land use; FR, RF, ME, CY, BP, SB and FS trade; anything else building). Example: `building`
- `permit_number` (string, required): SDCI permit number, for example 6545059-CN (building), 7163476-EL (electrical), 7168300-FS (trade) or 3044493-LU (land use). Pattern: ^[0-9]{7}-[A-Za-z]{2}(-[0-9]{3})?$. Example: `<permit_number>`

Response schema example:
```json
{
  "address": "400 BROAD ST",
  "applied_date": "2016-11-09",
  "city": "SEATTLE",
  "completed_date": "2019-04-26",
  "contractors": [
    {
      "company": "SPACE NEEDLE LLC",
      "license_number": null,
      "name": null,
      "phone": null,
      "role": "contractor"
    }
  ],
  "dataset": {
    "id": "76t5-zqzr",
    "name": "Building Permits",
    "portal": "data.seattle.gov",
    "updated_at": "2026-10-27T01:15:43Z",
    "url": "https://data.seattle.gov/d/76t5-zqzr"
  },
  "description": "Construct substantial alterations to the Space Needle Occupy per plan. (See #6506865 for tower seismic upgrades). Same as original.",
  "expires_date": null,
  "housing_units": 0,
  "issued_date": "2017-07-26",
  "jurisdiction": {
    "county": "King County",
    "name": "City of Seattle",
    "state": "WA"
  },
  "land_use": null,
  "latitude": 47.62049863,
  "license": {
    "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
    "name": "Public Domain",
    "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
  },
  "longitude": -122.34931591,
  "observed_at_ms": 1793141559650,
  "parcel_id": null,
  "permit_class": "Commercial",
  "permit_number": "6545059-CN",
  "permit_type": "Building",
  "raw": {
    "applieddate": "2016-11-09T00:00:00.000",
    "completeddate": "2019-04-26T00:00:00.000",
    "contractorcompanyname": "SPACE NEEDLE LLC",
    "daysoutcorrections": "0",
    "dependentbuilding": "0",
    "description": "Construct substantial alterations to the Space Needle  Occupy per plan. (See #6506865 for tower seismic upgrades). Same as original.",
    "estprojectcost": "42000000.0000",
    "housingcategory": "Commercial Add/Alt",
    "housingunits": "0.0",
    "housingunitsadded": "0.0",
    "housingunitsremoved": "0.0",
    "issueddate": "2017-07-26T00:00:00.000",
    "latitude": "47.62049863",
    "link": {
      "url": "https://services.seattle.gov/portal/customize/LinkToRecord.aspx?altId=6545059-CN"
    },
    "location1": {
      "latitude": "47.62049863",
      "longitude": "-122.34931591"
    },
    "longitude": "-122.34931591",
    "numberreviewcycles": "0",
    "originaladdress1": "400 BROAD ST",
    "originalcity": "SEATTLE",
    "originalstate": "WA",
    "originalzip": "98109",
    "permitclass": "Commercial",
    "permitclassmapped": "Non-Residential",
    "permitnum": "6545059-CN",
    "permittypedesc": "Addition/Alteration",
    "permittypemapped": "Building",
    "statuscurrent": "Completed"
  },
  "source_url": "https://services.seattle.gov/portal/customize/LinkToRecord.aspx?altId=6545059-CN",
  "square_feet": null,
  "state": "WA",
  "status": "Completed",
  "valuation_usd": 42000000,
  "work_class": "Addition/Alteration",
  "zip": "98109"
}
```

### Search permits

- Capability: `building-permits/search_permits`
- Description: Search City of Seattle permits, newest first: building (default), trade, electrical or land use decisions. Filter by site address words, ZIP, contractor, permit type or class, status, work description, application, issue or land use decision date windows, minimum project value, and for building permits the land use permit they implement. Every record has the same shape (permit number, type, status, dates, address, coordinates, value, housing units, contractor, SDCI detail link, licence); land use records add a land_use object with the decision date. Seattle reloads the data nightly with a lag of a few days, so to monitor new permits poll applied_since, issued_since or decided_since; dataset.updated_at says when it last reloaded. An empty page is a successful result with count 0.
- Instructions: Permit history at an address, a contractor's jobs, new permits or land use decisions since a date, large projects above a value. For one permit's full row use get_permit; for contractor rankings use contractor_activity.
- Cost: 5 credits per call
- Capability file: [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-seattle-gov/building-permits/search_permits)

Accepted options:
- `address` (string): Site address words, case-insensitive, matched in order as a substring: 400 Broad St, 1959 NE Pacific. Use Seattle's abbreviations (ST, AVE, NE). Example: `<address>`
- `applied_since` (string): First application date, inclusive (YYYY-MM-DD). Poll for new applications with this; without issue-date filters the default sort becomes applied_desc. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<applied_since>`
- `applied_until` (string): Last application date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<applied_until>`
- `contractor` (string): Contractor company words, case-insensitive substring, for example Greenwood Heating. Example: `<contractor>`
- `cursor` (string): The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. Example: `<cursor>`
- `decided_since` (string): First land use decision date, inclusive (YYYY-MM-DD). Kind land_use only; the default sort becomes decided_desc. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<decided_since>`
- `decided_until` (string): Last land use decision date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<decided_until>`
- `description` (string): Words matched in order against the work description, for example ADU, solar, heat pump, demolish. Example: `<description>`
- `issued_since` (string): First issue date, inclusive (YYYY-MM-DD). Poll for newly issued permits with this and sort issued_desc. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_since>`
- `issued_until` (string): Last issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<issued_until>`
- `kind` (string): Which SDCI dataset: building (Building Permits 76t5-zqzr: construction, additions, demolition, grading, roofing, shoreline and critical-area exemptions), trade (Trade Permits c87v-5hwh: mechanical, furnace, refrigeration, elevator, boiler, sign and fire sprinkler), electrical (Electrical Permits c4tj-daue) or land_use (Land Use Permits ht3q-kdvx: master use permits, design review and early design guidance, the land use decisions that precede building permits). Example: `building`
- `limit` (number): Records per page. Example: `25`
- `min_valuation` (number): Only permits whose estimated project cost is at least this many US dollars. Example: `10`
- `permit_type` (string): Words matched against the permit type, class and work type, for example New, Demolition, Multifamily, Fire Sprinkler, Design Review. Example: `<permit_type>`
- `related_land_use_permit` (string): Building permits that implement this land use permit (the relatedmup column), for example 3018806-LU. Kind building only. Pattern: ^[0-9]{7}-[A-Za-z]{2}(-[0-9]{3})?$. Example: `<related_land_use_permit>`
- `sort` (string): Order, newest or largest first, missing values last. Defaults to issued_desc, or applied_desc when only application dates are filtered, or decided_desc (land_use only) when decision dates are filtered. Example: `issued_desc`
- `status` (string): Words matched against the current status, for example Issued, Completed, Reviews In Process, Published. Example: `<status>`
- `zip` (string): Five-digit site ZIP code, for example 98103. Pattern: ^[0-9]{5}$. Example: `<zip>`

Response schema example:
```json
{
  "count": 2,
  "dataset": {
    "id": "76t5-zqzr",
    "name": "Building Permits",
    "portal": "data.seattle.gov",
    "updated_at": "2026-10-27T01:15:43Z",
    "url": "https://data.seattle.gov/d/76t5-zqzr"
  },
  "jurisdiction": {
    "county": "King County",
    "name": "City of Seattle",
    "state": "WA"
  },
  "license": {
    "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
    "name": "Public Domain",
    "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
  },
  "next_cursor": null,
  "observed_at_ms": 1793141556717,
  "records": [
    {
      "address": "400 BROAD ST",
      "applied_date": "2016-11-09",
      "city": "SEATTLE",
      "completed_date": "2019-04-26",
      "contractors": [
        {
          "company": "SPACE NEEDLE LLC",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": "Construct substantial alterations to the Space Needle Occupy per plan. (See #6506865 for tower seismic upgrades). Same as original.",
      "expires_date": null,
      "housing_units": 0,
      "issued_date": "2017-07-26",
      "land_use": null,
      "latitude": 47.62049863,
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "longitude": -122.34931591,
      "parcel_id": null,
      "permit_class": "Commercial",
      "permit_number": "6545059-CN",
      "permit_type": "Building",
      "source_url": "https://services.seattle.gov/portal/customize/LinkToRecord.aspx?altId=6545059-CN",
      "square_feet": null,
      "state": "WA",
      "status": "Completed",
      "valuation_usd": 42000000,
      "work_class": "Addition/Alteration",
      "zip": "98109"
    },
    {
      "address": "400 BROAD ST",
      "applied_date": "2016-10-04",
      "city": "SEATTLE",
      "completed_date": "2018-08-01",
      "contractors": [
        {
          "company": "SPACE NEEDLE LLC",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": "Construct seismic upgrades (associated with substantial alterations #6545059) to the Space Needle tower structure only per plan.",
      "expires_date": null,
      "housing_units": 0,
      "issued_date": "2017-06-12",
      "land_use": null,
      "latitude": 47.62049863,
      "license": {
        "attribution": "City of Seattle, Seattle Department of Construction and Inspections: Building Permits (https://data.seattle.gov/d/76t5-zqzr)",
        "name": "Public Domain",
        "url": "https://data.seattle.gov/stories/s/Terms-of-Use/6ukr-wvup"
      },
      "longitude": -122.34931591,
      "parcel_id": null,
      "permit_class": "Commercial",
      "permit_number": "6506865-CN",
      "permit_type": "Building",
      "source_url": "https://services.seattle.gov/portal/customize/LinkToRecord.aspx?altId=6506865-CN",
      "square_feet": null,
      "state": "WA",
      "status": "Completed",
      "valuation_usd": 1616000,
      "work_class": "Addition/Alteration",
      "zip": "98109"
    }
  ],
  "source_url": "https://data.seattle.gov/resource/76t5-zqzr.json?%24where=upper%28originaladdress1%29+like+%27%25400%25BROAD%25ST%25%27+AND+issueddate+%3E%3D+%272017-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272017-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+%3Aid&%24limit=25"
}
```
