Developer API
Xtrip TOS · REST API v1
Build on the Xtrip travel platform
The Xtrip API connects the systems inside our travel group — including the YesRentals self-drive fleet network — and approved distribution partners. Tours, departure dates and pricing flow between systems automatically, so self-drive packages and guided tours stay in sync. Responses are JSON, CORS-enabled and cached at the edge.
Edge-served
Low-latency responses from a global serverless runtime.
Ecosystem integration
Links Xtrip tours with the YesRentals fleet for self-drive packages.
Privacy by design
Only public product data — never customer records.
Real-time data
Price or availability changes in the operations console appear instantly.
Endpoints
/api/public/v1/toursList all on-sale tours with bilingual titles, prices (NZD), duration, destinations and departure dates.
| Parameter | Required | Description |
|---|---|---|
| slug | optional | Return a single tour by its slug |
/api/public/v1/ratesExchange rates with NZD as base (AUD, USD, CNY), refreshed hourly.
Quick start
curl -s "https://xtrip.co.nz/api/public/v1/tours?slug=north-island-3-day"
const res = await fetch("https://xtrip.co.nz/api/public/v1/tours");
const { count, data } = await res.json();
data.forEach(t => console.log(t.title, t.price));Response codes
| 200 | OK — request succeeded |
| 204 | No Content — CORS preflight |
| 404 | Not Found — unknown endpoint |
| 500 | Service unavailable — retry later |
Partner access & rate limits
Public endpoints are free for reasonable use and every request is monitored. For higher volumes, webhooks or booking-write access, contact info@yesgo.co.nz.