# Permit Scouter – Contractor Permit History

> Permit Scouter – Contractor Permit History is a paid API for AI agents from api.permitscouter.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-27).

Returns the full history of building permits pulled by a specific contractor in the Tampa Bay area, with totals by trade and overall valuation.

## Facts

- Endpoint: GET https://api.permitscouter.com/contractors/%7Bcontractor_key%7D/history?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/permit-scouter-contractor-permit-history-196d2df3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zts_O2vGbZ1SXj0qiap_7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability permit-scouter-contractor-permit-history-196d2df3
```

Example prompt: Pull up the full permit history for Tampa Bay contractor CCC1234567 — I want to see every permit they've filed, what trades they work in, and their total job valuation.

## When to prefer this

Use this endpoint when you need a comprehensive historical view of a specific contractor's permitting activity — including trade breakdown and total job valuation — rather than searching permits by location or date. Prefer this over the permit search endpoint when the contractor identifier is already known and you want aggregated contractor-level intelligence rather than a filtered list of recent permits.

## Known failure modes

- Invalid or unknown contractor_key returns empty results or 404
- Contractor has no permits in the coverage area returns empty results list
- Malformed contractor_key format may return a validation error
- Payment failure or insufficient USDC balance blocks access (x402 payment required)
- Coverage gaps if contractor operates outside Tampa Bay jurisdictions

## How this service works

New building permits from Tampa Bay, Florida, the morning after they're filed. Job value, contractor and trade on every permit. AI agents pay per search with x402.

## Output

A JSON object containing the contractor's name and key, a list of every permit they've pulled (each with address, city, zip, status, trade, description, valuation, applied and issued dates, jurisdiction, and permit number), a breakdown of permit counts by trade, total valuation across all permits, permit count, and the dates of their first and most recent permit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "zip": "33607",
    "city": "TAMPA",
    "status": "Issued",
    "trades": [
     "roofing"
    ],
    "address": "100 EXAMPLE ST",
    "valuation": 14500,
    "permit_key": "tampa:BLD-26-0000001",
    "description": "Re-roof, shingle",
    "issued_date": "2026-10-16",
    "record_type": "Residential Roofing",
    "applied_date": "2026-10-15",
    "jurisdiction": "City of Tampa",
    "permit_number": "BLD-26-0000001",
    "contractor_key": "ccc0000000",
    "contractor_name": "EXAMPLE ROOFING LLC",
    "contractor_license": "CCC0000000"
   }
  ],
  "by_trade": {
   "roofing": 1
  },
  "first_permit": "2026-10-15",
  "permit_count": 1,
  "latest_permit": "2026-10-15",
  "contractor_key": "ccc0000000",
  "contractor_name": "EXAMPLE ROOFING LLC",
  "total_valuation": 14500
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/permit-scouter-contractor-permit-history-196d2df3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.permitscouter.com](https://www.zero.xyz/host/api.permitscouter.com/llms.txt)