Batch Update availability for a specific product and time period. This will update availability for all the sessions that start in that time range.
Product code is optional, all sessions for all products will be updated if it is empty.
You can use this service to blackout periods (I.e. set availability to 0 for a full day).
Maximum range is one week.
This can only update sessions from products with InventoryMode = SESSION_SEATS.

{
    "startTime": "2014-11-11T00:00:00Z",
    "endTime": "2014-11-11T23:59:59Z",
    "productCode": "P123456",
    "seatsAvailable": "0"
}
OR
{
    "startTime": "2014-11-11T00:00:00Z",
    "endTime": "2014-11-11T23:59:59Z",
    "productCode": "P123456",
    "seats": "30"
}
OR
{
    "startTime": "2014-11-11T00:00:00Z",
    "endTime": "2014-11-11T23:59:59Z",
    "productCode": "P123456",
    "priceOptions": [
       {
         "price": 90,
         "label": "Adult"
       }
     ]
}
If you send 'seatsAvailable', sessions will be updated for the current availability to become this number.
If you send 'seats', the total seats capacity of sessions will be updated, regardless of how many are already booked.
If you send both, only seatsAvailable will be used.
If you send priceOptions, they will override the default price options of the existing session.

Request

POST https://api.rezdy.com/v1/availability/batch

Request body

The request body takes a complete SessionUpdateBatchRequest resource, containing the following writable properties:

{
    "allDay": "boolean",
    "endTime": "date-time",
    "endTimeLocal": "string",
    "priceOptions": [
        {
            "id": "int64",
            "label": "string",
            "maxQuantity": "int32",
            "minQuantity": "int32",
            "price": "float",
            "priceGroupType": "string",
            "productCode": "string",
            "seatsUsed": "int32"
        }
    ],
    "productCode": "string",
    "seats": "int32",
    "seatsAvailable": "int32",
    "startTime": "date-time",
    "startTimeLocal": "string"
}

Properties

Name Type Description Additional
allDay boolean

If true, this session lasts all day and no time should be shown to customers. Technically the session will be from midnight to midnight.

Optional
endTime date-time

Batch update end interval

Optional
endTimeLocal string

Batch update end interval in supplier's local timezone.

Optional
priceOptions[] array

List of price options, which will override the product level price. Price options have to be a subset of the product price options, thus you can not create new price options, use product update service to do so.

Optional
priceOptions[].id int64 Optional
priceOptions[].label string

Label for this price (I.e. "Adult", "Child")

Optional
priceOptions[].maxQuantity int32

Max booking quantity for the product price option. Can be specified, if the price option is fixed or a grouptype. For a successful booking of the product, the number of participants for this price option have to be lesser or equal than this value.

Optional
priceOptions[].minQuantity int32

Min booking quantity for the product price option. Can be specified, if the price option is fixed or a group type. For a successful booking of the product, the number of participants for this price option have to be greater or equal than this value.

Optional
priceOptions[].price float

Price amount (I.e. "200.00")

Optional
priceOptions[].priceGroupType string

If this price is for a group, is the price for the whole group (TOTAL) or per quantity (EACH)

Possible values are:

  • EACH
  • TOTAL
Optional
priceOptions[].productCode string

Product code to which the price options belongs to. Since Rezdy introduced shared availability option for products, the product sessions can contain price overrides for all of the products, which share the sessions. Therefore it is necessary to filer only the price options matching the chosen product code on the client side, when processing /availability service responses.

Optional
priceOptions[].seatsUsed int32

How many seats one quantity of this price willuse. Used for availability calculations. For example 1 quantity of "Family of 4" will use 4 seats.

Optional
productCode string

Rezdy unique productCode linked to this session

Required
seats int32

Update the total number of seats for this session. The total seats does not change after a booking is made. The total number of seats can not be less than 0.

Optional
seatsAvailable int32

Update the current availability for this session. The session total number of seats after updating the seats available can not be less than 0.

Optional
startTime date-time

Batch update start interval

Optional
startTimeLocal string

Batch update start interval in supplier's local timezone.

Optional

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

successful operation

ResponseSessionList

Explore this API

apiKey Enter your API Key to try this call
body

Session data must only include one of seats, seatsAvailable or price options.

Request Content-Type
Response Content-Type
Try it out!