# JobLockHQ Permits API

> JobLockHQ Permits API is a paid API for AI agents from api.joblockhq.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Retrieves live building permit records from official municipal sources by location, date range, and other filters

## Facts

- Endpoint: GET https://api.joblockhq.com/joblock/permits?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/joblockhq-permits-api-40725f3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B2-8YkLpA3VmQ64spOiC9

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 joblockhq-permits-api-40725f3c
```

Example prompt: Can you pull the most recent building permits issued in Seattle, WA over the last 7 days — just show me the top 5 results?

## When to prefer this

Choose this endpoint when you need live, authoritative building permit data directly from official municipal sources, especially for contractor verification, real estate due diligence, or construction activity monitoring. It is preferable over scraped or aggregated permit databases when data freshness and official sourcing matter. Best suited for US municipalities currently covered by the service.

## Known failure modes

- Municipality not covered by available data sources — returns empty results or no matching source
- Invalid or unsupported state/province code — query may return zero results
- Upstream government data source temporarily unavailable — live query may fail or time out
- Exceeding the scan limit before all records are exhausted — partial results returned with scan incomplete notice
- Missing required location parameters — malformed request may return an error

## How this service works

JobLockHQ helps homeowners, contractors, and businesses create accountability before problems become disputes. Join the early access list.

## Output

A JSON object containing matched building permit records including permit ID, address, contractor name, project description, valuation, issued date, and municipality, along with source metadata (data source name, adapter type, freshness mode, last certified date) and search stats (records scanned, matched, returned).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "days": 7,
   "limit": 1,
   "country": "US",
   "municipality": "Seattle",
   "state_or_province": "WA"
  },
  "result": {
   "limit": 1,
   "search": {
    "bounded": false,
    "complete": true,
    "scanLimit": 100,
    "statement": "The official source result page was exhausted within the requested date and upstream filters.",
    "recordsScanned": 1
   },
   "matched": 1,
   "permits": [
    {
     "source": {
      "id": "us-seattle-building-permits"
     },
     "address": "1 Main St",
     "country": "US",
     "freshness": {
      "mode": "live_query"
     },
     "permit_id": "example",
     "valuation": 500000,
     "contractor": "Example Construction LLC",
     "project_id": null,
     "description": "Foundation excavation",
     "issued_date": "2026-10-10T00:00:00.000Z",
     "municipality": "Seattle",
     "source_updated_at": null,
     "state_or_province": "WA",
     "joblock_fetched_at": "2026-10-10T00:00:00.000Z",
     "source_last_certified_at": "2026-09-26T00:00:00.000Z"
    }
   ],
   "received": 1,
   "returned": 1
  },
  "source": {
   "id": "us-seattle-building-permits",
   "name": "Seattle Building Permits",
   "status": "ACTIVE",
   "adapter": "socrata",
   "fetched_at": "2026-10-10T00:00:00.000Z",
   "last_certified_at": "2026-09-26T00:00:00.000Z",
   "source_updated_at": null
  },
  "machine": {
   "id": "M002",
   "name": "JobLock Permits",
   "version": "1.0.0"
  },
  "freshness": {
   "mode": "live_query"
  },
  "jurisdiction": {
   "country": "US",
   "municipality": "Seattle",
   "county_or_region": "King",
   "state_or_province": "WA"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joblockhq-permits-api-40725f3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.joblockhq.com](https://www.zero.xyz/host/api.joblockhq.com/llms.txt)