# 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 every building permit a specific contractor has pulled within the coverage area, with totals broken down by trade.

## Facts

- Endpoint: GET https://api.permitscouter.com/contractors/:contractor_key/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-ad4d43c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lUEoRjkp1u8TrnEbnqKCd

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-ad4d43c9
```

Example prompt: Pull up the full permit history for contractor license number CGC1523847 — I want to see every permit they've filed and the totals broken down by trade.

## When to prefer this

Use this endpoint when you need a comprehensive historical view of a single contractor's permitting activity across all jobs and trades. Prefer this over address-based permit lookups when the research subject is the contractor rather than a property. Ideal for contractor vetting, competitive analysis, compliance auditing, or due diligence workflows where the contractor license number is known.

## Known failure modes

- Invalid or unknown contractor_key returns an empty result or 404
- Contractor has no permits in the coverage area resulting in an empty history
- Coverage area limitations — permits outside the supported region are not included
- Payment failure via x402 protocol results in 402 response and no data
- Malformed contractor_key format may return a validation error

## How this service works

Every permit a contractor has pulled in our coverage area, with totals by trade.

## Output

A list of every building permit the specified contractor has pulled within the Permit Scouter coverage area, along with aggregated totals organized by trade (e.g. roofing, plumbing, electrical). Each record includes permit details such as job value, address, and status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "contractor_key"
     ],
     "properties": {
      "contractor_key": {
       "type": "string",
       "description": "contractor_key from a permit, usually the licence number"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/permit-scouter-contractor-permit-history-ad4d43c9/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)