Sign in
BookingFlow

Starts a booking using the criteria provided (PRIVATE API CREDENTIALS ONLY - DO NOT CALL FROM PUBLIC APPS/WIDGETS).

post/booking/{orderId}/{orderKey}

Path parameters

orderIdinteger required

Numeric order Id.

orderKeystring required

36-character order security key.

Query parameters

interactSessionstring

Optional but recommended customer interaction session. Keep the same session valid for the whole customer interaction journey.

Request body

sendConfirmationEmailboolean

Send confirmation email to customer (default=true)

customerIPstring nullable

Customer IP address (may be used for fraud prevention)

customReferencestring nullable

Optional reference field for the booking (eg. company cost code)

customDataobject nullable

Optional custom data (only for specific use cases)

Example request

{
  "contactInfo": {
    "internalRef": "CUST-123",
    "emailAddress": "joe.bloggs@email.com",
    "telephone": {
      "countryPrefix": "44",
      "number": "0123456789"
    },
    "firstname": "Joe",
    "surname": "Bloggs",
    "company": "ACME Travel",
    "address1": "123 Any Road",
    "city": "Bournemouth",
    "state": "Dorset",
    "postalCode": "BH1 1AB",
    "countryCode": "GB"
  }
}

Response

OK

successboolean

Indicator as to whether API request was successful.

versioninteger nullable

API method version (for information only)

errorsstring[] nullable

Returns a list of errors if success is returned as false.

infostring nullable

Generic information (should not be dislayed to end user or used - informational purposes only).

interactSessionstring nullable

Customer interaction session. This should be cookied for 365-days for an individual customerand is used for personalisation features.

searchSessionstring nullable

Search session identifier which is used throughout a booking journey (e.g. id/guid).

humanReadableSearchRefstring nullable

A human-readable search identifier and can be shown to the end user for telephone enquiries about the current search (can be used by agents to look up the search in admin console)

shareUrlstring nullable

A sharing URL for this search

deeplinkUrlstring nullable

A deeplink URL for this search normally used for abandoned basket email tracking

orderRefDisplaystring nullable

Order reference for displaying to customer.

orderRefstring nullable

Order reference for maintaining a basket (e.g. id/guid).

orderCanAmendboolean nullable

Defines if an order can be amended

hasPreConfirmUrlboolean nullable

Defines if an order has a pre-confirmation URL (eg. Ryanair)

dedupeboolean nullable

Flag to inform front end that it needs to deduplicate results

totalinteger nullable

Total number of suppliers/threads initiated on the booking flow step.

completedinteger nullable

Number of completed suppliers/threads initiated on the booking flow step.

{"stackTrail":"components:schemas:APIResponse:properties:data","oasType":"schema","type":"unknown","description":"Returns generic data","nullable":true}
trackingCodestring nullable

Tracking code (if present)

specialRequestsstring nullable

Special requests

isSessionTimeoutboolean

Flag to inform front end of session timeout

sessionExpirystring date-time nullable

Session expiry date time

Changes

No recorded changes to this endpoint across all 1 revision of this API.