List Bookings

Retrieves a list of bookings based on the provided filters.

GET /bookings

Get Bookings

cURL

curl --request GET \
  --url https://api-dev.myrestoo.net/v3/bookings \
  --header 'Authorization: Bearer <token>' \
  --header 'Restoo-Account-Id: <restoo-account-id>' \
  --header 'Restoo-Partner-Id: <restoo-partner-id>'

200

{
  "data": [
    {
      "privateNotes": "Customer requested a table near the window.",
      "quotedWaitMinutes": 15,
      "isWalkIn": true,
      "hasFixedTables": false,
      "isHighlighted": false,
      "channel": "API",
      "ticketPartner": "DEFAULT",
      "ticketExternalId": "POS-98234",
      "ticketTotalAmount": 12500,
      "tableReadyAt": "2025-03-20T20:15:00+02:00",
      "arrivedAt": "2025-03-20T20:25:00+02:00",
      "seatedAt": "2025-03-20T20:30:00+02:00",
      "endedAt": "2025-03-20T22:15:00+02:00",
      "ip": "192.168.0.25",
      "customer": {
        "privateNotes": "Customer prefers a table near the terrace.",
        "visitFrequency": 30,
        "averageOrderAmountPerPax": 4500,
        "bookingReputation": 0.85,
        "bookingsCount": 25,
        "visitsCount": 18,
        "cancellationsCount": 3,
        "noShowsCount": 2,
        "firstVisitAt": "2023-05-10T20:00:00+02:00",
        "lastVisitAt": "2025-03-15T21:30:00+02:00",
        "firstCancellationAt": "2024-09-12T19:00:00+02:00",
        "nextVisitScheduledAt": "2025-04-05T22:00:00+02:00",
        "tags": [
          {
            "id": 1,
            "name": "VIP",
            "color": "#FF5733"
          }
        ],
        "uuid": "50b5571be67b477baa9dead4b290c555",
        "email": "[e-mail]",
        "phone": "[phone]",
        "birthDate": "1979-03-20",
        "postalCode": "28045",
        "isVip": true,
        "isBusiness": false,
        "language": "en",
        "acceptsImportantAlerts": true,
        "hasGdprConsent": true,
        "acceptsMarketing": true,
        "country": "ES",
        "name": "Steve Jobs"
      },
      "tables": [
        {
          "name": "T101",
          "floorPlanAreaId": 12,
          "posId": "POS-T101",
          "id": 101
        }
      ],
      "uuid": "50b5571be67b477baa9dead4b290c555",
      "bookingAt": "2025-03-20T23:00:00+02:00",
      "status": "CONFIRMED",
      "isTimeLimited": true,
      "customerSpecialRequests": "Table near the window",
      "hasAllergies": true,
      "allergiesDescription": "Peanuts, shellfish, lactose intolerance",
      "specialOccasion": "BIRTHDAY",
      "needsAccessibleSeating": true,
      "hotelRoom": "Room 305",
      "publicNotes": "Your reservation includes a birthday cake.",
      "isReconfirmed": true,
      "isReconfirmedByCustomer": false,
      "cancelReason": "CHANGED_PLANS",
      "bookingPartner": "GOOGLE",
      "bookingExternalId": "book_123456",
      "shiftType": {
        "id": "LUNCH",
        "name": "Lunch"
      },
      "floorPlanArea": {
        "name": "Terrace",
        "id": 101
      },
      "promo": {
        "name": "Summer Discount 2025",
        "id": 101
      },
      "product": {
        "orderItemId": 101,
        "orderUuid": "50b5571be67b477baa9dead4b290c555",
        "currency": "EUR",
        "experienceTickets": 1,
        "id": 101,
        "isGift": true,
        "name": "Gift Card",
        "quantity": 1,
        "taxRate": 1050,
        "type": "ITEM",
        "unitPrice": 7500
      },
      "experience": {
        "tickets": 1,
        "discount": 10.5,
        "experienceId": 123,
        "name": "Premium Menu",
        "pricePerTicket": 7500,
        "currency": "EUR",
        "id": 101
      },
      "cancellationPolicy": {
        "status": "PENDING_SIGNATURE",
        "signDeadlineAt": "2025-03-20T22:00:00+02:00",
        "signedAt": "2025-03-20T21:35:10+02:00",
        "signedFromIp": "203.0.113.10",
        "endedAt": "2025-03-21T23:59:59+02:00",
        "endedBy": "GUEST",
        "chargeStatus": "SUCCEEDED",
        "refundStatus": null,
        "type": "GUARANTEE_AUTHORIZATION",
        "amount": 2500,
        "amountType": "PER_PAX",
        "cancellationNoticeHours": 24,
        "currency": "EUR",
        "cancellationFeeAmount": 5000,
        "chargedAmount": 5000,
        "guaranteedPax": 2,
        "id": 101,
        "refundedAmount": 0
      },
      "addOns": [
        {
          "addOnId": 123,
          "name": "Premium wine tasting",
          "unitPrice": 1000,
          "currency": "EUR",
          "id": 101,
          "quantity": 1
        }
      ],
      "accountId": "best-burger",
      "highChairs": 1,
      "paxChildren": 0,
      "pax": 2,
      "strollers": 1,
      "turnMinutes": 90,
      "createdAt": "2025-03-20T18:45:00+02:00",
      "updatedAt": "2025-03-21T09:30:00+02:00"
    }
  ]
}

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.

Query Parameters

date_start · string<date>

The start date of the search range, in ISO 8601 format (YYYY-MM-DD).

If not provided, defaults to the current date

Example:

"2025-03-20"

date_end · string<date>

The end date of the search range, in ISO 8601 format (YYYY-MM-DD). Must be equal to or later than date_start, and the date range cannot exceed 31 days

Example:

"2025-03-27"

status · string[]

The list of booking statuses to filter the results by.

Accepts multiple values from the BookingStatusEnum

Example:

["CONFIRMED", "SEATED", "CANCELED"]

customer_email · string<email> | null

The Customer's email address

Maximum string length: 255

Example:

"[e-mail]"

customer_phone · string | null

The Customer's phone number in E.164 format

Example:

"[phone]"

Response

200

application/json

data · PrivateBookingResponse · object · required

Full Booking details, including private properties.

PrivateBookingResponse · object[]

PublicBookingResponse · object[]

Show child attributes