Booking Logic

How to Book with the Prioticket Distributor API

With the Prio Distributor API, connecting to our platform and processing bookings couldn’t be easier. Whether you’re looking to browse product content, check live availability, or confirm bookings in real-time, our API offers a streamlined process designed for travel resellers, marketplaces, and OTAs.

This page explains the end-to-end booking flow, giving you a clear roadmap to building your integration, from retrieving content to issuing tickets.

The Four Pillars of the Prio Distributor API

The Distributor API is divided into four core areas, each designed to handle a key part of the booking journey:

🔗 API Type	💡 What It Does
Content APIs	Retrieve products, destinations, categories, and other key product details to populate your platform.
Availability APIs	Check real-time availability, capacity, and time slots for the products you want to sell.
Reservation APIs	Temporarily hold reservations while you collect payment or manage a shopping cart.
Booking APIs	Confirm reservations, create direct bookings, and retrieve barcodes/tickets for your guests.

Additional APIs for Full Flexibility

🔗 API Type	💡 What It Does
Authentication APIs	Secure your connection using OAuth-based credentials.
Payment APIs	Use Prioticket’s Payment Service Provider integrations (optional) or handle payments yourself.
Contact APIs	Manage guest profiles (only needed for recurring guests).
Notification APIs	Set up webhooks to receive real-time updates on external booking changes.
System APIs	Monitor API uptime and system health.

Create a booking

To book a product through this API, you generally need to follow these steps:

1. Check availability and pricing: Use the Get Products and Get Availabilities endpoints to verify if tickets for the desired tour or activity are available for a specific date, time, and quantity.

2. Request a booking hold: If tickets are available, request a pricing / availability hold for the booking using the Create Reservation endpoint.

3. Collect payment: Once a booking hold is requested, collect payment either through the provided payment endpoints or via your own payment service provider.

4. Confirm the booking: Finalize the booking by confirming it using the confirm order endpoint.