---
type: "firecrawl-provider"
description: "City of Cincinnati building permits on data.cincinnati-oh.gov, Cincinnati's Socrata open data portal, as the shared permit record: search by address, parcel, ZIP, neighborhood, contractor, type, status, application or issue date and value; read one permit with every work item and its licensed trade contractors; rank contractors by permits issued; and search code enforcement cases (violations, vacant building orders, zoning and nuisance complaints) by address, status, type and last update. Public Domain, reloaded daily."
use_when: "City of Cincinnati building permits on data.cincinnati-oh.gov, Cincinnati's Socrata open data portal, as the shared permit record: search by address, parcel, ZIP, neighborhood, contractor, type, status, application or issue date and value; read one permit with every work item and its licensed trade contractors; rank contractors by permits issued; and search code enforcement cases (violations, vacant building orders, zoning and nuisance complaints) by address, status, type and last update. Public Domain, reloaded daily."
categories: "Real estate"
capabilities: 4
credits_per_call: 5
---
# City of Cincinnati Open Data: building permits, contractors and code enforcement on Firecrawl Alexandria

City of Cincinnati building permits on data.cincinnati-oh.gov, Cincinnati's Socrata open data portal, as the shared permit record: search by address, parcel, ZIP, neighborhood, contractor, type, status, application or issue date and value; read one permit with every work item and its licensed trade contractors; rank contractors by permits issued; and search code enforcement cases (violations, vacant building orders, zoning and nuisance complaints) by address, status, type and last update. Public Domain, reloaded daily.

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

## More

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

## Capabilities

- [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-gov/building-permits/contractor_activity): Rank the contractor companies named on City of Cincinnati building permits issued in a date window by distinct permits, then total estimated project value, in one grouped SODA request. Optional permit type words and ZIP. Permits the city records as pulled by the property owner (OWNER) or without a company are left out. 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-cincinnati-oh-gov/building-permits/get_permit): Read one City of Cincinnati building permit by permit number: the shared permit record merged from every row the city publishes for it (one per work item of a combination permit), the work items themselves with each row as published, and the contractors named on the permit plus those in the Building Permits Contacts dataset (vmk6-gy84; licensed trade contractors by relationship code, for permits applied 2012-2019). Owners, neighbours and mailing contacts are never read. An unknown permit number is not_found.
- [Search code cases](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-gov/building-permits/search_code_cases): Search code enforcement cases on data.cincinnati-oh.gov (Code Enforcement cncm-znd6): building, property maintenance, zoning, vacant building, tall grass and abandoned vehicle complaints, newest entered first. Filter by address, neighborhood, agency, case type, status, entry date window and the cases' own last-updated date, so an agent can poll for cases that changed. The dataset is the CAGIS feed: most cases are the City of Cincinnati's, some belong to other Hamilton County jurisdictions (agency names which). Rows the city repeats exactly are returned once. An empty page is a successful result with count 0.
- [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-gov/building-permits/search_permits): Search City of Cincinnati building permits (Building Permits uhjb-xac9 on data.cincinnati-oh.gov), newest issued first. Filter by site address, ZIP, neighborhood, contractor company, permit type or code book, status, Hamilton County parcel number, application or issue date windows and minimum project value. Every record has the shared permit shape (number, type, status, dates, address, coordinates, parcel, value, housing units, contractor, CAGIS detail link, licence). The city publishes a combination permit as one row per work item, so a permit number can appear more than once, each row with its own type, status, issue date and value; get_permit merges them. The city reloads the data daily, so to monitor new permits poll applied_since or issued_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 Cincinnati building permits on data.cincinnati-oh.gov, Cincinnati's Socrata open data portal, as the shared permit record: search by address, parcel, ZIP, neighborhood, contractor, type, status, application or issue date and value; read one permit with every work item and its licensed trade contractors; rank contractors by permits issued; and search code enforcement cases (violations, vacant building orders, zoning and nuisance complaints) by address, status, type and last update. Public Domain, reloaded daily.

## 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-cincinnati-oh-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>`
- `limit` (number): Records per page. Example: `25`
- `permit_type` (string): Only permits whose work type, permit type, code book or class matches these words, for example HVAC, New Building, Wrecking. 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-cincinnati-oh-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-cincinnati-oh-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-cincinnati-oh-gov",
    "capability": "building-permits/contractor_activity",
    "options": {
      "issued_since": "2025-01-01",
      "issued_until": "2025-12-31",
      "limit": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'data-cincinnati-oh-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-cincinnati-oh-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-cincinnati-oh-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": "uhjb-xac9",
    "name": "Cincinnati Building Permits",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:03:51Z",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "Hamilton County",
    "name": "City of Cincinnati",
    "state": "OH"
  },
  "license": {
    "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
    "name": "Public Domain",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793144647881,
  "records": [
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "APOLLO HEATING & A/C",
      "permits": 347,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22APOLLO+HEATING+%26+A%2FC%22%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+permitnum+DESC",
      "total_valuation_usd": 4145843.65
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "PEOPLE WORKING COOPERATIVELY",
      "permits": 273,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22PEOPLE+WORKING+COOPERATIVELY%22%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+permitnum+DESC",
      "total_valuation_usd": 1017870
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "RECKER AND BOERGER",
      "permits": 267,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22RECKER+AND+BOERGER%22%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+permitnum+DESC",
      "total_valuation_usd": 1031339.49
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "HELP HOME SERVICES",
      "permits": 189,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22HELP+HOME+SERVICES%22%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+permitnum+DESC",
      "total_valuation_usd": 2916699
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "APOLLO HEATING, AIR COND. & PLUMBING",
      "permits": 182,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22APOLLO+HEATING%2C+AIR+COND.+%26+PLUMBING%22%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+permitnum+DESC",
      "total_valuation_usd": 830337
    },
    {
      "first_issued_date": "2025-02-04",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "DMG CONTRACTORS INC",
      "permits": 148,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22DMG+CONTRACTORS+INC%22%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+permitnum+DESC",
      "total_valuation_usd": 994460
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-18",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "LOGAN SERVICES",
      "permits": 133,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22LOGAN+SERVICES%22%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+permitnum+DESC",
      "total_valuation_usd": 1458113.49
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "HELP HOME SERVICE INC",
      "permits": 129,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22HELP+HOME+SERVICE+INC%22%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+permitnum+DESC",
      "total_valuation_usd": 745748.75
    },
    {
      "first_issued_date": "2025-01-08",
      "last_issued_date": "2025-12-18",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "ZINS PLUMBING",
      "permits": 117,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22ZINS+PLUMBING%22%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+permitnum+DESC",
      "total_valuation_usd": 374128.91
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "OHIO BASEMENT AUTHORITY",
      "permits": 107,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22OHIO+BASEMENT+AUTHORITY%22%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+permitnum+DESC",
      "total_valuation_usd": 2903410.03
    }
  ],
  "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24select=companyname+AS+contractor%2C+count%28distinct+permitnum%29+AS+permits%2C+sum%28estprojectcostdec%3A%3Anumber%29+AS+total_valuation%2C+min%28issueddate%29+AS+first_issued%2C+max%28issueddate%29+AS+last_issued&%24group=contractor&%24where=companyname+IS+NOT+NULL+AND+companyname+%21%3D+%27%22OWNER%22%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%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 contractor companies named on City of Cincinnati building permits issued in a date window by distinct permits, then total estimated project value, in one grouped SODA request. Optional permit type words and ZIP. Permits the city records as pulled by the property owner (OWNER) or without a company are left out. 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 Cincinnati for a permit type, ZIP or period; contractor market share; finding a contractor's exact published name before searching its permits.
- Cost: 5 credits per call
- Capability file: [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-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>`
- `limit` (number): Records per page. Example: `25`
- `permit_type` (string): Only permits whose work type, permit type, code book or class matches these words, for example HVAC, New Building, Wrecking. 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": "uhjb-xac9",
    "name": "Cincinnati Building Permits",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:03:51Z",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "issued_since": "2025-01-01",
  "issued_until": "2025-12-31",
  "jurisdiction": {
    "county": "Hamilton County",
    "name": "City of Cincinnati",
    "state": "OH"
  },
  "license": {
    "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
    "name": "Public Domain",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "next_cursor": "10",
  "observed_at_ms": 1793144647881,
  "records": [
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "APOLLO HEATING & A/C",
      "permits": 347,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22APOLLO+HEATING+%26+A%2FC%22%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+permitnum+DESC",
      "total_valuation_usd": 4145843.65
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "PEOPLE WORKING COOPERATIVELY",
      "permits": 273,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22PEOPLE+WORKING+COOPERATIVELY%22%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+permitnum+DESC",
      "total_valuation_usd": 1017870
    },
    {
      "first_issued_date": "2025-01-03",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "RECKER AND BOERGER",
      "permits": 267,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22RECKER+AND+BOERGER%22%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+permitnum+DESC",
      "total_valuation_usd": 1031339.49
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "HELP HOME SERVICES",
      "permits": 189,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22HELP+HOME+SERVICES%22%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+permitnum+DESC",
      "total_valuation_usd": 2916699
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "APOLLO HEATING, AIR COND. & PLUMBING",
      "permits": 182,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22APOLLO+HEATING%2C+AIR+COND.+%26+PLUMBING%22%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+permitnum+DESC",
      "total_valuation_usd": 830337
    },
    {
      "first_issued_date": "2025-02-04",
      "last_issued_date": "2025-12-30",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "DMG CONTRACTORS INC",
      "permits": 148,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22DMG+CONTRACTORS+INC%22%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+permitnum+DESC",
      "total_valuation_usd": 994460
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-18",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "LOGAN SERVICES",
      "permits": 133,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22LOGAN+SERVICES%22%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+permitnum+DESC",
      "total_valuation_usd": 1458113.49
    },
    {
      "first_issued_date": "2025-01-07",
      "last_issued_date": "2025-12-29",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "HELP HOME SERVICE INC",
      "permits": 129,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22HELP+HOME+SERVICE+INC%22%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+permitnum+DESC",
      "total_valuation_usd": 745748.75
    },
    {
      "first_issued_date": "2025-01-08",
      "last_issued_date": "2025-12-18",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "ZINS PLUMBING",
      "permits": 117,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22ZINS+PLUMBING%22%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+permitnum+DESC",
      "total_valuation_usd": 374128.91
    },
    {
      "first_issued_date": "2025-01-02",
      "last_issued_date": "2025-12-31",
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "name": "OHIO BASEMENT AUTHORITY",
      "permits": 107,
      "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=companyname+%3D+%27%22OHIO+BASEMENT+AUTHORITY%22%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+permitnum+DESC",
      "total_valuation_usd": 2903410.03
    }
  ],
  "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24select=companyname+AS+contractor%2C+count%28distinct+permitnum%29+AS+permits%2C+sum%28estprojectcostdec%3A%3Anumber%29+AS+total_valuation%2C+min%28issueddate%29+AS+first_issued%2C+max%28issueddate%29+AS+last_issued&%24group=contractor&%24where=companyname+IS+NOT+NULL+AND+companyname+%21%3D+%27%22OWNER%22%27+AND+issueddate+%3E%3D+%272025-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272025-12-31T23%3A59%3A59.999%27&%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 Cincinnati building permit by permit number: the shared permit record merged from every row the city publishes for it (one per work item of a combination permit), the work items themselves with each row as published, and the contractors named on the permit plus those in the Building Permits Contacts dataset (vmk6-gy84; licensed trade contractors by relationship code, for permits applied 2012-2019). Owners, neighbours and mailing contacts are never read. An unknown permit number is not_found.
- Instructions: A permit number from search_permits, a CAGIS ezTrak link or a document, when every work item, status and contractor is needed.
- Cost: 5 credits per call
- Capability file: [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-gov/building-permits/get_permit)

Accepted options:
- `permit_number` (string, required): Cincinnati permit number: year, P, five digits, for example 2026P04108 or 2018P03673. Pattern: ^[0-9]{4}[Pp][0-9]{5}$. Example: `<permit_number>`

Response schema example:
```json
{
  "address": "303 SEITZ ST",
  "applied_date": "2018-05-01",
  "city": "CINCINNATI",
  "completed_date": "2024-05-03",
  "contacts_dataset": {
    "id": "vmk6-gy84",
    "name": "Cincinnati Building Permits Contacts",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:08:03Z",
    "url": "https://data.cincinnati-oh.gov/d/vmk6-gy84"
  },
  "contacts_source_url": "https://data.cincinnati-oh.gov/resource/vmk6-gy84.json?%24select=number_key%2C+name%2C+relationship%2C+applied_date&%24where=number_key+%3D+%272018P03673%27+AND+relationship+in+%28%27CONTRACTOR%27%2C+%27BC+CONTR%27%2C+%27BC+PLG%27%2C+%27BC+HVAC%27%2C+%27BC+ELEC%27%2C+%27BC+DEMO%27%2C+%27BC+SUPPR%27%2C+%27BC+HOME%27%2C+%27BC+ELEV%27%2C+%27BC+ALRM%27%2C+%27BC+HYDRN%27%2C+%27BC+RFRG%27%2C+%27HVAC+CONTR%27%2C+%27PLUMBER%27%2C+%27JRNYPLMB%27%2C+%27PLMBCNT%27%2C+%27WRECKING%27%2C+%27DEMOLITION%27%2C+%27ELEV+CONTR%27%2C+%27ELEVATORCO%27%2C+%27FIRE+SUPPR%27%2C+%27ALARM+INST%27%2C+%27GENCTR%27%2C+%27SIGN%27%2C+%27W+TAPPER%27%29&%24order=relationship%2C+name%2C+%3Aid&%24limit=50",
  "contractors": [
    {
      "company": "AURA PARTNERS LLC",
      "license_number": null,
      "name": null,
      "phone": null,
      "role": "contractor"
    },
    {
      "company": null,
      "license_number": null,
      "name": "AURA PARTNERS LLC",
      "phone": null,
      "role": "BC CONTR"
    }
  ],
  "dataset": {
    "id": "uhjb-xac9",
    "name": "Cincinnati Building Permits",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:03:51Z",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "description": "Alteration; HVAC",
  "expires_date": "2024-10-29",
  "housing_units": 4,
  "issued_date": "2019-03-21",
  "jurisdiction": {
    "county": "Hamilton County",
    "name": "City of Cincinnati",
    "state": "OH"
  },
  "latitude": 39.11550587791559,
  "license": {
    "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
    "name": "Public Domain",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "longitude": -84.511793359578,
  "neighborhood": "MT. AUBURN",
  "observed_at_ms": 1793144645611,
  "parcel_id": "009400060015",
  "permit_class": "OBC",
  "permit_number": "2018P03673",
  "permit_type": "Building; HVAC",
  "raw": {
    "applieddate": "2018-05-01T00:00:00.000",
    "coissueddate": "2024-05-03T00:00:00.000",
    "companyname": "\"AURA PARTNERS LLC\"",
    "completeddate": "2024-05-03T00:00:00.000",
    "description": "Alteration",
    "estprojectcostdec": "475000",
    "expiresdate": "2024-10-29T00:00:00.000",
    "fee": "7723.88",
    "issueddate": "2019-03-21T00:00:00.000",
    "jurisdiction": "CINCINNATI",
    "latitude": "39.11550587791559",
    "link": "http://cagis.hamilton-co.org/opal/apd.aspx?QSPerm=2018P03673",
    "longitude": "-84.511793359578",
    "neighborhood": "MT. AUBURN",
    "originaladdress1": "303 SEITZ ST",
    "originalcity": "CINCINNATI",
    "originalstate": "OH",
    "originalzip": "45202",
    "permitclass": "OBC",
    "permitnum": "2018P03673",
    "permittype": "CBPCBCP",
    "permittypemapped": "Building",
    "pin": "\"009400060015\"",
    "proposeduse": "\"R-2\"",
    "statuscurrent": "CLOSED",
    "statuscurrentmapped": "Permit Finaled",
    "totalsqft": "4696",
    "units": "4",
    "workclass": "CALTR",
    "workclassmapped": "Existing"
  },
  "source_url": "http://cagis.hamilton-co.org/opal/apd.aspx?QSPerm=2018P03673",
  "square_feet": 4696,
  "state": "OH",
  "status": "Permit Finaled",
  "valuation_usd": 515000,
  "work_class": "Existing",
  "work_items": [
    {
      "certificate_of_occupancy_date": "2024-05-03",
      "completed_date": "2024-05-03",
      "description": "Alteration",
      "expires_date": "2024-10-29",
      "fee_usd": 7723.88,
      "housing_units": 4,
      "issued_date": "2019-03-21",
      "permit_class": "OBC",
      "permit_type": "Building",
      "permit_type_code": "CBPCBCP",
      "proposed_use": "R-2",
      "raw": {
        "applieddate": "2018-05-01T00:00:00.000",
        "coissueddate": "2024-05-03T00:00:00.000",
        "companyname": "\"AURA PARTNERS LLC\"",
        "completeddate": "2024-05-03T00:00:00.000",
        "description": "Alteration",
        "estprojectcostdec": "475000",
        "expiresdate": "2024-10-29T00:00:00.000",
        "fee": "7723.88",
        "issueddate": "2019-03-21T00:00:00.000",
        "jurisdiction": "CINCINNATI",
        "latitude": "39.11550587791559",
        "link": "http://cagis.hamilton-co.org/opal/apd.aspx?QSPerm=2018P03673",
        "longitude": "-84.511793359578",
        "neighborhood": "MT. AUBURN",
        "originaladdress1": "303 SEITZ ST",
        "originalcity": "CINCINNATI",
        "originalstate": "OH",
        "originalzip": "45202",
        "permitclass": "OBC",
        "permitnum": "2018P03673",
        "permittype": "CBPCBCP",
        "permittypemapped": "Building",
        "pin": "\"009400060015\"",
        "proposeduse": "\"R-2\"",
        "statuscurrent": "CLOSED",
        "statuscurrentmapped": "Permit Finaled",
        "totalsqft": "4696",
        "units": "4",
        "workclass": "CALTR",
        "workclassmapped": "Existing"
      },
      "square_feet": 4696,
      "status": "Permit Finaled",
      "status_code": "CLOSED",
      "valuation_usd": 475000,
      "work_class": "Existing",
      "work_class_code": "CALTR"
    },
    {
      "certificate_of_occupancy_date": null,
      "completed_date": "2024-05-03",
      "description": "HVAC",
      "expires_date": "2024-10-29",
      "fee_usd": 7723.88,
      "housing_units": 0,
      "issued_date": "2019-03-21",
      "permit_class": "OBC",
      "permit_type": "HVAC",
      "permit_type_code": "CBPCBCP",
      "proposed_use": "R-2",
      "raw": {
        "applieddate": "2018-05-01T00:00:00.000",
        "companyname": "\"AURA PARTNERS LLC\"",
        "completeddate": "2024-05-03T00:00:00.000",
        "description": "HVAC",
        "estprojectcostdec": "40000",
        "expiresdate": "2024-10-29T00:00:00.000",
        "fee": "7723.88",
        "issueddate": "2019-03-21T00:00:00.000",
        "jurisdiction": "CINCINNATI",
        "latitude": "39.11550587791559",
        "link": "http://cagis.hamilton-co.org/opal/apd.aspx?QSPerm=2018P03673",
        "longitude": "-84.511793359578",
        "neighborhood": "MT. AUBURN",
        "originaladdress1": "303 SEITZ ST",
        "originalcity": "CINCINNATI",
        "originalstate": "OH",
        "originalzip": "45202",
        "permitclass": "OBC",
        "permitnum": "2018P03673",
        "permittype": "CBPCBCP",
        "permittypemapped": "HVAC",
        "pin": "\"009400060015\"",
        "proposeduse": "\"R-2\"",
        "statuscurrent": "CLOSED",
        "statuscurrentmapped": "Permit Finaled",
        "units": "0",
        "workclass": "CALTR",
        "workclassmapped": "Existing"
      },
      "square_feet": null,
      "status": "Permit Finaled",
      "status_code": "CLOSED",
      "valuation_usd": 40000,
      "work_class": "Existing",
      "work_class_code": "CALTR"
    }
  ],
  "zip": "45202"
}
```

### Search code cases

- Capability: `building-permits/search_code_cases`
- Description: Search code enforcement cases on data.cincinnati-oh.gov (Code Enforcement cncm-znd6): building, property maintenance, zoning, vacant building, tall grass and abandoned vehicle complaints, newest entered first. Filter by address, neighborhood, agency, case type, status, entry date window and the cases' own last-updated date, so an agent can poll for cases that changed. The dataset is the CAGIS feed: most cases are the City of Cincinnati's, some belong to other Hamilton County jurisdictions (agency names which). Rows the city repeats exactly are returned once. An empty page is a successful result with count 0.
- Instructions: Violations, vacant building orders or open complaints at a Cincinnati address before or after a permit search; new or changed cases since a date in a neighborhood.
- Cost: 5 credits per call
- Capability file: [Search code cases](https://firecrawl.dev/alexandria/agents/providers/data-cincinnati-oh-gov/building-permits/search_code_cases)

Accepted options:
- `address` (string): Site street address, case-insensitive, words matched in order: 609 Walnut St, 2421 May. Only the part before a comma is used; spelled-out directions and street types become the city's abbreviations (West -> W, Avenue -> AV) and a leading house number is matched exactly, so 609 does not match 1609. Example: `<address>`
- `agency` (string): Agency words, for example Buildings and Inspections, Public Services, Health, Forest Park. Example: `<agency>`
- `case_type` (string): Words matched against the complaint type, subtype and category, for example Tall Grass, Vacant, Zoning, Graffiti, Buildings with Residences. Example: `<case_type>`
- `cursor` (string): The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. Example: `<cursor>`
- `entered_since` (string): First entry date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<entered_since>`
- `entered_until` (string): Last entry date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<entered_until>`
- `limit` (number): Records per page. Example: `25`
- `neighborhood` (string): Neighborhood words, case-insensitive, for example Walnut Hills, Westwood. Example: `<neighborhood>`
- `sort` (string): Order, newest first, missing values last. Defaults to entered_desc, or updated_desc when only updated_since is given. Example: `entered_desc`
- `status` (string): Words matched against the status, its code and class, for example open, Closed, Orders Issued, Citation. Example: `<status>`
- `updated_since` (string): Cases whose last_updated date is on or after this day (YYYY-MM-DD; the city publishes day precision). Without entry-date filters the default sort becomes updated_desc. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<updated_since>`

Response schema example:
```json
{
  "count": 8,
  "dataset": {
    "id": "cncm-znd6",
    "name": "Code Enforcement",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:28:38Z",
    "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
  },
  "jurisdiction": {
    "county": "Hamilton County",
    "name": "City of Cincinnati",
    "state": "OH"
  },
  "license": {
    "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
    "name": "Public Domain",
    "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
  },
  "next_cursor": null,
  "observed_at_ms": 1793144648344,
  "records": [
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Buildings and Inspections",
      "case_number": "B202301026",
      "case_subtype": "Recycling, remove cart vacant",
      "case_type": "Code Enforcement - Buildings with Residences",
      "category": "Vacated and Condemned Buildings",
      "entered_date": "2023-02-02",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/PropertyActivity/CagisReport?APD=B202301026",
      "status": "Closed - Orders Reissued",
      "status_class": "CLOS",
      "status_code": "REISSUE",
      "updated_date": "2025-07-03"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Buildings and Inspections",
      "case_number": "B202100341",
      "case_subtype": "RES CODE STANDARD",
      "case_type": "Code Enforcement - Buildings with Residences",
      "category": "Building Enforcement",
      "entered_date": "2021-01-22",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/PropertyActivity/CagisReport?APD=B202100341",
      "status": "Final Notice",
      "status_class": "OPEN",
      "status_code": "FINLNOTC",
      "updated_date": "2022-09-22"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Health Dept",
      "case_number": "JV16000017",
      "case_subtype": "Abandoned Vehicle",
      "case_type": "Abandoned Vehicle Code Enforcement",
      "category": "Abandoned Vehicles",
      "entered_date": "2016-01-08",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=JV16000017",
      "status": "Closed - No Violation",
      "status_class": "CLOS",
      "status_code": "CLOS-NO",
      "updated_date": "2016-01-11"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Trade and Development",
      "case_number": "B201501698",
      "case_subtype": "Level - Standard",
      "case_type": "Code Enforcement - Buildings with Residences",
      "category": "Building Enforcement",
      "entered_date": "2015-03-03",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=B201501698",
      "status": "Closed",
      "status_class": "CLOS",
      "status_code": "CLOSED",
      "updated_date": "2016-05-10"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Trade and Development",
      "case_number": "B201300293",
      "case_subtype": "Level - Standard",
      "case_type": "Code Enforcement - Buildings with Residences",
      "category": "Building Enforcement",
      "entered_date": "2013-01-23",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=B201300293",
      "status": "REISSUE",
      "status_class": "CLOS",
      "status_code": "REISSUE",
      "updated_date": "2015-03-06"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Health Dept",
      "case_number": "JV12000165",
      "case_subtype": "Abandoned Vehicle",
      "case_type": "Abandoned Vehicle Code Enforcement",
      "category": "Abandoned Vehicles",
      "entered_date": "2012-03-14",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=JV12000165",
      "status": "Abated by the Owner",
      "status_class": "CLOS",
      "status_code": "ABAT-OWN",
      "updated_date": "2012-04-06"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Trade and Development",
      "case_number": "B200900009",
      "case_subtype": "Vacant Building - Priority Barricade",
      "case_type": "Code Enforcement - Buildings with Residences",
      "category": "Building Enforcement",
      "entered_date": "2009-01-02",
      "latitude": 39.1256059827492,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953238759206,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=B200900009",
      "status": "Closed",
      "status_class": "CLOS",
      "status_code": "CLOSED",
      "updated_date": "2010-11-16"
    },
    {
      "address": "2421 MAY ST",
      "agency": "Cincinnati Health Dept",
      "case_number": "JV05000063",
      "case_subtype": "Abandoned Vehicle",
      "case_type": "Abandoned Vehicle Code Enforcement",
      "category": "Abandoned Vehicles",
      "entered_date": "2005-01-25",
      "latitude": 39.1256087884024,
      "license": {
        "attribution": "City of Cincinnati: Code Enforcement (https://data.cincinnati-oh.gov/d/cncm-znd6)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/cncm-znd6"
      },
      "longitude": -84.4953204296716,
      "neighborhood": "WALNUT HILLS",
      "source_url": "http://cagismaps.hamilton-co.org/propertyactivity/cagisreport?APD=JV05000063",
      "status": "Closed",
      "status_class": "CLOS",
      "status_code": "CLOSED",
      "updated_date": "2005-01-25"
    }
  ],
  "source_url": "https://data.cincinnati-oh.gov/resource/cncm-znd6.json?%24select=distinct+number_key%2C+work_type%2C+work_subtype%2C+display_agency%2C+comp_type%2C+comp_type_desc%2C+sub_type%2C+sub_type_desc%2C+entered_date%2C+data_status%2C+data_status_display%2C+status_class%2C+city_id%2C+city_county%2C+x_coord%2C+y_coord%2C+url%2C+last_updated%2C+yn_activity_report%2C+neighborhood%2C+latitude%2C+longitude%2C+full_address&%24where=%28upper%28trim%28full_address%29%29+like+%272421+%25MAY%25ST%25%27+OR+upper%28trim%28full_address%29%29+like+%272421-%25MAY%25ST%25%27%29+AND+entered_date+%3C%3D+%272024-12-31T23%3A59%3A59.999%27&%24order=entered_date+DESC+NULL+LAST%2C+number_key+DESC%2C+sub_type%2C+data_status%2C+full_address&%24limit=25"
}
```

### Search permits

- Capability: `building-permits/search_permits`
- Description: Search City of Cincinnati building permits (Building Permits uhjb-xac9 on data.cincinnati-oh.gov), newest issued first. Filter by site address, ZIP, neighborhood, contractor company, permit type or code book, status, Hamilton County parcel number, application or issue date windows and minimum project value. Every record has the shared permit shape (number, type, status, dates, address, coordinates, parcel, value, housing units, contractor, CAGIS detail link, licence). The city publishes a combination permit as one row per work item, so a permit number can appear more than once, each row with its own type, status, issue date and value; get_permit merges them. The city reloads the data daily, so to monitor new permits poll applied_since or issued_since; dataset.updated_at says when it last reloaded. An empty page is a successful result with count 0.
- Instructions: Permit history at a Cincinnati address or parcel, a contractor's jobs, new applications or issued permits since a date, large projects above a value. For one permit with every work item and its contacts 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-cincinnati-oh-gov/building-permits/search_permits)

Accepted options:
- `address` (string): Site street address, case-insensitive, words matched in order: 609 Walnut St, 2421 May. Only the part before a comma is used; spelled-out directions and street types become the city's abbreviations (West -> W, Avenue -> AV) and a leading house number is matched exactly, so 609 does not match 1609. 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, matched in order against the permit's companyname, for example Apollo Heating. Contacts-only names (2012-2019) are not searched. Example: `<contractor>`
- `cursor` (string): The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. Example: `<cursor>`
- `issued_since` (string): First issue date, inclusive (YYYY-MM-DD). Poll for newly issued permits with this. 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>`
- `limit` (number): Records per page. Example: `25`
- `min_valuation` (number): Only permit rows whose estimated project cost is at least this many US dollars. Example: `10`
- `neighborhood` (string): Cincinnati neighborhood words, case-insensitive, for example Over-the-Rhine, Hyde Park, Westwood. Example: `<neighborhood>`
- `parcel_id` (string): Hamilton County parcel number as CAGIS publishes it, 12 digits (006800020317); dashes and spaces are ignored. Example: `<parcel_id>`
- `permit_type` (string): Words matched against the work type, permit type, code book and new/existing class, for example New Building, HVAC, Wrecking, Signs, RCO, OBC. Example: `<permit_type>`
- `sort` (string): Order, newest or largest first, missing values last. Defaults to issued_desc, or applied_desc when only application dates are filtered. Example: `issued_desc`
- `status` (string): Words matched against the status and its code, for example Issued, In Review, Finaled, Withdrawn, Expired. Example: `<status>`
- `zip` (string): Five-digit site ZIP code, for example 45202. Pattern: ^[0-9]{5}$. Example: `<zip>`

Response schema example:
```json
{
  "count": 1,
  "dataset": {
    "id": "uhjb-xac9",
    "name": "Cincinnati Building Permits",
    "portal": "data.cincinnati-oh.gov",
    "updated_at": "2026-10-27T12:03:51Z",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "jurisdiction": {
    "county": "Hamilton County",
    "name": "City of Cincinnati",
    "state": "OH"
  },
  "license": {
    "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
    "name": "Public Domain",
    "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
  },
  "next_cursor": null,
  "observed_at_ms": 1793144644116,
  "records": [
    {
      "address": "609 WALNUT ST",
      "applied_date": "2023-01-17",
      "city": "CINCINNATI",
      "completed_date": "2024-04-12",
      "contractors": [
        {
          "company": "ZSR CONTRACTING AND RESTORATION INC",
          "license_number": null,
          "name": null,
          "phone": null,
          "role": "contractor"
        }
      ],
      "description": "Repair",
      "expires_date": "2024-01-17",
      "housing_units": 0,
      "issued_date": "2023-01-17",
      "latitude": 39.10309256631319,
      "license": {
        "attribution": "City of Cincinnati: Cincinnati Building Permits (https://data.cincinnati-oh.gov/d/uhjb-xac9)",
        "name": "Public Domain",
        "url": "https://data.cincinnati-oh.gov/d/uhjb-xac9"
      },
      "longitude": -84.5119423899594,
      "neighborhood": "DOWNTOWN",
      "parcel_id": "007700020163",
      "permit_class": "OBC",
      "permit_number": "2023P00537",
      "permit_type": "Building",
      "source_url": "http://cagis.hamilton-co.org/opal/apd.aspx?QSPerm=2023P00537",
      "square_feet": 0,
      "state": "OH",
      "status": "Permit Finaled",
      "valuation_usd": 25000,
      "work_class": "Existing",
      "zip": "45202"
    }
  ],
  "source_url": "https://data.cincinnati-oh.gov/resource/uhjb-xac9.json?%24where=%28upper%28trim%28originaladdress1%29%29+like+%27609+%25WALNUT%25ST%25%27+OR+upper%28trim%28originaladdress1%29%29+like+%27609-%25WALNUT%25ST%25%27%29+AND+issueddate+%3E%3D+%272023-01-01T00%3A00%3A00%27+AND+issueddate+%3C%3D+%272023-12-31T23%3A59%3A59.999%27&%24order=issueddate+DESC+NULL+LAST%2C+permitnum+DESC%2C+%3Aid&%24limit=25"
}
```
