Booking Created V1

View JSON Schema

A message that is sent when a booking is created. The message contains information about the booking, the owner of the booking, the facility that the booking was made for and the players that are included in the booking. This event is triggered when a booking is created.This is data part of the message please read the event section for more information of the metadata envelop.

Properties

NameTypeTitleDescriptionRequired
issuerIdstringIssuer IDA unique identifier for the issuer of the booking, in UUID format.Format: "uuid"no
playersobject[]PlayersList of playersyes
ownerobjectOwnerBooking owner informationyes
bookingobjectBookingBooking informationyes
facilityobjectFacilityFacility informationyes

Example

{
    "players": [
        {
            "userId": "550e8400-e29b-41d4-a716-446655440000",
            "email": "john.doe@example.com",
            "isCustomer": false
        }
    ],
    "owner": {
        "customerId": "CUST123456",
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@example.com",
        "address": "123 Main St",
        "city": "Anytown",
        "zipcode": "12345",
        "country": "USA",
        "nationality": "American",
        "cellphone": "+1234567890",
        "telephone": "+0987654321",
        "dateOfBirth": "1980-01-01",
        "gender": "Male",
        "isOrganization": false,
        "doNotEmail": false,
        "registrationDate": "2023-07-04T10:00:00Z"
    },
    "booking": {
        "bookingId": "1234555",
        "startTime": "2024-07-04T10:00:00Z",
        "endTime": "2024-07-04T11:00:00Z",
        "courtId": "C001",
        "courtName": "Main Court",
        "accessCode": "ACCESS1234",
        "splitPayment": true
    },
    "facility": {
        "facilityId": "2344123",
        "facilityName": "Matchi Tennis Club"
    }
}

players[]: Players

List of players

Items: Player

Player information

Item Properties

NameTypeTitleDescriptionRequired
userIdstringUser IDA unique identifier for the player, in UUID format.Format: "uuid"no
emailstringEmailThe email address of the player, in a valid email format.Format: "email"no
isCustomerbooleanIs CustomerIndicates whether the player is a customer.yes

 
Option 1 (optional): Required Properties:

  • userId

 
Option 2 (optional): Required Properties:

  • email

Example

[
    {
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "email": "john.doe@example.com",
        "isCustomer": false
    }
]

owner: Owner

Booking owner information

Properties

NameTypeTitleDescriptionRequired
customerIdstringCustomer IDA unique identifier for the customer.yes
userIdstringUser IDA unique identifier for the user, in UUID format.Format: "uuid"no
firstNamestringFirst NameThe first name of the booking owner.no
lastNamestringLast NameThe last name of the booking owner.no
emailstringEmailThe email address of the booking owner, in a valid email format.Format: "email"no
addressstringAddressThe street address of the booking owner.no
citystringCityThe city where the booking owner resides.no
zipcodestringZipcodeThe postal code of the booking owner’s address.no
countrystringCountryThe country where the booking owner resides.no
nationalitystringNationalityThe nationality of the booking owner.no
cellphonestringCellphoneThe cellphone number of the booking owner.no
telephonestringTelephoneThe telephone number of the booking owner.no
dateOfBirthstringDate of BirthThe date of birth of the booking owner, in YYYY-MM-DD format.Format: "date"no
genderstringGenderThe gender of the booking owner.no
isOrganizationbooleanIs OrganizationIndicates whether the booking owner is an organization.no
doNotEmailbooleanDo Not EmailIndicates whether the booking owner should not receive emails from facility.no
registrationDatestringRegistration DateThe date and time when the booking owner registered, in ISO 8601 format.Format: "date-time"no

Example

{
    "customerId": "CUST123456",
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "address": "123 Main St",
    "city": "Anytown",
    "zipcode": "12345",
    "country": "USA",
    "nationality": "American",
    "cellphone": "+1234567890",
    "telephone": "+0987654321",
    "dateOfBirth": "1980-01-01",
    "gender": "Male",
    "isOrganization": false,
    "doNotEmail": false,
    "registrationDate": "2023-07-04T10:00:00Z"
}

booking: Booking

Booking information

Properties

NameTypeTitleDescriptionRequired
bookingIdstringBooking IDA unique identifier for the booking.yes
startTimestringStart TimeThe start time of the booking, in ISO 8601 format.Format: "date-time"yes
endTimestringEnd TimeThe end time of the booking, in ISO 8601 format.Format: "date-time"yes
courtIdstringCourt IDA unique identifier for the court.yes
courtNamestringCourt NameThe name of the court.yes
accessCodestringAccess CodeA code to access the court.no
splitPaymentbooleanSplit PaymentIndicates whether the booking type is a split payment booking.no

Example

{
    "bookingId": "1234555",
    "startTime": "2024-07-04T10:00:00Z",
    "endTime": "2024-07-04T11:00:00Z",
    "courtId": "C001",
    "courtName": "Main Court",
    "accessCode": "ACCESS1234",
    "splitPayment": true
}

facility: Facility

Facility information

Properties

NameTypeTitleDescriptionRequired
facilityIdstringFacility IDA unique identifier for the facility.yes
facilityNamestringFacility NameThe name of the facility.yes

Example

{
    "facilityId": "2344123",
    "facilityName": "Matchi Tennis Club"
}