POST Trips by context, contextId

Overview

Create trip on a booking

Request

POST /[context]/[contextId]/Trips

Request Information

Request Parameters

Name
Type
Requirement
Description
context
String
Mandatory 
Context in Request URI should be 'bookings'
contextId
Integer
Mandatory 
ContextId in Request URI should be Booking ID
departureCode
String
Mandatory 
The Intrepid alphanumeric code for the departure
promotionCode
String
Optional 
The Intrepid alphanumeric code for the promotion
customers
List<HrefWrapper>
Mandatory 
URIs of customers to book on the trip that has already been added to booking
These URIs may optionally include one or more of the following query string parameters to control what they are booking on the trip:
• status=tentative
Tentatively book the customer on the trip and the single supplement (if applicable)
• singleSupplement=true
Book a single supplement for the customer on the trip

Customers

Name
Type
Requirement
Description
href
String
Optional 
URI of the resource

Request Example

{
  "departureCode": "TTSN180408",
  "promotionCode": "12323",
  "customers": [
    {
      "href": "/bookings/5057124/customers/4945398?status=tentative&singleSupplement=true"
    },
    {
      "href": "/bookings/5057124/customers/4945398?status=tentative&singleSupplement=true"
    }
  ]
}

Response Information

Response Properties

Name
Type
Description
id
Integer
ID of the resource
href
String
URI of the resource

Response Codes

HTTP status code
Description
200 OK
The resource was updated successfully
201 Created
The resource was created
400 Bad Request
The resource was malformed
401 Unauthorized
Missing or invalid API key
500 Internal Server Error
An unexpected error occurred on the API server
202 Accepted
The request was accepted
404 Not Found
The specified resource was not found
403 Forbidden
One or more parameters has already been set on the resource record and cannot be updated

Response Example

{
  "id": 887124,
  "href": "context/contextid/trips/887124"
}