Recurrent Bookings

Recurring booking schedules and templates.

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

coachTypestring[]Optional

Filter coaches by type

Example: ["HUMAN","ROBOT"]

Header parameters

user-agentstringRequired

Body

idstringRead-onlyRequired

typestring · enumRequiredPossible values:

statusstring · enumRead-onlyRequiredPossible values:

eventSubtypestring · enumRequiredPossible values:

eventCustomTypestringRequired

eventStatusstring · enumRequiredPossible values:

eventNamestringRequired

eventDescriptionstringRequired

totalTeamsnumber · nullableRequired

teamSizenumber · nullableRequired

maxGuestsnumber · nullableRequired

admissionstring · enumRequiredPossible values:

admissionKidsstring · enumRequiredPossible values:

coachRatenumberRequired

freeSignupCancellationHorizonHoursnumberRequired

tagsstring[]Required

visibilitystring · enumRequiredPossible values:

couponCodestring · nullableWrite-onlyRequired

virtualCreditsnumber · nullableWrite-onlyRequired

bookingModestring · enum · nullableWrite-onlyRequiredPossible values:

paymentMethodstring · enum · nullableWrite-onlyRequiredPossible values:

termsAgreedboolean · nullableWrite-onlyRequired

An optional parameter to tell the User is agreeing the "Terms" along with the booking request.

liabilityWaiverAgreedboolean · nullableWrite-onlyRequired

An optional parameter to tell the User is agreeing the "Liability waiver" along with the booking request.

createAsSeriesbooleanWrite-onlyRequired

chargeStrategystring · enum · nullableRequiredPossible values:

passesStrategystring · enum · nullableRequiredPossible values:

_linksobjectRequired

Responses

201

Returns a RecurrentBookingTaskDto with task ID for polling progress

application/json

idstringRead-onlyRequired

statusstring · enumRead-onlyRequiredPossible values:

totalItemsnumberRead-onlyRequired

completedItemsnumberRead-onlyRequired

createdDatestring · date-timeRead-onlyRequired

updatedDatestring · date-timeRead-onlyRequired

errorstring · nullableRead-onlyRequired

_linksobjectRead-onlyRequired

400

Returns an ErrorDto in case of missing or incorrect request parameter

application/json

403

Returns an ErrorDto in case of a lack of permissions to perform the requested action

application/json

422

Returns an ErrorDto in case of validation errors or failures.

Possible error codes are:
EB001: The coupon {{couponCode}} is not valid.
EB002: The coupon code {{couponCode}} is not valid.
EB003: The coupon {{couponCode}} is not applicable to {{podDisplayName}}.
EB020: The coupon {{couponCode}} cannot be reused.
EB021: The coupon {{couponCode}} is valid only for the first booking.
EB022: The coupon {{couponCode}} is not valid for the selected dates.
EB023: The coupon {{couponCode}} is not applicable to reservations.
EB004: The amount of virtual credits cannot be negative.
EB005: The current account balance does not have virtual credits.
EB006: The amount of virtual credits exceeds the account balance.
EB007: You're not allowed to book free of charge reservations.
EB008: Only admins are authorized to create events.
EB009: Events must be booked as FREE_OF_CHARGE booking mode.
EB010: Events must have an admission rate defined, even if it's zero.
EB011: Invalid total spots number.
EB012: Invalid team size number.
EB013: Only REGULAR, PRIVATE and OPERATIONS events can have CLOSED admission.
EB014: REGULAR and PRIVATE events must have CLOSED admission.
EB000: This action requires a logged in user.
EB015: There's no payment method set up.
EB016: The payment method configured is not active. Please, add a new one.
EB017: User phone number is required.
EB018: Terms of Service agreement is required.
EB019: Invalid free signup cancellation horizon.
EB025: You're not allowed to book cash reservations.
EB026: There was an issue processing the payment for your membership. Please update your payment method to continue booking.
EB027: There was an issue processing the payment for your group membership. Please ask the person paying for the membership to update their payment details to continue using your membership.
EB024: Liability waiver acceptance is required.
EB028: Liability Waiver agreement not found. Please contact support.
EB030: No courts left at the pod during the selected time.
EB031: There's a conflicting reservation at the selected time.
EB032: The selected {{coachTerm}} is not available for this session.
EB033: Invalid session subtype PRIVATE, as there is a {{coachTerm}} selected.
EB034: Invalid session subtype COACHING, as there is no {{coachTerm}} selected.
EB035: Ooops! This booking takes you over the limit of {{maxFreeOffPeakReservationsHours}} hours of free upcoming reservations. You currently have {{userFreeOffPeakReservationsHours}} hours of free upcoming reservations. Please modify in order to stay below.
EB036: Booking can be made for a minimum of 1 hour
EB037: Booking must start sharp on the hour
EB038: Booking time beyond the allowed horizon
EB039: Booking can be made for a maximum of {{count}} hours.
EB040: Unable to proceed with the current payment method. Please try using a different one.
EB041: Prepaid cards are not accepted, please use a credit or debit card.
EB042: You need to cover the full amount with {{virtualCreditsTerm}}.
EB043: Membership is required to make bookings.
EB050: One or more Reservation Play Passes aren't valid for this purchase.
EB051: One or more Reservation Play Passes have expired.
EB052: Only {{maxDailyReservationPasses}} Reservation Play Passes can be redeemed per day. You can continue booking by removing your Play Pass.
EB060: You reached the maximum of {{count}} future reservations.
EB061: Multiple bookings aren't allowed.
BCA00: The selected time is temporarily unavailable, either come back later or pick a different date.
BCA01: There is no room to assign this reservation in contiguous slots, split {{courtsTerm}} is not allowed.
BCA02: There is no room to assign this reservation, please pick a different date.
RA001: Could not confirm the payment. Please try again.

post/bookings/recurrences

POST /apis/v2/bookings/recurrences HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
user-agent: text
Content-Type: application/json
Accept: */*
Content-Length: 2064

{
  "type": "PREVIEW",
  "eventSubtype": "OPERATIONS",
  "eventCustomType": "text",
  "eventStatus": "DRAFT",
  "eventName": "text",
  "eventDescription": "text",
  "eventFeatures": [
    "WAITLIST"
  ],
  "tournamentDivision": {
    "provider": "SWISH",
    "swish": {
      "eventFormat": "rotating_partners_round_robin",
      "gameId": "game123",
      "editPlayersPath": "rotating-partners-round-robin"
    },
    "podplay": {
      "eventFormat": "round_robin",
      "gameId": "game123",
      "url": "https://tournaments.podplay.app/admin/tournaments/game123"
    },
    "lastSyncedAt": "2025-07-09T17:32:26.800Z",
    "visibility": "VISIBLE"
  },
  "totalTeams": 1,
  "teamSize": 1,
  "maxGuests": 1,
  "admission": "OPEN",
  "admissionRate": {
    "regular": 1,
    "membersDefault": 1,
    "memberships": {
      "items": [
        {
          "membership": {
            "id": "text"
          },
          "rate": 1
        }
      ],
      "_total": 1,
      "_links": {
        "self": {
          "href": "text"
        }
      }
    },
    "chargingStrategy": "spot+"
  },
  "admissionDate": {
    "regular": "2026-01-01T00:00:00.000Z",
    "membersDefault": "2026-01-01T00:00:00.000Z",
    "memberships": {
      "items": [
        {
          "membership": {
            "id": "text"
          },
          "date": "2026-01-01T00:00:00.000Z"
        }
      ],
      "_total": 1,
      "_links": {
        "self": {
          "href": "text"
        }
      }
    }
  },
  "admissionRating": {
    "minRating": 1,
    "maxRating": 1,
    "type": "text"
  },
  "admissionKids": "OPEN",
  "allowedMemberships": {
    "items": [
      "text"
    ],
    "_total": 1,
    "_links": {
      "self": {
        "href": "text"
      }
    }
  },
  "coachRate": 1,
  "freeSignupCancellationHorizonHours": 1,
  "picture": {
    "id": "text"
  },
  "tags": [
    "text"
  ],
  "visibility": "LISTED",
  "items": [
    {
      "session": {
        "id": "text"
      },
      "sessionTable": {
        "id": "text"
      },
      "sessionCoach": {
        "id": "text"
      },
      "sessionGuests": {
        "id": "text"
      }
    }
  ],
  "couponCode": "text",
  "virtualCredits": 1,
  "bookingMode": "USER_BOOKED",
  "paymentMethod": "CARD",
  "termsAgreed": true,
  "liabilityWaiverAgreed": true,
  "owner": {
    "id": "text"
  },
  "createAsSeries": true,
  "seriesPriceSettings": {
    "full": {
      "members": {
        "rate": 1,
        "overrides": {
          "items": [
            {
              "membership": {
                "id": "text"
              },
              "rate": 1,
              "_links": {}
            }
          ],
          "_total": 1
        }
      },
      "nonMembers": {
        "rate": 1
      }
    },
    "unit": {
      "members": {
        "rate": 1,
        "overrides": {
          "items": [
            {
              "membership": {
                "id": "text"
              },
              "rate": 1,
              "_links": {}
            }
          ],
          "_total": 1
        }
      },
      "nonMembers": {
        "rate": 1
      }
    }
  },
  "chargeStrategy": "BILL_SPLIT",
  "passesStrategy": "USE_ALL",
  "recurrence": {
    "id": "text",
    "cadence": "day",
    "daysOfWeek": [
      1
    ],
    "untilDate": "2026-01-01T00:00:00.000Z"
  },
  "_links": {}
}

{
  "id": "text",
  "status": "PENDING",
  "totalItems": 1,
  "completedItems": 1,
  "createdDate": "2026-01-01T00:00:00.000Z",
  "updatedDate": "2026-01-01T00:00:00.000Z",
  "result": {
    "recurrence": {
      "id": "text",
      "user": {
        "id": "text"
      },
      "createdDate": "2026-01-01T00:00:00.000Z",
      "cadence": "day",
      "daysOfWeek": [
        1
      ],
      "until": "2026-01-01T00:00:00.000Z",
      "events": {
        "items": [
          "text"
        ],
        "_total": 1,
        "_links": {
          "self": {
            "href": "text"
          }
        }
      },
      "_links": {}
    },
    "bookings": {
      "items": [
        "text"
      ],
      "_total": 1,
      "_links": {
        "self": {
          "href": "text"
        }
      }
    },
    "errors": [
      {
        "code": "text",
        "message": "text",
        "details": {}
      }
    ]
  },
  "error": "text",
  "_links": {}
}

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

taskIdstringRequired

Responses

200

Returns the current status of a recurrent booking task

application/json

idstringRead-onlyRequired

statusstring · enumRead-onlyRequiredPossible values:

totalItemsnumberRead-onlyRequired

completedItemsnumberRead-onlyRequired

createdDatestring · date-timeRead-onlyRequired

updatedDatestring · date-timeRead-onlyRequired

errorstring · nullableRead-onlyRequired

_linksobjectRead-onlyRequired

403

Returns an ErrorDto in case of a lack of permissions to perform the requested action

application/json

404

Returns an ErrorDto if the task is not found

application/json

get/bookings/recurrences/tasks/{taskId}

GET /apis/v2/bookings/recurrences/tasks/{taskId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "status": "PENDING",
  "totalItems": 1,
  "completedItems": 1,
  "createdDate": "2026-01-01T00:00:00.000Z",
  "updatedDate": "2026-01-01T00:00:00.000Z",
  "result": {
    "recurrence": {
      "id": "text",
      "user": {
        "id": "text"
      },
      "createdDate": "2026-01-01T00:00:00.000Z",
      "cadence": "day",
      "daysOfWeek": [
        1
      ],
      "until": "2026-01-01T00:00:00.000Z",
      "events": {
        "items": [
          "text"
        ],
        "_total": 1,
        "_links": {
          "self": {
            "href": "text"
          }
        }
      },
      "_links": {}
    },
    "bookings": {
      "items": [
        "text"
      ],
      "_total": 1,
      "_links": {
        "self": {
          "href": "text"
        }
      }
    },
    "errors": [
      {
        "code": "text",
        "message": "text",
        "details": {}
      }
    ]
  },
  "error": "text",
  "_links": {}
}