{"openapi":"3.1.0","info":{"title":"Sunrise Adventure Treks","version":"1.0.0","description":"Search trekking and tour packages and submit trip enquiries on behalf of the customer."},"servers":[{"url":"https://sunriseadventuretrek.com"}],"paths":{"/api/gpt/trips":{"get":{"operationId":"searchTrips","summary":"Search approved trekking and tour packages","description":"Use this first to find trips matching what the customer wants. Filter by keywords, difficulty, tour type, max price (USD) and max duration (days). Always call this before discussing specific trips.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Keywords, e.g. \"everest\", \"annapurna\", \"family trek\""},{"name":"difficulty","in":"query","required":false,"schema":{"type":"string","enum":["easy","moderate","strenuous"]}},{"name":"tourType","in":"query","required":false,"schema":{"type":"string"},"description":"Tour type identifier as returned by previous searches"},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum price in USD"},{"name":"maxDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum trip duration in days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"maximum":10}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Matching trips","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"totalPages":{"type":"integer"},"trips":{"type":"array","items":{"$ref":"#/components/schemas/TripCard"}}}}}}}}}},"/api/gpt/trips/{slug}":{"get":{"operationId":"getTripDetail","summary":"Get full details of one trip by slug","description":"Call after searchTrips when the customer picks a trip, to present price, duration, difficulty and details before taking an enquiry.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Trip slug from a searchTrips result"}],"responses":{"200":{"description":"Trip detail","content":{"application/json":{"schema":{"type":"object","properties":{"trip":{"$ref":"#/components/schemas/TripCard"}}}}}},"404":{"description":"No approved trip for this slug"}}}},"/api/gpt/enquiries":{"post":{"operationId":"createEnquiry","summary":"Submit a trip enquiry for the customer","description":"Call only after the customer chose a trip AND explicitly agreed to the Terms of Use and Privacy Policy. Collect fullName, nationality, phoneNumber, email and message first. Never invent customer details.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tripSlug","fullName","nationality","phoneNumber","email","message","termsAccepted"],"properties":{"tripSlug":{"type":"string","description":"Trip slug from searchTrips/getTripDetail"},"fullName":{"type":"string"},"nationality":{"type":"string"},"phoneNumber":{"type":"string"},"email":{"type":"string","format":"email"},"message":{"type":"string","description":"Special requests / enquiry message"},"tripStartDate":{"type":"string","description":"Desired start date, ISO date. Omit if unknown."},"totalTravellers":{"type":"integer","minimum":1,"default":1},"externalIdentifier":{"type":"string","description":"Optional: your own tracking id for async flows. Must be unique — reuse it with the public status endpoint instead of creating duplicates."},"termsAccepted":{"type":"boolean","description":"Must be true. Set only after the customer explicitly agreed to the Terms of Use and Privacy Policy."}}}}}},"responses":{"201":{"description":"Enquiry submitted","content":{"application/json":{"schema":{"type":"object","properties":{"enquiryId":{"type":"string"},"reference":{"type":"string"},"status":{"type":"string"},"tripTitle":{"type":"string"},"tripSlug":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"components":{"schemas":{"TripCard":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"allInclusive":{"type":"boolean"},"facts":{"type":"object","properties":{"priceType":{"type":"string"},"difficulty":{"type":"string"},"duration":{"type":"number","description":"Duration in days"},"tourType":{"type":"string"},"maxGroup":{"type":"number"}}},"price":{"type":"object","properties":{"currency":{"type":"string"},"value":{"type":"number","description":"Price amount"}}},"location":{"type":"object","description":"Destination/region info"},"featuredImage":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"}}}}}}}}