{"openapi":"3.1.0","info":{"title":"Omaha HVAC Help request API","version":"1.0.0","description":"Omaha HVAC Help is a free referral service, not an HVAC contractor. We review each request and connect you with a local HVAC contractor who can help, and that contractor gives you the quote and does the work. This site is not an emergency service. If you smell gas, hear a CO alarm, or see smoke or fire, leave the house now and call 911 and your gas utility from outside."},"servers":[{"url":"https://omahahvachelp.com"}],"paths":{"/api/v1/leads":{"post":{"summary":"Request a free HVAC quote for an Omaha-area homeowner","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["issue","zip","urgency","name","phone","consent"],"properties":{"issue":{"type":"string","enum":["no_heat","no_cooling","noise_smell","replacement","tune_up","not_sure"]},"zip":{"type":"string","pattern":"^[0-9]{5}$"},"urgency":{"type":"string","enum":["today","this_week","just_looking"]},"notes":{"type":"string","maxLength":1000},"name":{"type":"string","maxLength":60,"description":"First name"},"phone":{"type":"string","description":"US 10-digit phone"},"consent":{"type":"object","required":["granted","text_version","captured_by"],"properties":{"granted":{"type":"boolean","const":true},"text_version":{"type":"string","const":"tcpa-v1-2026-10-22"},"captured_by":{"type":"string","enum":["human","agent_on_behalf"]}}},"turnstile_token":{"type":"string","description":"Sent by the website form when Turnstile is enabled; agents omit it."},"attribution":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"responses":{"201":{"description":"Request received","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"reference":{"type":"string"},"status":{"type":"string"},"next_steps":{"type":"string"}}}}}},"400":{"description":"Validation errors","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Too many requests"}}}}}}