LogoLogo
SupportChangelogAPI ReferenceStatus
Distributor API
Distributor API
  • Welcome
  • Getting Started
    • Functionalities
    • Integration Process
      • Implementation Guide
    • OCTO & Prioticket
      • Feature Comparison
    • Postman & Interactive Documentation
    • Connect Once, Reach the World
      • Featured Suppliers
        • Supplier Overview Europe
        • Supplier Overview Americas
        • Supplier Overview Middle East
      • Featured Resellers
    • Statement on API Excellence
    • Frequently Asked Questions
  • Key Concepts
    • Product Structure
      • Product types and classes
      • Admission types
      • Extra Options
      • Pickup Points
      • Combi, Clusters, Bundles & Addons
        • Cluster
        • Combi
        • Addons
        • Bundle
    • Availability and Capacity
      • Availability
      • Capacity
        • Shared and Allocated Capacity
      • Availability API
    • Pricing Guide
      • Who are you?
      • Configurations
      • Variable Pricing
      • Dynamic Pricing
      • How It All Comes Together
    • Booking Logic
      • Cart Management
      • Payments
      • Cancellation & Refunds
      • Booking Questions
    • Additional Capabilities
      • Locations, Destinations and Categories
      • Recommendations
      • Promotions
      • Webhooks
      • Translations
    • Technical Concepts
      • Authentication
      • Idempotency
      • Rate Limiting
      • Timeout Handling
      • Error Handling
      • API versioning
      • Pagination
      • Formats
      • Headers
      • Caching
  • Endpoints
    • About
    • Authentication
    • System
    • Products
      • Stock
    • Availability
    • Reservations / Cart
      • Promocodes
    • Orders
      • Email & Vouchers
    • Payments
    • Contacts
    • Notifications
    • Models
  • Resources
    • Release notes
    • Roadmap
    • Postman
    • Swagger
    • Changelogs
      • Parameter Changelog
    • API Specs
      • V3.8 (Latest)
      • V3.7
      • V3.6
      • V3.5
    • Support
    • Certification
  • Status Dashboard
Powered by GitBook
On this page
  • Overview
  • Common Considerations for Both APIs
  • Availability & Calculated Pricing API
  • Pricing Variations & Rules API
  • Summary Table

Was this helpful?

Export as PDF
  1. Key Concepts
  2. Availability and Capacity

Availability API

How to show availability on your calendar

PreviousShared and Allocated CapacityNextPricing Guide

Last updated 10 days ago

Was this helpful?

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 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

🔗 API
⚙️ Function
📘 Use Case

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

Caching article
Availability & Calculated Pricing API
Pricing Variations & Rules API
Calendar