{"openapi":"3.1.0","info":{"title":"Fixitrite Enquiry API","version":"1.0.0","description":"Public business information and a consent-based endpoint for sending quote enquiries to Fixitrite. Creating an enquiry does not confirm an appointment.","contact":{"name":"Fixitrite","email":"fixitritegc@gmail.com","url":"https://fixitrite.com.au"}},"servers":[{"url":"https://fixitrite.com.au"}],"paths":{"/api/business":{"get":{"operationId":"getFixitriteBusiness","summary":"Get business, service and service-area information","parameters":[{"name":"location","in":"query","required":false,"schema":{"type":"string"},"description":"Optional Gold Coast suburb or postcode to check."}],"responses":{"200":{"description":"Public Fixitrite business information.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/enquiries":{"post":{"operationId":"createFixitriteEnquiry","summary":"Send a quote enquiry to Fixitrite","description":"Call only after the customer has reviewed the details and explicitly agreed to send them to Fixitrite.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnquiryInput"}}}},"responses":{"201":{"description":"Enquiry saved successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnquiryResult"}}}},"422":{"description":"Invalid or incomplete enquiry."},"429":{"description":"Rate limit exceeded."},"503":{"description":"Enquiry could not be safely stored."}}}},"/v1/businesses":{"get":{"operationId":"listFixitriteBusinesses","summary":"Get the ChatGPT local-services business feed","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"changes_token","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated local business feed."}}}}},"components":{"schemas":{"EnquiryInput":{"type":"object","additionalProperties":false,"required":["fullName","contactPreference","suburb","service","jobDescription","consent"],"properties":{"fullName":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","minLength":8,"maxLength":30},"contactPreference":{"type":"string","enum":["phone","email","sms","whatsapp"]},"suburb":{"type":"string","minLength":2,"maxLength":80},"postcode":{"type":"string","pattern":"^[0-9]{4}$"},"service":{"type":"string","enum":["general_repairs","doors_windows","gyprock","painting","tiling","tv_mounting","carpentry","pet_doors","property_maintenance","electrical_enquiry","other"]},"jobDescription":{"type":"string","minLength":10,"maxLength":4000},"preferredTiming":{"type":"string","maxLength":200},"propertyType":{"type":"string","enum":["house","unit","rental","commercial","other"]},"source":{"type":"string","enum":["website","chatgpt","gemini","webmcp","mcp","a2a","api","other"],"default":"api"},"consent":{"type":"boolean","const":true,"description":"Must be true only after explicit customer confirmation."},"marketingConsent":{"type":"boolean","default":false},"idempotencyKey":{"type":"string","minLength":8,"maxLength":120},"businessId":{"type":"string","default":"fixitrite-mermaid-waters"}},"anyOf":[{"required":["phone"]},{"required":["email"]}]},"EnquiryResult":{"type":"object","required":["accepted","reference","status","message"],"properties":{"accepted":{"type":"boolean","const":true},"duplicate":{"type":"boolean"},"reference":{"type":"string"},"status":{"type":"string","enum":["new"]},"serviceArea":{"type":"object"},"message":{"type":"string"}}}}}}