> ## Documentation Index > Fetch the complete documentation index at: https://docs.homeservicedata.org/docs/llms.txt > Use this file to discover all available pages before exploring further. # GET /api/v1/context/permits — Permit Requirements > Query permit requirements, inspection rules, and fee schedules by trade, state, county, and city with source links and quote-safe flags. The permits context endpoint returns permit and code-compliance records for home-service trades across U.S. jurisdictions. Each record describes whether a permit is required, what inspections and documents are needed, and any associated fee structure. Records include source links where available. Records backed by deterministic reviewed source data are marked `quote_safe: true`; records with ambiguous requirements, estimated fees, or unresolved code questions carry `quote_safe: false` and should be treated as directional context only. **Endpoint** ``` GET https://homeservicedata.org/api/v1/context/permits ``` ## Query Parameters Trade vertical to filter by. One of: `hvac`, `solar`, `roofing`, `plumbing`, `electrical`. Two-letter state code (e.g., `FL`, `AZ`). Case-insensitive. County name. Partial match, case-insensitive. City name. Partial match against the jurisdiction's city. Case-insensitive. When `true`, returns only records verified for customer-facing quote use. Maximum number of records to return. Capped at `500`. ## Response Fields Array of permit context objects. Unique record identifier. The authority having jurisdiction (AHJ) for this record. Internal jurisdiction authority ID. Normalized jurisdiction slug. Name of the AHJ (e.g., `City of Phoenix Building Department`). Type: `city`, `county`, `state`, or `special_district`. State code where this jurisdiction operates. County name for this jurisdiction. 5-digit county FIPS code. City name for this jurisdiction. Jurisdiction's official website. Direct link to the jurisdiction's permit portal. Trade this permit record applies to. Permit type label (e.g., `mechanical`, `electrical`, `building`). Permit and inspection requirement flags. Whether a permit is required for this trade/work type. Whether a post-installation inspection is required. Whether a licensed contractor must pull the permit. Whether contractor registration with the jurisdiction is required. Whether pre-approval or plan review is required before work begins. List of documents required for permit submission (e.g., `equipment_spec_sheet`, `load_calculation`). Conditions that are ambiguous or not yet verified. Permit fee information. Fee structure: `flat`, `valuation_based`, `tiered`, `exempt`, or `unknown`. Low end of the expected permit fee in USD. High end of the expected permit fee in USD. Fee calculation formula if the jurisdiction uses a valuation-based or tiered method. Building/energy code context. Code basis adopted (e.g., `IRC_2021`, `IECC_2021`). Code cycle year or label. Adoption status: `adopted`, `pending`, `partial`, `unknown`. Whether this record is cleared for use in customer-facing quotes. Confidence tier: `high`, `medium`, or `low`. Source traceability. Internal source document reference. URL to the authoritative permit information page. ISO 8601 timestamp of last verification. Always `permit_code_context`. Query summary metadata. Trade filter applied. State filter applied. County filter applied. City filter applied. Number of records returned. Whether results were restricted to quote-safe records. Description of the trust model for this dataset. Permit requirements and fees change frequently. Always verify current fee schedules directly with the AHJ before including permit costs in a customer contract. Records with `quote_safe: false` or non-empty `unresolved_requirements` arrays require manual verification before use in a binding quote. Filter by `quote_safe=true` when populating permit fee line items in a proposal. Use `quote_safe=false` records for internal awareness of jurisdictions that require additional research before closing a job. ## Example Request ```bash cURL theme={null} curl -G https://homeservicedata.org/api/v1/context/permits \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode "trade=hvac" \ --data-urlencode "state=FL" \ --data-urlencode "city=Orlando" \ --data-urlencode "quote_safe=true" ``` ## Example Response ```json theme={null} { "success": true, "data": { "records": [ { "record_id": "pmt_01hzka1bc2de3fg4hi5jk6yzab", "jurisdiction": { "id": "jur_01hzka1bc2de3fg4hi5abcde", "slug": "city-of-orlando-fl", "authority_name": "City of Orlando Building Division", "jurisdiction_type": "city", "state_code": "FL", "county_name": "Orange", "county_fips": "12095", "city_name": "Orlando", "website_url": "https://www.orlando.gov/Building", "permit_portal_url": "https://permits.orlando.gov" }, "trade": "hvac", "permit_type": "mechanical", "requirements": { "permit_required": true, "inspection_required": true, "licensed_contractor_required": true, "registered_contractor_required": false, "preapproval_required": false, "required_documents": ["equipment_spec_sheet", "manual_j_summary"], "unresolved_requirements": [] }, "fees": { "amount_type": "flat", "fee_low": 85.00, "fee_high": 125.00, "formula": null }, "code": { "basis": "FBC_2023", "cycle": "2023", "status": "adopted" }, "quote_safe": true, "confidence": "high", "provenance": { "source_document_id": "doc_01hzka1bc2de3fg4hi5jk6orl", "source_url": "https://www.orlando.gov/Building/Fees", "last_verified_at": "2024-09-10T00:00:00Z", "trust_basis": "permit_code_context" } } ], "coverage": { "trade": "hvac", "state": "FL", "county": null, "city": "Orlando", "records_returned": 1, "quote_safe_only": true, "trust_basis": "Official jurisdiction portals are loaded first; unresolved fee and permit rules return with quote_safe=false." } } } ```