--- title: "GET extras" method: GET path: "/v3/channels/{channel_id}/extras" tags: ["Channel Extras"] --- # GET extras `GET /v3/channels/{channel_id}/extras` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/channels/{channel_id}/extras` - 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 the extras that are available to the current channel ## Path parameters - `channel_id` string, required ## Query parameters - `page[number]` integer - `page[size]` integer - `sort` string - `fields[extra]` string - `include` string - `filter[id]` string - `filter[name]` string - `filter[description]` string - `filter[question_for_guest]` string - `filter[invoiced_as]` string - `filter[add_on]` string - `filter[checkout_portal_offered]` string - `filter[guest_portal_offered]` string - `filter[default_selection]` string - `filter[selectable]` string - `filter[available_for_customer]` string - `filter[selectable_by_booker]` string - `filter[confirm_by_guest]` string - `filter[extra_type]` string - `filter[counts_seniors]` string - `filter[counts_adults]` string - `filter[counts_adolescents]` string - `filter[counts_children]` string - `filter[counts_babies]` string - `filter[counts_from]` string - `filter[counts_till]` string - `filter[created_at]` string - `filter[updated_at]` string - `filter[administration]` string - `filter[ledger_account]` string ## Headers - `Accept-Language` string ## Response `200` ExtraCollectionResponse - object - `data` Extra[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `is_excluded` boolean: Whether this extra is excluded from synchronization. - `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 - `question_for_guest` 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 - `invoiced_as` object: Translated name under which this extra is invoiced - `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 - `add_on` boolean: Whether this is an add-on (true) or default cost (false) - `checkout_portal_offered` boolean: Whether this extra is offered in the checkout portal - `guest_portal_offered` boolean: Whether this extra is offered in the guest portal for upgrades - `default_selection` boolean: Whether this extra is selected by default (opt-out) - `selectable` 'default' | 'important' | 'guest' | 'backoffice': DEPRECATED: Use add_on, checkout_portal_offered, guest_portal_offered, and default_selection instead. Maps to: default (add_on=false), important (add_on=true + checkout_portal_offered=true + default_selection=true), guest (add_on=true + user portal offered + default_selection=false), backoffice (add_on=true + no portal offered) - `available_for_customer` 'always' | 'during_booking' | 'during_upgrade': DEPRECATED: Use selectable_by_booker instead - `selectable_by_booker` 'always' | 'during_booking' | 'during_upgrade': DEPRECATED: Use checkout_portal_offered and guest_portal_offered instead. Maps to: always (both true), during_booking (checkout only), during_upgrade (guest only) - `calculation` 'per_person' | 'per_person_per_day' | 'per_pet' | 'per_pet_per_day' | 'fixed' | 'per_day' | 'per_piece' | 'per_piece_per_day' | 'percentage_over_default_costs' | 'percentage_over_total' | 'percentage_over_base_rent' | 'percentage_over_default_rent' | 'percentage_over_default_rent_per_person' | 'percentage_over_rent' - `is_invoiced_as_rent` boolean: Whether this extra is invoiced as part of the rent, or not - `is_percentage` boolean - `is_hidden` boolean - `is_rent` boolean - `confirm_by_guest` boolean: When set, guests should explicitly confirm the terms mentioned in the description - `extra_type` 'other' | 'tourist_taxes' | 'environmental_charges' | 'energy' | 'deposit' | 'bath_linen' | 'bed_linen' | 'cleaning' | 'childs_bed' | 'childs_chair' | 'sauna' | 'pets' | 'preference_costs' | 'provision' | 'cancellation_insurance' | 'parking' | 'early_checkin' | 'late_checkout' | 'food' | 'labour' | 'heating' | 'internet' | 'gas' | 'water' | 'drinking_water' | 'electricity' | 'wood' | 'toiletries' | 'transportation' | 'laundry' | 'additional_bed' | 'airco' | 'transfer' | 'flight' | 'bus' | 'airport_shuttle' | 'bbq' | 'bicycle_rental' | 'breakfast' | 'catering' | 'chemical_toilet_disposal' | 'coffee' | 'equipment_rental' | 'ev_charging_fee' | 'extra_guest' | 'extra_tent' | 'extra_vehicle' | 'fitness' | 'hottub' | 'housekeeping' | 'insurance' | 'kitchen_linen' | 'pet_cleaning' | 'pool_heating' | 'resort_amenities' | 'service_charge' | 'shower_tokens' | 'skipass' | 'waste_disposal' | 'waterpark' | 'wellness' - `quantity_required` boolean - `guest_answer_required` boolean - `maximum_quantity` number, double: Maximum amount per reservation, will be blank when unlimited - `counts_seniors` boolean - `counts_adults` boolean - `counts_adolescents` boolean - `counts_children` boolean - `counts_babies` boolean - `counts_pets` boolean - `counts_from` integer: Count people or pets starting from this number of guests - `counts_till` integer: Maximum number of people or pets to count - `vat_rate` number, double - `price` object: When returned as an include of the reservation#available_extras relationship, this will yield the (unit) price of the extra - `currency` string - `value` string - `require_stay_overlaps` array[] - string[] - `prices` object[] - `date` string, date - `price` object - `currency` string - `value` string - `price_without_vat` object - `currency` string - `value` string - `price_limit` object - `currency` string - `value` string - `percentages` object[] - `date` string, date - `percentage` number, float - `percentage_without_vat` number, float - `created_at` string, date-time - `updated_at` string, date-time - `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. - `ledger_account` object - `data` object - `id` string: ledger_account 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. - LedgerAccount - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `created_at` string, date-time - `updated_at` string, date-time - `number` string - `name` string - `report_type` string - `fixed_type` 'cash' | 'bank' | 'pin' | 'psp' | 'safe' | 'booking' | 'channel' | 'pos' | 'owner' | 'pre_invoiced_turnover' | 'vat_low_payable' | 'vat_high_payable' | 'settlements' | 'batch' | 'vouchers' | 'other_parks' | 'advances' | 'uncategorized_payments' | 'security_deposits' | 'security_deposits_damages' | 'payment_difference' | 'cash_difference' | 'rent' | 'uncategorized_expenses' | 'uncategorized_turnover': System ledger account type. Will be blank for custom made ledger accounts - `current_vat_rate` number, double - `relationships` object: Relationships - `vat_code` 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`: 21 info - added the optional property `data/items/attributes/description/da-DK` to the response with the `200` status - added the optional property `data/items/attributes/description/en-GB` to the response with the `200` status - added the optional property `data/items/attributes/description/en-US` to the response with the `200` status - added the optional property `data/items/attributes/invoiced_as/da-DK` to the response with the `200` status - …17 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/channels/:channel_id/extras/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)