Single Supplement Services

A SingleSupplementService is a booked instance of a single supplement product.

XML Schema:

GET: Get a Single Supplement Service

POST: Create a Single Supplement Service

Fields

Name Type Description
id read-only String  
href read-only Field  
name read-only String The name of this service.
status String

The current status of the service:

  • Option: The service is being held on option until the option_expiry_date. No deposit or payment is required to hold an option. An Option service can be Expired or Confirmed.
  • On Request: The service has been requested by the client, but the request has not been sent to the local office. All departures with availability status REQUEST_SPACE can not be put on Option, but must be requested. Full payment is required. An On Request service can be Expired with no cancellation fees applied.
  • Request Confirmation: The service has been requested by the client, and the request has been sent by G Adventures to the local office. A Request Confirmation service can be Cancelled with cancellation fees applied.
  • Confirmed: The service is confirmed. Deposit is always required to confirm, and full payment will be required for a departure where FULL_PAYMENT_REQUIRED_TO_BOOK is present in the flags field. A Confirmed service can be Cancelled with cancellation fees applied.
  • Waitlisted: The service is in a waitlist queue. A cancellation on the product will cause the service to automatically be moved to Option. Only product with availability status WAIT_LIST can be Waitlisted. A Waitlisted service can be Cancelled with no cancellation fees applied.
  • Expired: The service is expired. An Option or On Request service is Expired at midnight EST when it reaches its option_expiry_date. A Waitlisted service can be Expired at any time, but will automatically be Expired when a departure reaches availability status REQUEST_SPACE. No cancellation fees will be applied.
  • Request Cancellation: The service has been requested to be Cancelled. Cancellation fees will be applied when it is Cancelld by G Adventures staff (if applicable).
  • Cancelled: The service is cancelled. A Request Confirmation or Confirmed service can be cancelled with cancellation fees applied.

Active service status transitions:

  • Option –> Confirmed/Expired
  • On Request –> Request Confirmation/Expired
  • Request Confirmation –> Request Cancellation
  • Confirmed –> Request Cancellation
  • Waitlisted –> Expired
status_transitions read-only List A list of status values to which this services can transition.
type read-only String The type of this resource.
sub_type read-only String A brief description of the services type.
start_date read-only Date The start date of the services.
finish_date read-only Date The finish date of the services.
customers Field  
  • id read-only
String  
  • href read-only
Field  
  • name
Nested Object  
    • legal_first_name required
String Legal first name as it appears on a passport.
    • legal_middle_name
String Legal middle name as it appears on a passport.
    • legal_last_name required
String Legal last name as it appears on a passport.
    • common_name
String The name this person likes to be called if different from their legal name.
    • title required
String The title. Valid values are: Mr, Mrs, Ms, and Miss
date_created read-only Datetime The date this services had its service status set to Confirmed, in the standard Dates & Times.
date_confirmed read-only Datetime The date this services had its service status set to Confirmed, in the standard Dates & Times.
date_cancelled read-only Datetime The date this services had its service status set to Cancelled, in the standard Dates & Times.
option_expiry_date read-only Datetime The date/time at which an Option service status will automatically be set to Expired, in the standard Dates & Times.
purchase_price read-only Decimal The currency-specific purchase price this services was Confirmed at, in the standard Currencies & Prices. The price is not locked until the services has its service status set to Confirmed (i.e. the price could change when the service status is on Option).
commission read-only Decimal The currency-specific commission amount that the booking agent will receive for this services, in the standard Currencies & Prices.
applied_promotion Nested Object  
  • id read-only
String  
  • href read-only
Field  
  • name
String The name of the promotion used.
  • promotion_code
String A unique code for this promotion.
  • discount_amount
Decimal The currency-specific amount that has been discounted from the purchase_price. Add the discount_amount and purchase_price to see the original non-discounted price.
  • commission_rate
Integer The commission rate for this promotion.
  • terms_and_conditions
String The promotion applied to this services.
flags read-only List

A list of codes that, when present, require special considerations for a booked services.

The list of departure service flags related to the current status of a request to hike the Inca Trail, or the option booked for services on these special departures:

Service Status Flags

  • SUSPENDED: This departure service has been suspended due to mitigating circumstances out of G Adventures’ control and will not be departing.

Inca Trail Flags

  • ON_INCA_TRAIL: Inca Trail permits have been obtained for all travellers on this services.
  • REQUESTING_INCA_TRAIL: A request to hike the Inca Trail has been submitted. The permits have not yet been obtained for travellers on this services.
  • ON_LARES_TREK: All travellers on this services will be hiking the Lares Trek as the Inca Trail is not available.
  • CUZCO_STAY: All travellers on this services will stay in Cuzco, as either they have chosen this option or the Inca Trail permits are not available for this departure.
  • INCA_TRAIL_UNKNOWN: A request to the local office has been made to confirm availability and additional local intricacies. This is an intermediary state which can occur before REQUESTING_INCA_TRAIL and any of the other states.
booking read-only Reference Object  
documents read-only Field  
  • id read-only
String  
  • href read-only
Field  
  • date_created required
Datetime The time when the resource was created, in the standard Dates & Times.
  • type read-only
String The document type, currently: INVOICE, ATOL_CERTIFICATE, VOUCHER.
  • audience read-only
String The intended audience of this document. Either AGENT or CUSTOMER.
  • booking read-only
Reference Object The related booking resource.
  • mime_type read-only
String The Internet media type.
declined_reason read-only Reference Object The related declined reason resource.
product read-only Reference Object A reference to the product itself
associated_services List  

Get a Single Supplement Service

GET /single_supplement_services/(string: service_id)/

Create a Single Supplement Service

POST /single_supplement_services/

Example request:

POST /single_supplement_services/ HTTP/1.1
Host: rest.gadventures.com
Accept: application/json
Content-Type:application/json

{
    "customers": [
        {
            "id": "1322877"
        }
    ],
    "booking": {
        "id": "628134"
    },
    "product": {
        "id": "T372707"
    }
}

Example response:

HTTP/1.1 201 CREATED
Content-Type: application/json

{
    "id": "s1161976_0",
    "href": "/single_supplement_services/s1161976_0",
    "name": "Costa Rica Quest",
    "status": "Option",
    "type": "single_supplement_services",
    "sub_type": "Single Supplement",
    "start_date": "2013-11-30",
    "finish_date": "2013-12-08",
    "customers": [
        {
            "id": "1322877",
            "href": "/customers/1322877",
            "name": {
                  "legal_first_name": "Typecase",
                  "legal_last_name": "Lobstick",
                  "legal_middle_name": null,
                  "common_name": null,
                  "title": "Mr"
            }
        }
    ],
    "date_created": "2013-08-13T19:16:06Z",
    "date_confirmed": null,
    "date_cancelled": null,
    "option_expiry_date": null,
    "purchase_price": "1398.00",
    "commission": null,
    "applied_promotion": null,
    "flags": [],
    "booking": {
        "id": "628134",
        "href": "/bookings/628134"
    },
    "documents": null,
    "product": {
        "id": "T417193",
        "href": "/single_supplements/T417193",
        "name": "My Own Room"
    }
}