{"openapi":"3.0.3","info":{"title":"PearlGraph API","version":"0.2.0","description":"Open, source-backed Uganda tourism data. Indicative only — not live availability, no bookings.","contact":{"name":"Oree Studios Africa","url":"https://api.pearl100.com/support","email":"support@pearl100.com"},"license":{"name":"Apache-2.0"}},"servers":[{"url":"/api/public/v1"}],"paths":{"/attractions":{"get":{"summary":"Search attractions","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Attractions"}}}},"/fees":{"get":{"summary":"UWA tariffs","parameters":[{"name":"ids","in":"query","schema":{"type":"string"},"description":"Comma-separated fee ids"}],"responses":{"200":{"description":"Fees"}}}},"/route":{"get":{"summary":"Road route & drive time","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"month","in":"query","schema":{"type":"integer","minimum":1,"maximum":12}}],"responses":{"200":{"description":"Route"},"404":{"description":"Unknown place"}}}},"/permits":{"get":{"summary":"Permit quotas per sector and access rules","parameters":[{"name":"attraction","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Quotas and rules"}}}},"/flights":{"get":{"summary":"Airstrips and domestic flights","parameters":[{"name":"to","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Airstrips and flights"}}}},"/ferries":{"get":{"summary":"Lake and river ferries","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Ferries"}}}},"/seasons":{"get":{"summary":"Dry & wet seasons","responses":{"200":{"description":"Seasons"}}}},"/operators":{"get":{"summary":"Institutions & operators","parameters":[{"name":"region","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Operators"}}}},"/districts":{"get":{"summary":"All districts with tourism highlights","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Districts"}}}},"/lodges":{"get":{"summary":"Lodges near attractions (no prices)","parameters":[{"name":"near","in":"query","schema":{"type":"string"}},{"name":"tier","in":"query","schema":{"type":"string"}},{"name":"district","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Lodges"}}}},"/essentials":{"get":{"summary":"Visa, health, money, transport, safety (audience=foreign|local)","parameters":[{"name":"audience","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Essentials"}}}},"/plan":{"post":{"summary":"Plan (stops) or check (days) an itinerary","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["start"],"properties":{"start":{"type":"string"},"month":{"type":"integer"},"stops":{"type":"array","items":{"$ref":"#/components/schemas/Stop"}},"days":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/Stop"}}}}}}}},"responses":{"200":{"description":"Plan"},"400":{"description":"Invalid body"}}}}},"components":{"schemas":{"Stop":{"type":"object","required":["attractionId","activityId"],"properties":{"attractionId":{"type":"string"},"activityId":{"type":"string"}}}}}}