Search Alternative Tenants Availability

Searches for availability across multiple Tenants belonging to the same cross-selling group. For each tenant in the group, resolves availability based on the tenant’s feature configuration (shift time slots or experiences). Errors encountered while resolving individual tenants are silently reported and the tenant is excluded from the result. Each item includes the alternative type and its corresponding availability data.

POST /availability/search/work-days/{date}/shifts/{time}/time-slots

Search Alternative Tenants Availability

cURL

curl --request POST \
  --url https://api-dev.myrestoo.net/v3/availability/search/work-days/{date}/shifts/{time}/time-slots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Restoo-Account-Id: <restoo-account-id>' \
  --header 'Restoo-Partner-Id: <restoo-partner-id>' \
  --data '
{
  "paxChildren": 0,
  "pax": 2,
  "customerUuid": "0199ce9adaab7327bda33ef9f75c123"
}
'

200

{
  "tenants": [
    {
      "business": {
        "name": "Best Burger",
        "phone": "[phone]",
        "whatsapp": "[phone]",
        "email": "[e-mail]",
        "websiteUrl": "https://bestburger.com",
        "bookingsUrl": "https://best-burger.myrestoo.net",
        "menuUrl": "https://bestburger.com/menu",
        "groupMenuUrl": "https://bestburger.com/group-menu",
        "parkingUrl": "https://bestburger.com/parking",
        "address": {
          "line1": "Infinite Loop 1",
          "line2": "Apt. 4B",
          "location": "Apple Campus",
          "city": "Cupertino",
          "state": "California",
          "postalCode": "95014",
          "country": "ES"
        }
      },
      "alternatives": [
        {
          "type": "EXPERIENCES",
          "data": {
            "availability": {
              "isAvailable": false,
              "outcome": "SHIFT_FULL",
              "code": "TENANT_BOOKING_MAX_DATE_NOTICE_EXCEEDED",
              "detail": "Bookings cannot be made more than 30 days in advance.",
              "fallbackOptions": [
                {
                  "action": "CONTACT",
                  "isPreferred": true
                }
              ]
            },
            "floorPlanAreas": [
              {
                "availability": {
                  "isAvailable": false,
                  "outcome": "SHIFT_FULL",
                  "code": "TENANT_BOOKING_MAX_DATE_NOTICE_EXCEEDED",
                  "detail": "Bookings cannot be made more than 30 days in advance.",
                  "fallbackOptions": [
                    {
                      "action": "CONTACT",
                      "isPreferred": true
                    }
                  ]
                },
                "name": "Terrace",
                "summary": "<p>The beautiful terrace of our restaurant.</p>",
                "images": [
                  {
                    "type": "THUMBNAIL",
                    "url": "https://example.com/assets/image.jpg"
                  }
                ],
                "id": 101
              }
            ],
            "shift": {
              "type": {
                "id": "LUNCH",
                "name": "Lunch"
              },
              "firstBookingAt": "2025-03-20T20:00:00+02:00",
              "lastBookingAt": "2025-03-21T01:00:00+02:00",
              "hasExperiences": true,
              "hasAddOns": true,
              "isExperienceRequired": true
            },
            "timeSlots": [
              {
                "availability": {
                  "isAvailable": false,
                  "outcome": "SHIFT_FULL",
                  "code": "TENANT_BOOKING_MAX_DATE_NOTICE_EXCEEDED",
                  "detail": "Bookings cannot be made more than 30 days in advance.",
                  "fallbackOptions": [
                    {
                      "action": "CONTACT",
                      "isPreferred": true
                    }
                  ]
                },
                "startAt": "2025-03-20T20:00:00+02:00",
                "isTimeLimited": true,
                "strollersAvailable": {
                  "type": "LIMITED",
                  "available": 3
                },
                "highChairsAvailable": {
                  "type": "LIMITED",
                  "available": 3
                },
                "experienceId": 123,
                "floorPlanAreaId": 123,
                "turnMinutes": 90
              }
            ],
            "workDay": {
              "date": "2025-03-20"
            }
          }
        }
      ],
      "accountId": "best-burger"
    }
  ]
}

Authorizations

Authorization · string · header · required

All requests must include the static API Key in the Authorization header using the Bearer scheme.

Headers

Restoo-Partner-Id · string · required

Unique identifier of your Partner account (defined by Restoo).

Restoo-Account-Id · string · required

Unique identifier of the Tenant.

Path Parameters

date · string<date> · required

The date for the availability search in ISO 8601 format (YYYY-MM-DD)

Example:

"2025-03-20"

time · string · required

The time for the availability search in ISO 8601 format (HH:MM:SS)

Example:

"22:30:00"

Body

application/json

GetTenantsAvailabilityRequest

Request payload for fetching availability across multiple Tenants.

paxChildren · integer · required

The number of children in the Booking. Available only if the Tenant setting for differentiating adults and children is enabled

Required range: 0 <= x <= 100

Example:

0

pax · integer · required

The number of people (or adults, depending on Tenant settings) in the Booking

Required range: 1 <= x <= 100

Example:

2

customerUuid · string

The Customer UUID.

Include this field only to associate the request with an existing Customer in Restoo

Example:

"0199ce9adaab7327bda33ef9f75c123"

Response

200

application/json

GetTenantsAvailabilityResponse

Response payload containing availability information across multiple Tenants.

tenants · TenantAvailability · object[] · required

Show child attributes