{"uid":"cap_Zts_O2vGbZ1SXj0qiap_7","slug":"permit-scouter-contractor-permit-history-196d2df3","name":"Permit Scouter – Contractor Permit History","description":"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.","url":"https://api.permitscouter.com/contractors/%7Bcontractor_key%7D/history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PJh8_RQlCamnf6Vp2w6_I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full history of building permits pulled by a specific contractor in the Tampa Bay area, with totals by trade and overall valuation.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Vetting a roofing contractor before hiring","prompt":"Before I hire this roofer, can you look up their permit history in Tampa Bay? Their license number is CCC9876543 — I want to know how many jobs they've done, what types of work, and the total valuation."},{"title":"Monitoring a competitor's activity","prompt":"Pull the full permit history for contractor CCC1112233 in Tampa — I want to see how busy they've been lately, what trades they're active in, and their most recent jobs."},{"title":"Lead generation for supplier sales","prompt":"I'm trying to identify active contractors to pitch our roofing materials to — can you get the permit history for contractor CCC5554433 so I can see their volume and trade focus in the Tampa Bay area?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:59:37.450Z","isFirstParty":false,"canonicalSlug":"permit-scouter-contractor-permit-history-ad4d43c9"}