Skip to main content

​
Owner Bookings API

As a venue owner, you can view all bookings made at your venues. These endpoints provide visibility into your business operations and help you track resource utilization.

​
List All My Venue Bookings

Retrieve all bookings across all venues you own, with pagination support. 
curl -X GET "https://api.hub.com/api/owner/bookings?page=0&size=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Query Parameters

​
page
integer
default:"0"
Page number (0-indexed)
​
size
integer
default:"20"
Number of bookings per page

​
Response

​
id
string (UUID)
required
Unique identifier for the booking
​
resourceId
string (UUID)
required
ID of the booked resource (court)
​
playerId
string (UUID)
required
ID of the player who made the booking
​
bookingDate
string (date)
required
Date of the booking (ISO 8601 format: YYYY-MM-DD)
​
startTime
string (time)
required
Start time of the booking (HH:mm:ss)
​
endTime
string (time)
required
End time of the booking (HH:mm:ss)
​
pricePaid
number
required
Amount paid by the player
​
currency
string
required
Currency code (e.g., EUR, USD)
​
status
string
required
Booking status: CONFIRMED, CANCELLED, EXPIRED
​
paymentStatus
string
required
Payment status: PENDING, PAID, FAILED, REFUNDED
​
resourceName
string
Name of the booked resource
​
venueName
string
Name of the venue
​
venueCity
string
City where the venue is located

​
Example Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "resourceId": "660e8400-e29b-41d4-a716-446655440001",
    "playerId": "770e8400-e29b-41d4-a716-446655440002",
    "bookingDate": "2026-03-15",
    "startTime": "10:00:00",
    "endTime": "11:30:00",
    "pricePaid": 25.00,
    "currency": "EUR",
    "status": "CONFIRMED",
    "paymentStatus": "PAID",
    "resourceName": "Court 1",
    "venueName": "Padel Club Madrid",
    "venueCity": "Madrid"
  }
]

​
List Bookings for Specific Venue

Retrieve all bookings for a specific venue you own. 
curl -X GET "https://api.hub.com/api/owner/venues/{venueId}/bookings?page=0&size=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Path Parameters

​
venueId
string (UUID)
required
ID of the venue to retrieve bookings for

​
Query Parameters

​
page
integer
default:"0"
Page number (0-indexed)
​
size
integer
default:"20"
Number of bookings per page

​
Response

Returns an array of booking objects with the same structure as “List All My Venue Bookings”.

​
Understanding Booking Status

Bookings can have different statuses throughout their lifecycle:

​
Status Values

  • CONFIRMED: Booking is active and the player is expected to show up
  • CANCELLED: Booking was cancelled by the player
  • EXPIRED: Booking was not paid in time and expired

​
Payment Status Values

  • PENDING: Payment is being processed
  • PAID: Payment completed successfully
  • FAILED: Payment failed
  • REFUNDED: Payment was refunded (typically after cancellation)
Bookings are paginated to improve performance. Use the page and size parameters to navigate through large result sets. The default page size is 20 bookings.

​
Use Cases

​
Revenue Tracking

Sum the pricePaid field for all bookings with paymentStatus: PAID to calculate your revenue. 
const paidBookings = bookings.filter(b => b.paymentStatus === 'PAID');
const totalRevenue = paidBookings.reduce((sum, b) => sum + b.pricePaid, 0);
console.log(`Total Revenue: ${totalRevenue} ${bookings[0]?.currency}`);

​
Resource Utilization

Track which resources are most popular by grouping bookings by resourceId.

​
Daily Schedule

Filter bookings by bookingDate to see your schedule for a specific day. 
const todayBookings = bookings.filter(
  b => b.bookingDate === '2026-03-15' && b.status === 'CONFIRMED'
);
Owner endpoints provide read-only access to booking information. Owners cannot create or cancel bookings on behalf of players. Only players can create and cancel their own bookings.

Build docs developers (and LLMs) love

Get started for freeTalk to us