Availability API
How to show availability on your calendar
Overview
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.
Common Considerations for Both APIs
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 Caching article in our technical documentation.
Booking Logic: Both APIs reflect the system’s managed capacity, partial availability, and grouped availability rules.
Response Structure
You’ll receive:
Availability & Pricing per time slot
Total capacity
Remaining inventory
Refer to the response schema for full details.
Purpose
Returns real-time availability and calculated final pricing based on the product configuration and party size.
Benefits of This Endpoint
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.
Recommended Usage Pattern
To get both availability and pricing with minimal overhead, we suggest calling this endpoint twice in your flow:
1. Initial Call (No Request Body)
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.
2. Final Price Calculation (With Body)
Make a second call including:
Party size
Ticket selections or quantities
This returns the final calculated price for the configured booking.
Purpose
Returns detailed pricing rules, variations, and conditions explaining how prices change for a product.
Benefits of This Endpoint
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.
Summary Table
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
Last updated
Was this helpful?