# tourpingo developers

> tourpingo is a marketplace and booking engine for tours, day trips and multi-day trips from local guides and tour operators in many destinations. Its API lets a website or a seller's own system list trips, show live prices and availability, and take bookings. The API is at https://api.stg.vacationpackagesoman.com (staging); the OpenAPI 3.1 spec is at https://docs.stg.vacationpackagesoman.com/openapi.yaml.

Money is always an integer amount in the currency's minor units, with its currency. Prices shown to travellers always come from a quote. Tenancy comes from the key, never from input.

## Get started

- [What you can build](https://docs.stg.vacationpackagesoman.com/get-started/what-you-can-build/): A seller's own booking site on the public API, or a link from a seller's own systems on the seller API.
- [Quick start](https://docs.stg.vacationpackagesoman.com/get-started/quick-start/): See a seller's trips in five minutes, with one website key and two requests.
- [Which key to use](https://docs.stg.vacationpackagesoman.com/get-started/keys/): A website key for a site, a secret key for a seller's own systems, and why you never send a seller's id.
- [Testing on the demo seller](https://docs.stg.vacationpackagesoman.com/get-started/demo-seller/): The demo seller's public website key, the cases its trips cover, and what is safe to try.
- [Go-live checklist](https://docs.stg.vacationpackagesoman.com/get-started/go-live/): What to check before a site takes real bookings.

## Concepts

- [Sellers, sites and channels](https://docs.stg.vacationpackagesoman.com/concepts/sellers-sites-and-channels/): Who sells a trip, where it is sold, and how a booking remembers which.
- [Trips, options and units](https://docs.stg.vacationpackagesoman.com/concepts/trips-options-and-units/): How a trip is built, from the trip a traveller reads about to the travellers and items a quote prices.
- [Availability](https://docs.stg.vacationpackagesoman.com/concepts/availability/): When an option runs, how many places are left, and why the calendar has no prices.
- [Prices and quotes](https://docs.stg.vacationpackagesoman.com/concepts/prices-and-quotes/): Money as integers in minor units, currencies and rates, and why every price a traveller sees comes from a quote.
- [Bookings and holds](https://docs.stg.vacationpackagesoman.com/concepts/bookings-and-holds/): A booking's life, from a 15-minute hold to confirmed, completed or cancelled, and what moves it on.
- [Cancellation and refunds](https://docs.stg.vacationpackagesoman.com/concepts/cancellation-and-refunds/): How a cancellation policy reads, how the refund is worked out, and who can cancel.
- [Travellers' personal data](https://docs.stg.vacationpackagesoman.com/concepts/personal-data/): What the API asks of travellers, what it never gives back, and how your site should handle it.
- [Languages](https://docs.stg.vacationpackagesoman.com/concepts/languages/): The site's languages, a trip's languages, and what to show when they differ.

## Website guides

- [Listing trips](https://docs.stg.vacationpackagesoman.com/websites/listing-trips/): Trip lists, filters, search that forgives typos, and the cities, categories and sellers to filter by.
- [Trip page and calendar](https://docs.stg.vacationpackagesoman.com/websites/trip-page-and-calendar/): Build a trip's page from one request, then show each option's calendar.
- [Quote](https://docs.stg.vacationpackagesoman.com/websites/quote/): Price the traveller's choice, show the quote as it comes, and handle a refusal.
- [Checkout](https://docs.stg.vacationpackagesoman.com/websites/checkout/): Hold the places, take the lead traveller's details and the way to pay, and book.
- [Vouchers and emails](https://docs.stg.vacationpackagesoman.com/websites/vouchers/): What tourpingo sends travellers after they book, and the one setting that links it all to your site.
- [Manage a booking](https://docs.stg.vacationpackagesoman.com/websites/manage-a-booking/): The page where a traveller sees a booking, fills in details, sends a receipt or cancels.
- [Enquiries](https://docs.stg.vacationpackagesoman.com/websites/enquiries/): Questions about a trip, holiday-planner requests and contact messages, sent to the seller.
- [Pages and menus](https://docs.stg.vacationpackagesoman.com/websites/pages-and-menus/): The site's own pages, written by the seller in the portal, and its header and footer menus.
- [SEO](https://docs.stg.vacationpackagesoman.com/websites/seo/): Old addresses that keep working, sitemaps, languages for search engines, and page titles.

## API basics

- [Authentication](https://docs.stg.vacationpackagesoman.com/api/authentication/): The headers each key goes in, sessions, and what a missing or wrong credential gets.
- [Errors](https://docs.stg.vacationpackagesoman.com/api/errors/): The shape of every error, and every code the API answers with.
- [Pagination](https://docs.stg.vacationpackagesoman.com/api/pagination/): Cursors for the trip list, page numbers for search, and limits elsewhere.
- [Retries and idempotency](https://docs.stg.vacationpackagesoman.com/api/idempotency/): Which requests are safe to send again after a timeout, and which are not yet.
- [Rate limits](https://docs.stg.vacationpackagesoman.com/api/rate-limits/): The few limits there are today, the per-key limits that are coming, and how to behave either way.
- [Versioning and changes](https://docs.stg.vacationpackagesoman.com/api/versioning/): What may change within /v1, what never will, and where changes are announced.

## More

- [TypeScript client](https://docs.stg.vacationpackagesoman.com/typescript-client/): The typed client that is coming, and how to work in TypeScript until then.
- [Changelog](https://docs.stg.vacationpackagesoman.com/changelog/): What changed in the public API, newest first.

## Reference

- [API reference](https://docs.stg.vacationpackagesoman.com/reference/): every endpoint, generated from the spec
- [OpenAPI spec, YAML](https://docs.stg.vacationpackagesoman.com/openapi.yaml): the whole contract
- [Public API spec, JSON](https://docs.stg.vacationpackagesoman.com/openapi-public.json): the endpoints websites use
- [Every guide in full](https://docs.stg.vacationpackagesoman.com/llms-full.txt): this list's pages as one text