Availability API
How to show availability on your calendar
Last updated
Was this helpful?
How to show availability on your calendar
Last updated
Was this helpful?
The Prioticket platform provides two key APIs that deliver true real-time availability and pricing data for products and services, ensuring the most accurate and up-to-date booking experience:
Availability & Calculated Pricing API — provides real-time availability and final calculated pricing for booking flows. It is recommended for all products and mandatory for products with managed capacity.
Pricing Variations & Rules API — returns detailed pricing rules, variations, and conditions that explain how prices change in real time, enabling transparent and dynamic pricing presentations.
Depending on the product_availability
parameter defined in the product feed, availability must be requested via these APIs before making a booking to guarantee accuracy and prevent overbooking or pricing errors.
Together, these APIs ensure efficient, reliable, and user-friendly booking and pricing experiences with up-to-the-second data.
Timezone & DST: Dates and times are relative to the supplier’s timezone and automatically adjusted for Daylight Saving Time.
Date Range Limits: Maximum 90 days per query. For longer periods, split requests into smaller date ranges.
Performance:
Response times depend on product source: Prioticket-sourced products generally respond faster than third-party systems.
Avoid requesting availability/pricing for multiple products across very long date ranges in a single call to maintain performance.
Caching:
Avoid long-term caching of availability and pricing data as they are dynamic and change in real time.
For detailed caching guidelines and best practices, see the full in our technical documentation.
Booking Logic: Both APIs reflect the system’s managed capacity, partial availability, and grouped availability rules.
You’ll receive:
Availability & Pricing per time slot
Total capacity
Remaining inventory
Refer to the response schema for full details.
Returns real-time availability and calculated final pricing based on the product configuration and party size.
Simplified Pricing: Returns the exact final price for a booking without requiring client-side price calculations.
UI Friendly: Combines availability and pricing in a single call, making it ideal for rendering calendars and booking flows.
Efficient Booking Flow: Reduces client-side complexity and minimizes errors during booking validation.
To get both availability and pricing with minimal overhead, we suggest calling this endpoint twice in your flow:
Make a call without a request body to fetch:
All time slots
Default pricing per ticket type (usually for quantity = 1)
Day or time-based pricing if applicable
Use this response to render your calendar and timeslot UI with pricing.
Make a second call including:
Party size
Ticket selections or quantities
This returns the final calculated price for the configured booking.
Returns detailed pricing rules, variations, and conditions explaining how prices change for a product.
Detailed Pricing Insights: Provides granular breakdowns of pricing rules and conditions.
Transparency: Enables you to explain complex pricing logic clearly to end users.
Advanced UI Support: Supports building interfaces that dynamically respond to pricing rules (e.g., discounts, time-based pricing).
Business Logic Integration: Allows triggering custom behaviors based on pricing conditions, improving flexibility.
Availability & Calculated Pricing
Real-time availability + final price
Booking flows, calendar rendering, booking validation
Pricing Variations & Rules
Detailed pricing rules & logic
Pricing transparency, advanced UIs, business logic