Coras API Integration Guide for Distributors

This guide walks developers through integrating with the Coras Exchange API to offer theater tickets, tours, and attraction bookings to their customers.

API Version: v2 Base URL: https://sandbox.coras.io/v2 (sandbox) / https://api.coras.io/v2 (production) Full API Reference: https://developer.coras.io/docs/api/

Prerequisites

Before you begin, ensure you have:

• Distributor ID — a UUID provided by your Coras account manager (e.g., f71bcdcb-9605-4514-94b6-8e8ccf1ce223). This is required in every API request.
• Stripe Publishable Key — provided by Coras for payment processing. This can be retrieved via the API (see Get config).
• Sandbox Access — all development should start against https://sandbox.coras.io/v2.

Table of Contents

1. Architecture Overview
2. Authentication & Headers
3. Integration Flow
   • Step 1: Create a Booking Session
   • Step 2: Discover Available Content
   • Step 3: Search Attractions
   • Step 4: Get Attraction Details
   • Step 5: Reserve Tickets
   • Step 6: Handle Attendee Data
   • Step 7: Review Reservation Summary
   • Step 8: Confirm & Pay (async and sync flows)
   • Step 9: Poll Transaction Status (async flow only)
   • Step 10: Cancel Reservations (Optional)
4. Theater-Specific Flows
5. Tour-Specific Flows
6. Payment Integration (Stripe)
7. Error Handling
8. Pricing & Currency
9. Localization
10. Best Practices
11. Appendix & Deprecated Endpoints