--- title: "GET discount_actions" method: GET path: "/v3/channels/{channel_id}/discount_actions" tags: ["DiscountActions"] --- # GET discount_actions `GET /v3/channels/{channel_id}/discount_actions` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/channels/{channel_id}/discount_actions` - Auth: one of: - API key in header `X-API-KEY` - OAuth 2 - Authorization code: `/oauth/authorize` - Token URL: `/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns discount actions that are applicable to the channel ## Path parameters - `channel_id` string, required ## Query parameters - `page[number]` integer - `page[size]` integer - `sort` string - `fields[discount_action]` string - `include` string - `filter[id]` string - `filter[discount_percentage]` string - `filter[minimum_number_of_nights]` string - `filter[maximum_number_of_nights]` string - `filter[days_in_advance_mode]` string - `filter[number_of_days_in_advance]` string - `filter[coupon_codes]` string - `filter[archived]` string - `filter[created_at]` string - `filter[updated_at]` string - `filter[name]` string - `filter[administration]` string - `filter[discount_campaign]` string - `filter[promotion]` string - `filter[book_period]` string - `filter[stay_period]` string - `filter[guest_group_limits]` string - `filter[rentable_types]` string - `filter[channels]` string - `include_archived` boolean ## Headers - `Accept-Language` string ## Response `200` DiscountActionCollectionResponse - object - `data` DiscountAction[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `discount_percentage` number, double: Applied discount percentage (if set) - `fixed_discount` object: Applied fixed discount (if set) - `currency` string - `value` string - `minimum_number_of_nights` integer - `maximum_number_of_nights` integer - `days_in_advance_mode` 'none' | 'early_bird' | 'last_minute': Specifies if the discount action is an early bird or last minute discount - `number_of_days_in_advance` integer: The minimum days in advance for bookings of early bird discounts, or the maximum days in advance for bookings of last minute discounts. - `coupon_codes` string[]: Applies when one of the specified coupon codes is used - `archived` boolean - `created_at` string, date-time - `updated_at` string, date-time - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `book_period` array[]: Applies to reservations that were booked in the given periods - string[] - `stay_period` array[]: Applies to reservations with stay overlapping with the given periods - string[] - `relationships` object: Relationships - `administration` object - `data` object - `id` string: administration ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `discount_campaign` object: DEPRECATED use promotion instead - `data` object - `id` string: discount_campaign ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `promotion` object - `data` object - `id` string: promotion ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `book_period` object: Applies to reservations that were booked in the given period - `data` object - `id` string: book_period ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `stay_period` object: Applies to reservations with stay overlapping with the given period - `data` object - `id` string: stay_period ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `guest_group_limits` object: Applies to reservations that satisfy **all** of the given guest group limits. - `data` object[] - `id` string: guest_group_limits ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `rentable_types` object: Applies to reservations for one of the associated rentable types. This relationship will not be returned when the discount action applies to **all** associated rentable types. - `data` object[] - `id` string: rentable_types ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `channels` object: Applies to reservations made through one of the associated channels. This relationship will not be returned when the discount action applies to **all** associated channels. - `data` object[] - `id` string: channels ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `included` union[] - union - Administration: An organization can have multiple administrations, usually a holiday park or camping. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` string - `email` string - `phone` string - `website` string - `native_currency` string - `address` string - `country_code` string - `postal_code` string - `city` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `description` object: A description of the administration - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `surroundings_description` object: A description of the surroundings - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `tin` string: Tax Identification Number - `vat_nr` string: VAT Number - `available_locales` string[]: Enabled locales - `native_locale` string: The default locale used by the administration internally, and which should be used for communication with the administration - `timezone` string: The timezone of the administration, for example: Amsterdam - `invoice_email` string: The email address to contact for invoicing questions - `invoice_phone` string: The phone number to contact for invoicing questions - `invoice_address` string: The address to use for invoicing - `invoice_postalcode` string: The postal code to use for invoicing - `invoice_city` string: The city to use for invoicing - `invoice_country_code` string: The country code to use for invoicing - `billing_vat_percentage` integer - `available_currencies` string[]: Enabled currencies - `map_available` boolean: If a map is available. The map can be used to pick a specific accommodation or pitch. - `guest_list_group` 'main_guest' | 'all' | 'adults' | 'none' - `guest_accepted_document_type` string[] - `guest_identification_required` 'none' | 'main_guest' | 'all' | 'adults' - `ask_for_guest_gender` boolean - `ask_for_guest_address` boolean - `ask_for_guest_postal_code` boolean - `ask_for_guest_city` boolean - `ask_for_guest_country` boolean - `ask_for_guest_email` boolean - `ask_for_guest_phone` boolean - `ask_for_guest_profession` boolean - `ask_for_guest_signature` boolean - `ask_for_fellow_guest_gender` boolean - `ask_for_fellow_guest_address` boolean - `ask_for_fellow_guest_postal_code` boolean - `ask_for_fellow_guest_city` boolean - `ask_for_fellow_guest_country` boolean - `ask_for_fellow_guest_email` boolean - `ask_for_fellow_guest_phone` boolean - `ask_for_fellow_guest_profession` boolean - `ask_for_fellow_guest_signature` boolean - `default_option_validity` integer: The default option validity in days. When 0, customer options are not allowed. - `max_options_per_customer` integer: DEPRECATED use max_options_per_booker instead - `max_options_per_booker` integer: The maximum number of options that can be created at the same time by a particular customer - `latitude` number, double - `longitude` number, double - `allow_multi_reservation_bookings_through_api` boolean: Whether the administration accepts bookings containing multiple reservations. - `accounting_closed_upto` string, date: Date up to which accounting is closed. All financial transactions made before this date are locked and cannot be changed. - `enable_license_plates` boolean: Whether the administration accepts license plates for bookings. - `iban` string: International Bank Account Number - `bic` string: Bank Identifier Code - `peppol_identifiers` object[]: PEPPOL Identifiers for the administration with scheme ID. See https://docs.peppol.eu/edelivery/codelists/v9.4/Peppol%20Code%20Lists%20-%20Participant%20identifier%20schemes%20v9.4.html - `scheme` string - `value` string - `created_at` string, date-time - `updated_at` string, date-time - `links` object: Links - `self` string: Link to self - `url` string: Link to url - `relationships` object: Relationships - `city` object - `data` object - … - `checkin_timetable` object: The timetable that defines the default check-in times for this administration. It can be overridden for each rentable type. - `data` object - … - `checkout_timetable` object: The timetable that defines the default check-out times for this administration. It can be overridden for each rentable type. - `data` object - … - `interactive_map` object - `data` object - … - `payment_handlers` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - DiscountCampaign: Discount campaigns are used to advertise DiscountActions on rent prices for one or more RentableTypes. Discounts can be a percentage or a fixed amount. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `rules` object: Yields the rules to which a new booking must apply. - `start_date` string, date - `end_date` string, date - `minimum_number_of_nights` integer - `maximum_number_of_nights` integer - `early_bird_minimum_number_of_days_in_advance` integer - `last_minute_maximum_number_of_days_in_advance` integer - `start_date` string, date - `minimum_stay_duration` integer - `suggested_guest_group` object - `seniors` integer - `adults` integer - `adolescents` integer - `children` integer - `babies` integer - `pets` integer - `banner` object - `original` string - `banner` string - `large` string - `polaroid` string - `thumb` string - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Promotion: Promotions are used to advertise discount actions on rent prices for one or more RentableTypes. Discounts can be a percentage or a fixed amount. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `rules` object: Yields the rules to which a new booking must apply. - `start_date` string, date - `end_date` string, date - `minimum_number_of_nights` integer - `maximum_number_of_nights` integer - `early_bird_minimum_number_of_days_in_advance` integer - `last_minute_maximum_number_of_days_in_advance` integer - `start_date` string, date - `minimum_stay_duration` integer - `suggested_guest_group` object - `seniors` integer - `adults` integer - `adolescents` integer - `children` integer - `babies` integer - `pets` integer - `banner` object - `original` string - `banner` string - `large` string - `polaroid` string - `thumb` string - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Period: Periods are sets of date ranges. They can be used to define the validity of: * Costs * DiscountActions (when they can be booked and when the stay period is valid) * Packages (when they can be booked and when the stay period is valid) - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `relationships` object: Relationships - `period_entries` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Period: Periods are sets of date ranges. They can be used to define the validity of: * Costs * DiscountActions (when they can be booked and when the stay period is valid) * Packages (when they can be booked and when the stay period is valid) - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `relationships` object: Relationships - `period_entries` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - GuestGroupLimit: RentableTypes, Packages and DiscountActions may only apply to specific guest groups or are calculated differently based on the guest group. These guest groups can be defined using one or more GuestGroupLimits. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `minimum_limit` integer: The minimum limit for the given guest group. - `maximum_limit` integer: The maximum limit for the given guest group. - `counts_seniors` boolean - `counts_adults` boolean - `counts_adolescents` boolean - `counts_children` boolean - `counts_babies` boolean - `counts_pets` boolean - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - RentableType: A RentableType represents a type and thus can have multiple underlying Rentables. The specific Rentables are not advertised to the guest. The exact Rentable is hidden from the guest so that the organization is flexible in assigning guests to different accommodations. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `short_description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `additional_house_rules` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `invoice_details` object: Additional information that appears on every booking invoice and when making a booking in the front office. - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `usps` object: Translated unique selling points - `cs` string[] - `da-DK` string[] - `de` string[] - `de-AT` string[] - `de-CH` string[] - `en-US` string[] - `en-GB` string[] - `es` string[] - `fr` string[] - `fr-BE` string[] - `fr-LU` string[] - `it` string[] - `nb` string[] - `nl` string[] - `nl-BE` string[] - `pl` string[] - `pt` string[] - `tr` string[] - `en` string[] - `da` string[] - `highlighted` boolean: DEPRECATED: Use highlight_priority instead - `highlight_priority` integer: The score between 0 and 5 determining how prominently this type should be highlighted on the website. 0 means no highlighting and 5 means top priority. Used when using the highlighted sorter in the availabilities endpoint - `reference` string - `original_identifier` string: Identification code from the previous system, if any - `registration_number` string: Registration number for this type. It can be required by legislation to show this number when this type is advertised - `additional_registration_number` string: Additional registration number for this type. Some countries (e.g., Italy) require multiple registration numbers - `minimum_number_of_nights` integer - `maximum_number_of_nights` integer - `number_of_bedrooms` integer - `number_of_beds` integer - `number_of_showers` integer - `number_of_toilets` integer - `number_of_bathrooms` integer - `number_of_parking_spots` integer - `number_of_child_beds` integer - `number_of_child_chairs` integer - `surface_area` integer: The surface area for this type in square meters - `summer_video_id` string: YouTube video ID per season. You can create an iframe with source "https://www.youtube.com/embed/:id" on your website to embed this. - `winter_video_id` string: YouTube video ID per season. You can create an iframe with source "https://www.youtube.com/embed/:id" on your website to embed this. - `whole_year_video_id` string: YouTube video ID per season. You can create an iframe with source "https://www.youtube.com/embed/:id" on your website to embed this. - `master_price_list_price_factor` number, double: The prices in the price list are multiplied by this value. For example, if the factor is 1.1, 10% is added to the prices. Values below 1.0 are also possible. - `master_price_list_fixed_rate` number, double: This rate is added to (or subtracted from if negative) the prices of the price list. The value is per night, so a midweek price for monday to friday, gets this value added times four. - `same_day_bookings_allowed` boolean - `same_day_booking_closing_time` string, time - `address` string - `postal_code` string - `latitude` number, double - `longitude` number, double - `checkin_times_for_week` string[]: The check-in times for each day of the week, starting with sunday. DEPRECATED: Use checkin_timetable instead. - `checkout_times_for_week` string[]: The check-out times for each day of the week, starting with sunday. DEPRECATED: Use checkout_timetable instead. - `energy_label` 'exempt' | 'A++++' | 'A+++' | 'A++' | 'A+' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H': Yields the lowest energy label of all objects (if any have been set) - `energy_labels` string[]: Yields the unique energy labels of all objects (if any have been set) - `virtual` boolean: A rentable type is virtual when it groups accommodations in order for them to be rented as if it was one accommodation. This is the case for grouped rentable types. - `archived` boolean - `max_number_of_people` integer - `max_number_of_seniors` integer - `max_number_of_adults` integer - `max_number_of_adolescents` integer - `max_number_of_children` integer - `max_number_of_babies` integer - `max_number_of_pets` integer - `highlighted_amenity_ids` integer[]: IDs of the amenities that should be highlighted for this rentable type - `prices_updated_at` string, date-time: Timestamp when the prices of this type were last updated - `prices_indexed_at` string, date-time: Timestamp when the prices of this type were last indexed for availability search - `stock_updated_at` string, date-time: Timestamp when the stock of this type was last updated - `stock_indexed_at` string, date-time: Timestamp when the stock of this type was last indexed for availability search - `costs_updated_at` string, date-time: Timestamp when the costs of this type were last updated - `extras_updated_at` string, date-time: Timestamp when the extras of this type were last updated - `bookable_discounts_changed_at` string, date-time: Timestamp when the bookable discounts of this type were last updated - `agreements_changed_at` string, date-time: Timestamp when the agreements of this type were last updated - `max_baby_age` integer - `max_child_age` integer - `max_adolescent_age` integer - `min_senior_age` integer - `pets_allowed` 'all' | 'some' | 'none': Whether pets are allowed on all, some or none of the accommodations of this type - `last_date_with_price` string, date - `city` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `region` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'AN' | 'ZZ' | 'WW' - `location_is_exact` boolean - `has_current_or_future_owner_that_should_check_reservations` boolean - `created_at` string, date-time - `updated_at` string, date-time - `links` object: Links - `parkcms_url` string: Link to parkcms_url - `relationships` object: Relationships - `city` object - `data` object - … - `terms` object - `data` object - … - `rentable_segment` object - `data` object - … - `master_price_list` object - `data` object - … - `guest_group_limits` object - `data` object[] - … - `administration` object - `data` object - … - `rent_earned_ledger_account` object - `data` object - … - `checkin_timetable` object: The timetable that defines the check-in times for this rentable type. - `data` object - … - `checkout_timetable` object: The timetable that defines the check-out times for this rentable type. - `data` object - … - `images` object - `data` object[] - … - `rooms` object - `data` object[] - … - `rentable_type_amenities` object - `data` object[] - … - `optional_amenities` object - `data` object[] - … - `attachments` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Channel: Every Reservation originates from a channel. This can be a tour operator, the backoffice, the website and so on. Administrations can customize the following aspects for each Channel: * Extras * Costs * Availability * Rent prices * Invoicing - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` string: Name of the channel. This name is also shown in the back-office. - `email` string: Contact email address of the channel. This email address is also shown in the back-office. - `kind` 'reseller' | 'tour_operator': Channel kind. - `available_currencies` string[]: Lists the currencies that are available for this channel. One or more of: EUR, USD, CHF, CZK, TRY, CVE, XCG, GBP, NOK, DKK, ZAR. - `pricing_type` string: Type of pricing that applies to this channel. One of: night_prices, complex_prices. Is replaced by requires_night_prices. - `requires_night_prices` boolean: Whether this channel can only handle night prices. - `archivable` boolean: Whether the channel can be archived or not. - `front_office` boolean: Whether reservations made through this channel should be listed as front office reservations on the planboard or not. - `synchronizes_costs` boolean: Whether the channel synchronizes costs or not. - `allows_costs_with_multiple_price_periods` boolean: Whether the channel allows costs with negative prices or percentages. Ignored when synchronizes_costs is false. - `allows_costs_with_negative_amounts` boolean: Whether the channel allows costs with negative prices or percentages. Ignored when synchronizes_costs is false. - `allows_deposit_costs_that_are_not_fixed_or_per_piece_or_percentual` boolean: Whether the channel allows deposit costs that are not fixed, per piece or percentual. Ignored when synchronizes_costs is false. - `allow_confirmation_without_payment` boolean: Whether the channel allows confirmation without direct payment. - `determines_price` boolean: Whether the channel determines the price or not. - `skip_price_deviation_check` boolean: Whether price deviation checks must be performed. By default, when the passed price for a booking deviates more than 5% from the expected booking price, we notify the administration of this. - `rent_invoiced_to` 'guest' | 'channel': Whether the channel invoices rent to the guest or the channel. - `costs_invoiced_to` 'guest' | 'channel': Whether the channel invoices costs to the guest or the channel. - `use_costs_invoiced_to` boolean: Whether the channel should use the costs_invoiced_to setting to determine invoicing or not. Setting this to false allows overriding the invoicing for individual costs. - `extras_invoiced_to` 'guest' | 'channel': Whether the channel invoices extras to the guest or the channel. - `use_extras_invoiced_to` boolean: Whether the channel should use the extras_invoiced_to setting to determine invoicing or not. Setting this to false allows overriding the invoicing for individual extras. - `behave_as_own_site` boolean: Whether the channel behaves as the own site channel or not. Must be false when kind is set to tour_operator. - `supports_group_details` boolean: Whether the channel supports specifying detailed group compositions. - `confirm_reservations` boolean: Whether the channel automatically confirms reservations or not - `auto_deliver_invoices` boolean: Whether the channel automatically delivers invoices to the specified email or not - `confirm_by_email` boolean: Deprecated: use auto_deliver_invoices instead. Whether the channel automatically delivers invoices to the specified email or not - `customer_invoice_payable_on_park` boolean: Whether the guest invoice can be paid on arrival or not - `fixed_attributes` string[]: Lists the attributes of the channel that cannot be freely edited in the back-office. One or more of: name, requires_night_prices, kind, rent_invoiced_to, costs_invoiced_to, use_costs_invoiced_to, confirm_reservations, auto_deliver_invoices, customer_invoice_payable_on_park, available_currencies, email. - `can_be_set_as_default_channel` boolean: Whether the channel can be set as the default channel for new back office reservations etc. or not. Can only be specified on creation. - `requires_cancellation_originator` boolean: Whether the channel requires the originator of reservation cancellations to be known or not. Can only be specified on creation. - `requires_restitution_after_cancellation` boolean: Whether the channel requires mandatory restitution after a reservation cancellation or not. Can only be specified on creation. - `requires_confirmation_or_cancellation_within_24_hours` boolean: Whether the channel requires confirmation or cancellation of a reservation within 24 hours after creation of the reservation. " \ "Can only be specified on creation. - `uses_remote_reservation_key` boolean: Whether the channel uses a remote reservation key or not. Can only be specified on creation. - `only_allow_movement_by_channel` boolean: Whether the channel only allows movements of reservations (in time, or to different inventory objects) by the channel itself or not. - `archived` boolean: Whether this channel has been archived or not. - `debtor_code` string: A system wide unique identifier for this debtor - `temporary_booking_validity_in_hours` string: Time in hours after which unconfirmed reservations are cancelled. - `price_factor` number, double: The final rent price (base rent price minus discount) is multiplied by this value. For example, if the factor is 1.1, 10% is added to the final rent price. Values below 1.0 are also possible. - `created_at` string, date-time - `updated_at` string, date-time - `links` object: Links - `url` string: Link to url - `relationships` object: Relationships - `administration` object - `data` object - … - `application` object - `data` object - … - `brand` object - `data` object - … - `contact` object - `data` object - … - `guest_payment_policy` object - `data` object - … - `channel_payment_policy` object - `data` object - … - `excluded_costs` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `meta` object - `pagination` object - `total_records` integer - `page` integer - `size` integer ## Other responses - `429`: Error - `default`: Error ## Changes - **2026-11-03** `ff81bc4fefa9`: 58 info - added the new optional `query` request parameter `filter[promotion]` - added the optional property `data/items/attributes/name/da-DK` to the response with the `200` status - added the optional property `data/items/attributes/name/en-GB` to the response with the `200` status - added the optional property `data/items/attributes/name/en-US` to the response with the `200` status - …54 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/channels/:channel_id/discount_actions/get.md) --- [API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)