{
  "x402Version": 2,
  "id": 51397,
  "slug": "51397",
  "resource": "https://api.locus.report/api/locus-metro-permits",
  "description": "Building permits for an address, parcel set, or point, newest or nearest first with distance: number, type, status, dates, and in Chicago, New York City, Austin, and Seattle the contractor companies named plus cost, trade, and scope filters. Returns the same records as locus_metro_permits. Use this when your client can only call paid x402 routes. Use locus_metro_permits instead when you can call Locus free tools (REST tools/call or MCP).",
  "type": "http",
  "resourceType": "MCP Tool",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "50000",
      "amountUsd": 0.05,
      "maxTimeoutSeconds": 60
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "FBVHMG5PTNW6sNd7uhZBsxhWkwJYRpgk34QcTgDpQdwV",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "50000",
      "amountUsd": 0.05,
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "city": "chicago",
            "latitude": 41.8827,
            "longitude": -87.6233,
            "radiusMeters": 500
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "caveats": [],
            "city": "chicago",
            "closeoutCapability": {
              "closeoutEligible": true,
              "completeCurrentOpenUniverse": true,
              "exactAddressSupported": false,
              "geographicScope": "City of Chicago building permits",
              "matchCapabilities": [],
              "publishedEvidenceTypes": [],
              "sourceId": "chicago-building-permits-closeout",
              "sourceName": "City of Chicago Building Permits",
              "sourceUrl": "https://data.cityofchicago.org/Buildings/Building-Permits/ydr8-5enu",
              "verifiedAt": "2026-09-02"
            },
            "matched": true,
            "nationalCountyPermitTrend": {
              "caveats": [],
              "direction": "falling",
              "latest": {
                "multifamilyUnits": 3778,
                "present": true,
                "reportedTotalUnits": 4897,
                "singleFamilyUnits": 1191,
                "totalUnits": 4969,
                "year": 2025
              },
              "matched": true,
              "provenance": {
                "granularity": "county aggregate (annual), not address-level permit records",
                "source": "U.S. Census Bureau, Building Permits Survey - annual county file (residential units authorized by building permit)",
                "sourceUrl": "https://www.census.gov/construction/bps/"
              },
              "resolvedCounty": {
                "countyFips3": "031",
                "countyFips5": "17031",
                "countyName": "Cook County",
                "stateAbbr": "IL",
                "stateFips": "17"
              },
              "years": []
            },
            "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report...",
            "ok": true,
            "openOrExpiredPermitCount": 20,
            "openOrExpiredPermitRecords": [],
            "overhangs": [],
            "permits": [],
            "provenance": {
              "coverage": "chicago, austin, seattle, san francisco, los angeles, new york, mesa, miami, nashville, washington, san antonio, phoe...",
              "datasetPage": "https://data.cityofchicago.org/Buildings/Building-Permits/ydr8-5enu",
              "source": "City open-data permit datasets, Socrata + ArcGIS (verified: chicago, austin, seattle, san francisco, los angeles, new..."
            },
            "radiusMeters": 500,
            "sinceDate": "2025-09-23",
            "verifyNext": []
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "additionalProperties": false,
                "properties": {
                  "city": {
                    "maxLength": 40,
                    "minLength": 3,
                    "type": "string"
                  },
                  "county": {
                    "maxLength": 80,
                    "minLength": 2,
                    "type": "string"
                  },
                  "excludePermitIds": {
                    "items": {
                      "maxLength": 64,
                      "minLength": 1,
                      "type": "string"
                    },
                    "maxItems": 500,
                    "type": "array"
                  },
                  "latitude": {
                    "maximum": 90,
                    "minimum": -90,
                    "type": "number"
                  },
                  "longitude": {
                    "maximum": 180,
                    "minimum": -180,
                    "type": "number"
                  },
                  "maxRecords": {
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "minReportedCostUsd": {
                    "maximum": 1000000000,
                    "minimum": 0,
                    "type": "number"
                  },
                  "order": {
                    "enum": [
                      "newest",
                      "nearest"
                    ],
                    "type": "string"
                  },
                  "parcelId": {
                    "maxLength": 80,
                    "minLength": 1,
                    "type": "string"
                  },
                  "parcelIds": {
                    "items": {
                      "maxLength": 80,
                      "minLength": 1,
                      "type": "string"
                    },
                    "maxItems": 25,
                    "minItems": 1,
                    "type": "array"
                  },
                  "place": {
                    "maxLength": 240,
                    "minLength": 3,
                    "type": "string"
                  },
                  "radiusMeters": {
                    "maximum": 3000,
                    "minimum": 50,
                    "type": "integer"
                  },
                  "scope": {
                    "items": {
                      "enum": [
                        "new_construction",
                        "addition",
                        "alteration",
                        "demolition",
                        "roof",
                        "solar",
                        "elevator",
                        "signs",
                        "scaffold_or_shed",
                        "fence",
                        "repair"
                      ],
                      "type": "string"
                    },
                    "maxItems": 11,
                    "minItems": 1,
                    "type": "array"
                  },
                  "sinceDate": {
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                    "type": "string"
                  },
                  "state": {
                    "maxLength": 2,
                    "minLength": 2,
                    "type": "string"
                  },
                  "trade": {
                    "enum": [
                      "general",
                      "electrical",
                      "plumbing",
                      "mechanical_hvac",
                      "roofing",
                      "masonry",
                      "elevator",
                      "solar",
                      "fire_protection",
                      "demolition",
                      "concrete_foundation",
                      "signs",
                      "other"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "builder-code": {
      "info": {
        "a": "bc_vz5zyuko"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "maxItems": 11,
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "locus.freePreflight": {
      "coverageBeforeCharge": true,
      "laneTool": "locus_lane_availability",
      "mcpUrl": "https://mcp.locus.report/mcp",
      "recommendedTool": "locus_coverage_check",
      "skillInstall": "npx @velinussage/locus-agent-skill add",
      "skillUrl": "https://api.locus.report/.well-known/skill.md",
      "toolsCallUrl": "https://api.locus.report/tools/call",
      "toolsListUrl": "https://api.locus.report/tools/list",
      "unsupportedReturnsFreeDiagnostic": true,
      "version": 2
    },
    "offer-receipt": {
      "info": {
        "offers": [
          {
            "acceptIndex": 0,
            "format": "eip712",
            "payload": {
              "amount": "50000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "network": "eip155:8453",
              "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
              "resourceUrl": "https://api.locus.report/api/locus-metro-permits",
              "scheme": "exact",
              "validUntil": 1791438022,
              "version": 1
            },
            "signature": "0xc55cc40bc19f3a2075d59734f239cac19a925121ebcedf8e557a46c471f50d8371e60d2c5ee094eeb7dcaf4e260c4bb2efa95a7ad498ea6acb9d69e25c2d7fe01b"
          }
        ]
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "offers": {
            "items": {
              "properties": {
                "acceptIndex": {
                  "type": "integer"
                },
                "format": {
                  "type": "string"
                },
                "payload": {
                  "properties": {
                    "amount": {
                      "type": "string"
                    },
                    "asset": {
                      "type": "string"
                    },
                    "network": {
                      "type": "string"
                    },
                    "payTo": {
                      "type": "string"
                    },
                    "resourceUrl": {
                      "type": "string"
                    },
                    "scheme": {
                      "type": "string"
                    },
                    "validUntil": {
                      "type": "integer"
                    },
                    "version": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "version",
                    "resourceUrl",
                    "scheme",
                    "network",
                    "asset",
                    "payTo",
                    "amount"
                  ],
                  "type": "object"
                },
                "signature": {
                  "type": "string"
                }
              },
              "required": [
                "format",
                "signature"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "offers"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar",
    "builder-code",
    "locus.freePreflight",
    "offer-receipt"
  ],
  "sourceHost": "api.locus.report",
  "lastUpdated": "2026-10-08T05:39:22.185Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T05:39:21.463Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "city": "chicago",
              "latitude": 41.8827,
              "longitude": -87.6233,
              "radiusMeters": 500
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "caveats": [],
              "city": "chicago",
              "closeoutCapability": {
                "closeoutEligible": true,
                "completeCurrentOpenUniverse": true,
                "exactAddressSupported": false,
                "geographicScope": "City of Chicago building permits",
                "matchCapabilities": [],
                "publishedEvidenceTypes": [],
                "sourceId": "chicago-building-permits-closeout",
                "sourceName": "City of Chicago Building Permits",
                "sourceUrl": "https://data.cityofchicago.org/Buildings/Building-Permits/ydr8-5enu",
                "verifiedAt": "2026-09-02"
              },
              "matched": true,
              "nationalCountyPermitTrend": {
                "caveats": [],
                "direction": "falling",
                "latest": {
                  "multifamilyUnits": 3778,
                  "present": true,
                  "reportedTotalUnits": 4897,
                  "singleFamilyUnits": 1191,
                  "totalUnits": 4969,
                  "year": 2025
                },
                "matched": true,
                "provenance": {
                  "granularity": "county aggregate (annual), not address-level permit records",
                  "source": "U.S. Census Bureau, Building Permits Survey - annual county file (residential units authorized by building permit)",
                  "sourceUrl": "https://www.census.gov/construction/bps/"
                },
                "resolvedCounty": {
                  "countyFips3": "031",
                  "countyFips5": "17031",
                  "countyName": "Cook County",
                  "stateAbbr": "IL",
                  "stateFips": "17"
                },
                "years": []
              },
              "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report...",
              "ok": true,
              "openOrExpiredPermitCount": 20,
              "openOrExpiredPermitRecords": [],
              "overhangs": [],
              "permits": [],
              "provenance": {
                "coverage": "chicago, austin, seattle, san francisco, los angeles, new york, mesa, miami, nashville, washington, san antonio, phoe...",
                "datasetPage": "https://data.cityofchicago.org/Buildings/Building-Permits/ydr8-5enu",
                "source": "City open-data permit datasets, Socrata + ArcGIS (verified: chicago, austin, seattle, san francisco, los angeles, new..."
              },
              "radiusMeters": 500,
              "sinceDate": "2025-09-23",
              "verifyNext": []
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "additionalProperties": false,
                  "properties": {
                    "city": {
                      "maxLength": 40,
                      "minLength": 3,
                      "type": "string"
                    },
                    "county": {
                      "maxLength": 80,
                      "minLength": 2,
                      "type": "string"
                    },
                    "excludePermitIds": {
                      "items": {
                        "maxLength": 64,
                        "minLength": 1,
                        "type": "string"
                      },
                      "maxItems": 500,
                      "type": "array"
                    },
                    "latitude": {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    "longitude": {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    },
                    "maxRecords": {
                      "maximum": 100,
                      "minimum": 1,
                      "type": "integer"
                    },
                    "minReportedCostUsd": {
                      "maximum": 1000000000,
                      "minimum": 0,
                      "type": "number"
                    },
                    "order": {
                      "enum": [
                        "newest",
                        "nearest"
                      ],
                      "type": "string"
                    },
                    "parcelId": {
                      "maxLength": 80,
                      "minLength": 1,
                      "type": "string"
                    },
                    "parcelIds": {
                      "items": {
                        "maxLength": 80,
                        "minLength": 1,
                        "type": "string"
                      },
                      "maxItems": 25,
                      "minItems": 1,
                      "type": "array"
                    },
                    "place": {
                      "maxLength": 240,
                      "minLength": 3,
                      "type": "string"
                    },
                    "radiusMeters": {
                      "maximum": 3000,
                      "minimum": 50,
                      "type": "integer"
                    },
                    "scope": {
                      "items": {
                        "enum": [
                          "new_construction",
                          "addition",
                          "alteration",
                          "demolition",
                          "roof",
                          "solar",
                          "elevator",
                          "signs",
                          "scaffold_or_shed",
                          "fence",
                          "repair"
                        ],
                        "type": "string"
                      },
                      "maxItems": 11,
                      "minItems": 1,
                      "type": "array"
                    },
                    "sinceDate": {
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "type": "string"
                    },
                    "state": {
                      "maxLength": 2,
                      "minLength": 2,
                      "type": "string"
                    },
                    "trade": {
                      "enum": [
                        "general",
                        "electrical",
                        "plumbing",
                        "mechanical_hvac",
                        "roofing",
                        "masonry",
                        "elevator",
                        "solar",
                        "fire_protection",
                        "demolition",
                        "concrete_foundation",
                        "signs",
                        "other"
                      ],
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "bodyType": {
                  "enum": [
                    "json",
                    "form-data",
                    "text"
                  ],
                  "type": "string"
                },
                "method": {
                  "enum": [
                    "POST",
                    "PUT",
                    "PATCH"
                  ],
                  "type": "string"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "bodyType",
                "body"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      },
      "builder-code": {
        "info": {
          "a": "bc_vz5zyuko"
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "a": {
              "description": "App builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "s": {
              "description": "Service builder codes",
              "items": {
                "pattern": "^[a-z0-9_]{1,32}$",
                "type": "string"
              },
              "maxItems": 11,
              "type": "array"
            },
            "w": {
              "description": "Wallet builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "locus.freePreflight": {
        "coverageBeforeCharge": true,
        "laneTool": "locus_lane_availability",
        "mcpUrl": "https://mcp.locus.report/mcp",
        "recommendedTool": "locus_coverage_check",
        "skillInstall": "npx @velinussage/locus-agent-skill add",
        "skillUrl": "https://api.locus.report/.well-known/skill.md",
        "toolsCallUrl": "https://api.locus.report/tools/call",
        "toolsListUrl": "https://api.locus.report/tools/list",
        "unsupportedReturnsFreeDiagnostic": true,
        "version": 2
      },
      "offer-receipt": {
        "info": {
          "offers": [
            {
              "acceptIndex": 0,
              "format": "eip712",
              "payload": {
                "amount": "50000",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "network": "eip155:8453",
                "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
                "resourceUrl": "https://api.locus.report/api/locus-metro-permits",
                "scheme": "exact",
                "validUntil": 1791438022,
                "version": 1
              },
              "signature": "0xc55cc40bc19f3a2075d59734f239cac19a925121ebcedf8e557a46c471f50d8371e60d2c5ee094eeb7dcaf4e260c4bb2efa95a7ad498ea6acb9d69e25c2d7fe01b"
            }
          ]
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "offers": {
              "items": {
                "properties": {
                  "acceptIndex": {
                    "type": "integer"
                  },
                  "format": {
                    "type": "string"
                  },
                  "payload": {
                    "properties": {
                      "amount": {
                        "type": "string"
                      },
                      "asset": {
                        "type": "string"
                      },
                      "network": {
                        "type": "string"
                      },
                      "payTo": {
                        "type": "string"
                      },
                      "resourceUrl": {
                        "type": "string"
                      },
                      "scheme": {
                        "type": "string"
                      },
                      "validUntil": {
                        "type": "integer"
                      },
                      "version": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "version",
                      "resourceUrl",
                      "scheme",
                      "network",
                      "asset",
                      "payTo",
                      "amount"
                    ],
                    "type": "object"
                  },
                  "signature": {
                    "type": "string"
                  }
                },
                "required": [
                  "format",
                  "signature"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "offers"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.locus.report",
    "manifest_name": "api.locus.report",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}