POST Bookings

Overview

Create a new booking

Request

POST /Bookings

Request Information

Request Parameters

Name
Type
Requirement
Description
currency
String
Mandatory 
Currency
agentReferenceNumber
String
Optional 
Agent's reference number
bookingNote
String
Optional 
General booking note
storeAgentCode
String
Optional 
Agent’s Code that is creating the booking through a wholesale agent
travelConsultantFirstName
String
Optional 
Travel Consultant First Name
travelConsultantSurname
String
Optional 
Travel Consultant Surname
storeAgentEmail
String
Optional 
Store Agent Email - Applicable only with Agent Company API Key
rEISession
String
Optional 
REI Booking Request Parameter - REI Session (Cookie)
rEIMemberNumber
String
Optional 
REI Booking Request Parameter - REI Member Number
rEIMemberValidateSource
String
Optional 
REI Booking Request Parameter - REI Member Validate Source

Request Example

{
  "currency": "gbp",
  "agentReferenceNumber": null,
  "bookingNote": null,
  "storeAgentCode": null,
  "travelConsultantFirstName": "Phil",
  "travelConsultantSurname": "Maye",
  "storeAgentEmail": "storeagent@testmail.com",
  "rEISession": "example_cookie_value_123",
  "rEIMemberNumber": "MBR-2025-000123",
  "rEIMemberValidateSource": "REI"
}

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": "bookings/887124"
}