Retrieve Excursion Bookings
get
/spms/v2/ships/{shipId}/reservations/{reservationId}/bookedExcursions
This API provides the ability to retrieve Excursion reservations that are linked to the guest/passenger cruise booking
Request
Supported Media Types
- application/json
Path Parameters
Query Parameters
-
bookingDateFrom: string
Booking Date From
-
bookingDateTo: string
Booking Date To
-
excursionBookingId: number
Excursion booking id
-
excursionCode: string
Excursion Code
-
excursionName: string
Excursion Name
-
postingStatus: string
Posting statusAllowed Values:
[ "all", "posted", "unposted", "onhold" ]
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : Booked Excursion Reservation
Type:
object
Title:
Booked Excursion Reservation
Booked Excursion Reservation
Show Source
-
bookedExcursionDetails:
array bookedExcursionDetails
Booked Excursions Detail
-
reservationId:
number
Minimum Value:
1
Pattern:^[0-9]*$
Reservation IdExample:1254985696
Nested Schema : bookedExcursionDetails
Type:
array
Booked Excursions Detail
Show Source
-
Array of:
object bookedExcursionDetail
Booked Excursion Detail
Example:
[
{
"excursionBookingId":"1234",
"excursionName":"DRAGONS CAVES",
"excursionCode":"PMI02",
"excursionDescription":"See the caves with dragons outlook",
"bookingDate":"2009-10-31",
"startTime":"06:59:00.00",
"endTime":"06:59:00.00",
"ticketControlNumber":"EXC01TICKET",
"packageName":"PACSURDO LO",
"ticketPrinted":false,
"bookingComments":"Allergy to nuts",
"netPrice":"99.9",
"grossPrice":"102.9",
"quantity":"3",
"discountPercentage":"3",
"discountAmount":"51.9",
"totalAmount":"90.9",
"prepaidExcursion":true,
"prebookedExcursion":true,
"overnightTour":true,
"payerName":"PAY001 - BA",
"postingStatus":"posted",
"boardcardNumber":"1234567543"
}
]
Nested Schema : bookedExcursionDetail
Type:
object
Booked Excursion Detail
Show Source
-
boardcardNumber:
string
Minimum Length:
1
Maximum Length:50
Boardcard NumberExample:1234567543
-
bookingComments:
string
Minimum Length:
1
Maximum Length:255
Booking CommentsExample:Allergy to nuts
-
bookingDate:
string(ISO 8601)
Booking DateExample:
2009-10-31
-
discountAmount:
number
Minimum Value:
1
Pattern:^[0-9]*$
Discount AmountExample:51
-
discountPercentage:
number
Minimum Value:
1
Pattern:^[0-9]*$
Discount PercentageExample:3
-
endTime:
string(ISO 8601)
End TimeExample:
06:59:00.00
-
excursionBookingId:
number
Minimum Value:
1
Pattern:^[0-9]*$
Excursion Booking IdExample:1234
-
excursionCode:
string
Minimum Length:
1
Maximum Length:50
Excursion CodeExample:PMI02
-
excursionDescription:
string
Minimum Length:
1
Maximum Length:2000
Excursion DescriptionExample:See the caves with dragons outlook
-
excursionName:
string
Minimum Length:
1
Maximum Length:255
Excursion NameExample:DRAGONS CAVES
-
grossPrice:
number
Minimum Value:
1
Pattern:^[0-9]*$
Gross PriceExample:102
-
netPrice:
number
Minimum Value:
1
Pattern:^[0-9]*$
Net PriceExample:99
-
overnightTour:
boolean
Overnight TourExample:
true
-
packageName:
string
Minimum Length:
1
Maximum Length:50
Excursion Package NameExample:PACSURDO LO
-
payerName:
string
Minimum Length:
1
Maximum Length:50
Payer NameExample:GR Gambino
-
postingStatus:
string
Allowed Values:
[ "posted", "unposted" ]
Posting StatusExample:posted
-
prebookedExcursion:
boolean
Excursion PrebookedExample:
true
-
prepaidExcursion:
boolean
Excursion PrepaidExample:
true
-
quantity:
number
Pattern:
^[0-9]*$
Quantity * `null` if emptyExample:1
-
startTime:
string(ISO 8601)
Start TimeExample:
06:59:00.00
-
ticketControlNumber:
string
Minimum Length:
1
Maximum Length:50
Excursion Ticket Control NumberExample:EXC01TICKET
-
ticketPrinted:
boolean
Ticket PrintedExample:
false
-
totalAmount:
number
Minimum Value:
1
Pattern:^[0-9]*$
Total AmountExample:90
204 Response
No Content
400 Response
Bad Request
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Bad Request",
"detail":"The parameter \"bookingDateFrom\" has incorrect format"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
"title":"Unauthorized",
"detail":"Valid token is required to access this resource"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
"title":"Forbidden",
"detail":"Access to this resource was forbidden"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
404 Response
Not Found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"title":"Not Found",
"detail":"This resource path does not exist"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
"title":"Method Not Allowed",
"detail":"HTTP method not supported for this resource"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
406 Response
Not Acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
"title":"Not Acceptable",
"detail":"Request a Mime type that is supported for this Resource"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
"title":"Internal Server Error",
"detail":"Issue fulfilling request. Please retry or contact support"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
"title":"Service not available",
"detail":"Service Unavailable. Try again later"
}
Nested Schema : Error Response
Type:
object
Title:
Error Response
Error Response returned when encountered error
Show Source