{"uid":"cap_lUEoRjkp1u8TrnEbnqKCd","slug":"permit-scouter-contractor-permit-history-ad4d43c9","name":"Permit Scouter – Contractor Permit History","description":"Every permit a contractor has pulled in our coverage area, with totals by trade.","url":"https://api.permitscouter.com/contractors/:contractor_key/history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"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_DF1IDlnx_pBBxxzbgzUiO","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 every building permit a specific contractor has pulled within the coverage area, with totals broken down by trade.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Vetting a contractor before hiring","prompt":"Before I sign with this roofer, can you pull their permit history using license number CCC1330215? I want to see how many jobs they've actually permitted and what trades they work in."},{"title":"Competitive research on local contractors","prompt":"I'm trying to understand how active ABC Plumbing is in the market — can you look up their permit history using their contractor key so I see their total permits and which trades they pull for?"},{"title":"Due diligence during property acquisition","prompt":"We're buying a building and want to verify the contractor who did the recent renovations — can you fetch the permit history for license CGC0042711 and show me everything they've pulled in the area?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:57:10.320Z","isFirstParty":false,"canonicalSlug":"permit-scouter-contractor-permit-history-ad4d43c9"}