Service Cancellation Terms¶

The Service Cancellation Terms resource represents the concrete, amount-based cancellation terms that currently apply to a specific departure service. Where Cancellation Terms and Flex Cancellation Terms are percentage-based, this resource resolves each window into absolute refund and Future Travel Credit (FTC) amounts based on the actual purchase price of the covered services.

The resource is keyed by the departure service: its id is the id of the Departure Service it applies to. The resource is only available for departure services on bookings with a Flex Plan Service.

Which terms apply¶

The terms field is a polymorphic reference identifying the source of the currently applicable terms:

Warning

Service Cancellation Terms for bookings without a Flex Plan Service will return a 404 response.

Generic terms - terms.type is cancellation_terms and terms.terms references the departure’s generic Cancellation Terms (whose id matches the departure id).
Flex terms - as soon as a Flex Plan Service covers the departure service, terms.type switches to flex_cancellation_terms and terms.terms references the plan’s Flex Cancellation Terms (whose id matches the flex plan id).

Re-fetch this resource after purchasing Flex to display the upgraded terms. Once resolved for the service, the amounts reflect the covered services’ purchase price; subsequent changes to departure-level terms do not retroactively alter what a customer agreed to.

This resource is read-only.

Fields

Name	Type	Description
`id` (read-only)	String
`href` (read-only)	Field
`date_created` (required)	Datetime	The time when the resource was created, in the standard Dates & Times.
`departure_service` (read-only)	Reference Object	The departure service for which these cancellation terms apply
`terms` (required)	Nested Object	Reference to the cancellation terms applied when this service was Confirmed, which may differ from terms presently available. To get the exact details for this service, see the `windows` attribute.
`type` (required)	Choice	The resource type of the cancellation terms. Can be one of ‘cancellation_terms’ or ‘flex_cancellation_terms’.
`terms` (read-only)	Reference Object	Reference to the cancellation terms applied when this service was Confirmed, which may differ from terms presently available. To get the exact details for this service, see the `windows` attribute.
`total_gross_amount` (required)	Decimal	The total amount that is eligible for refund or credit if the Flex service is exercised
`lifetime_deposit_amount` (required)	Decimal	The deposit amount that is withheld by the business per our cancellation terms
`refundable_amount` (required)	Decimal	The maximum amount that can be refunded if this Service is cancelled, or the pool from which the refund and travel credit amounts are calculated if the Flex service terms are exercised
`windows` (required)	Field	Description of cancellation windows for these cancellation terms
`effective_from_date` (required)	Date	The date relative to the departure start date from which this cancellation window is effective.
`effective_from_datetime_utc` (required)	Datetime	The datetime from which this cancellation window is effective
`effective_until_date` (required)	Date	The date relative to the departure start date until which this cancellation window is effective.
`effective_until_datetime_utc` (required)	Datetime	The datetime until which this cancellation window is effective
`effective_days` (required)	Nested Object	Dates before departure when this cancellation window applies
`from_start_date` (required)	Integer	Number of days before departure where this cancellation window starts being applicable
`to_start_date` (required)	Integer	Number of days before departure where this cancellation window stops being applicable
`refund_amount` (required)	Decimal	The amount that is refunded when this cancellation window applies
`travel_credit_amount` (required)	Decimal	The amount that is credited as a travel credit when this cancellation window applies

Get Service Cancellation Terms¶

Fetch by departure service id:

GET /service_cancellation_terms/(string: departure_service_id)/¶

Warning

Service Cancellation Terms for bookings without a Flex Plan Service will return a 404 response.

Note

Terms are resolved for a departure service asynchronously. A request made immediately after creating a Flex Plan Service may return 404 Not Found or the previous terms - allow a few seconds and re-fetch.

Example response for a service covered by a Flex plan:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "123456",
  "href": "https://rest.gadventures.com/service_cancellation_terms/123456/",
  "date_created": "2025-06-01T00:00:00Z",
  "departure_service": {
    "id": "123456",
    "href": "https://rest.gadventures.com/departure_services/123456/"
  },
  "terms": {
    "type": "flex_cancellation_terms",
    "terms": {
      "id": "654321",
      "href": "https://rest.gadventures.com/flex_cancellation_terms/654321/",
      "name": "Flexier"
    }
  },
  "total_gross_amount": "5000.00",
  "lifetime_deposit_amount": "350.00",
  "refundable_amount": "4650.00",
  "windows": [
    {
      "effective_from_date": null,
      "effective_from_datetime_utc": null,
      "effective_until_date": "2026-08-01",
      "effective_until_datetime_utc": "2026-08-02T04:00:00Z",
      "effective_days": {
        "from_start_date": null,
        "to_start_date": 60
      },
      "refund_amount": "4650.00",
      "travel_credit_amount": "0.00"
    },
    {
      "effective_from_date": "2026-08-02",
      "effective_from_datetime_utc": "2026-08-02T04:00:00Z",
      "effective_until_date": "2026-08-31",
      "effective_until_datetime_utc": "2026-09-01T04:00:00Z",
      "effective_days": {
        "from_start_date": 59,
        "to_start_date": 30
      },
      "refund_amount": "2325.00",
      "travel_credit_amount": "2325.00"
    },
    {
      "effective_from_date": "2026-09-01",
      "effective_from_datetime_utc": "2026-09-01T04:00:00Z",
      "effective_until_date": "2026-09-09",
      "effective_until_datetime_utc": "2026-09-10T04:00:00Z",
      "effective_days": {
        "from_start_date": 29,
        "to_start_date": 21
      },
      "refund_amount": "0.00",
      "travel_credit_amount": "4650.00"
    },
    {
      "effective_from_date": "2026-09-10",
      "effective_from_datetime_utc": "2026-09-10T04:00:00Z",
      "effective_until_date": null,
      "effective_until_datetime_utc": null,
      "effective_days": {
        "from_start_date": 20,
        "to_start_date": null
      },
      "refund_amount": "0.00",
      "travel_credit_amount": "0.00"
    }
  ]
}

When the generic terms apply, the same request resolves to the departure’s Cancellation Terms instead:

{
  "id": "123456",
  "terms": {
    "type": "cancellation_terms",
    "terms": {
      "id": "1234567",
      "href": "https://rest.gadventures.com/cancellation_terms/1234567/",
      "name": "Standard"
    }
  }
}

Service Cancellation Terms¶

Which terms apply¶

Get Service Cancellation Terms¶

Related resources¶