GETBookings

Get Booking Details

/api/v1/bookings/{bookingNumber}

Retrieve detailed information for a specific booking number belonging to the authenticated partner. The response groups all booked products under items and includes the linked resource details for each item.

Authentication Required

Include Bearer token in Authorization header: Authorization: Bearer YOUR_TOKEN

Path Parameters

Name	Type	Required	Description
`bookingNumber`	`string`	Yes	Unique booking number identifier

Response

Success Response Example:

{
  "success": true,
  "booking": {
    "bookingNumber": "PC2236PAQ",
    "items": [
      {
        "productCode": "P811C6RV",
        "reservationDate": "2026-03-26",
        "reservationTime": "00:00",
        "quantities": [
          {
            "label": "adult",
            "quantity": 2,
            "price": 75
          },
          {
            "label": "child",
            "quantity": 1,
            "price": 40
          }
        ],
        "resource": {
          "code": "RES-LOUVRE-AM",
          "name": "Louvre Morning Entry",
          "type": "ticket"
        }
      }
    ],
    "guests": [
      {
        "title": "Mr",
        "firstName": "John",
        "lastName": "Doe",
        "age": 37
      },
      {
        "title": "Mrs",
        "firstName": "Jane",
        "lastName": "Doe",
        "age": 35
      }
    ],
    "payments": [
      {
        "method": "CREDIT_CARD",
        "amount": 150,
        "currency": "EUR",
        "reference": "txn-2026-03-20-001"
      },
      {
        "method": "VOUCHER",
        "amount": 40,
        "currency": "EUR",
        "reference": "voucher-ABCD-2026"
      }
    ],
    "customerNote": "Wheelchair accessible entrance requested",
    "resellerReference": "RS-TRAVELMATE-9912",
    "resellerSource": "mytravelmate",
    "resellerNote": "VIP customer, prioritize fast check-in",
    "status": "created",
    "customer": {
      "title": "Mr",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+33612345678",
      "email": "[email protected]"
    }
  }
}

Error Response

Error Example:

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Booking not found"
  }
}

Available Errors

HTTP Status	Code	Meaning
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`403`	`FORBIDDEN`	Partner and Booking do not match
`404`	`NOT_FOUND`	Booking not found
`500`	`INTERNAL_SERVER_ERROR`	Failed to retrieve booking

← Back to Home