--- title: "GET costs" method: GET path: "/v3/administrations/{administration_id}/costs" tags: ["Costs"] --- # GET costs `GET /v3/administrations/{administration_id}/costs` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/costs` - 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 costs of the administration ## Path parameters - `administration_id` string, required ## Query parameters - `page[number]` integer - `page[size]` integer - `sort` string - `fields[cost]` string - `include` string - `filter[id]` string - `filter[name]` string - `filter[description]` string - `filter[invoiced_as]` string - `filter[cost_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[preference_type]` string - `filter[applies_for_late_checkout]` string - `filter[applies_to_all_rentable_types]` string - `filter[limit_calculation]` string - `filter[created_at]` string - `filter[updated_at]` string - `filter[administration]` string - `filter[ledger_account]` string - `filter[amenities]` string ## Headers - `Accept-Language` string ## Response `200` CostCollectionResponse - object - `data` Cost[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `is_excluded` boolean: Whether this cost should be excluded from synchronization or not. - `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 - `invoiced_as` object: Translated name under which this cost 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 - `invoiced_to` 'channel' | 'guest': Returns whether this cost is invoiced to the channel or the guest - `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 cost is invoiced as part of the rent, or not - `is_percentage` boolean - `is_hidden` boolean: The cost will not be invoiced. It is expected that the organization or owner will invoice the fee by themselves, outside of Booking Experts. - `is_rent` boolean - `cost_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' - `maximum_quantity` integer: 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 - `if_stay_starts_in` array[] - string[] - `preference_type` 'none' | 'any_preferential_amenities' | 'specific_preferential_amenities' | 'any_fixed_rentable' | 'fixed_rentable_with_specific_rentable_amenities': Returns the preference type for this cost (none, any_preferential_amenities, specific_preferential_amenities, any_fixed_rentable, fixed_rentable_with_specific_rentable_amenities) - `applies_when_amenities` boolean: [DEPRECATED] Use preference_type instead. Returns if this cost only applies when the guest has chosen specific amenities. - `applies_when_fixed_rentable` boolean: [DEPRECATED] Use preference_type instead. Returns if this cost only applies when a specific rentable has been chosen - `applies_for_late_checkout` boolean: Returns if this cost only applies when late checkout has been toggled - `applies_to_all_rentable_types` boolean: Returns if this cost applies to all rentable types - `limit_calculation` 'none' | 'fixed_minimum' | 'per_person_minimum' | 'per_night_minimum' | 'per_piece_minimum' | 'per_person_per_night_minimum' | 'fixed_maximum' | 'per_person_maximum' | 'per_night_maximum' | 'per_piece_maximum' | 'per_person_per_night_maximum': Returns the calculation method for mininum and maximum prices - `prices` object[]: Returns the prices over time. In the context of a channel and rentable type, this will return the prices for that specific channel and rentable type. Otherwise, the default prices will be returned. - `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[]: Returns the percentages over time. In the context of a channel and rentable type, this will return the percentages for that specific channel and rentable type. Otherwise, the default percentages will be returned. - `date` string, date - `percentage` number, float - `percentage_without_vat` number, float - `exclude_from_all_in_price` boolean: Returns whether this cost is included from all-in prices yielded by Availability endpoints. - `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. - `amenities` object - `data` object[] - `id` string: amenities 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. - Amenity: Amenities are for external and internal use. They can be used to signify amenities of a RentableType or Rentable that are important to the guest. For example: * With sauna * Free wi-fi An Amenity can optionally be numerical or multiple choice. When an Amenity is numerical, the values of linked amenities (RentableTypeAmenity, RentableAmenity, ReservationAmenity and RoomAmenity) denote the numerical value belonging to the amenity. When an Amenity is multiple choice, the values of linked amenities denote the ID of the AmenityOption that applies. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` object: Name of the amenity - `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: Description to display along with the highlightable amenity - `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 - `icon_url` string: URL of icon to display along with highlightable amenity - `type` 'Amenity' | 'Amenities::NumericalAmenity' | 'Amenities::MultipleChoiceAmenity': Type of the amenity - `position` integer - `semantic_amenity_type` 'accessible_toilet' | 'accessible_washbasin' | 'afternoon_sun' | 'air_hockey' | 'airco' | 'amazon_prime' | 'animation' | 'baby_bath' | 'baby_monitor' | 'balcony' | 'bathtub' | 'bbq' | 'beach_front' | 'beach_view' | 'bed_linen_provided' | 'bedroom_tv' | 'bicycle' | 'bicycle_rental' | 'bicycle_storage' | 'bidet' | 'billiard_table' | 'bluray_player' | 'boat' | 'bocce_ball' | 'bowling_alley' | 'box_bed' | 'boxspring' | 'breakfast_service' | 'bunk_bed' | 'cabinet_locks' | 'cable_tv' | 'cai_hookup' | 'canoe' | 'car_free' | 'carbon_monoxide_detector' | 'cd_player' | 'ceiling_fan' | 'central_heating' | 'central_location' | 'ceramic_cooktop' | 'child_friendly' | 'childproof_electrical_outlets' | 'close_to_beach' | 'coffee_brewing_system' | 'coffee_capsule_system' | 'coffee_pad_system' | 'combi_microwave' | 'combi_oven' | 'communal_pool' | 'computer_monitor' | 'conservatory' | 'cookware' | 'corner_site' | 'cot' | 'cradle' | 'crib' | 'cutlery' | 'dartboard' | 'deck' | 'decorative_fireplace' | 'desk' | 'desk_chair' | 'dining_table' | 'disco' | 'dishes' | 'dishwasher' | 'disinfected' | 'disney_plus' | 'double_bed' | 'double_washbasin' | 'downtown' | 'drinking_glasses' | 'dryer' | 'drying_rack' | 'dvd_player' | 'ebike_charging_point' | 'electric_cooktop' | 'electricity_hookup' | 'elevator' | 'enhanced_cleaning' | 'ev_charging_point' | 'evening_sun' | 'extractor_hood' | 'fenced_pool' | 'fenced_yard' | 'final_cleaning' | 'fire_extinguisher' | 'fire_pit' | 'fireplace' | 'first_aid_kit' | 'fitness_room' | 'flatscreen_tv' | 'floor' | 'football_pitch' | 'forest' | 'forest_front' | 'forest_view' | 'free_standing' | 'free_wifi' | 'freezer' | 'gaming_console' | 'garden' | 'garden_furniture' | 'gas_cooktop' | 'gas_heater' | 'golf_course_front' | 'golf_course_view' | 'golfcourt' | 'grill' | 'guest_gap_period_24_hours' | 'guest_gap_period_48_hours' | 'guest_gap_period_72_hours' | 'hair_dryer' | 'hammock' | 'hangers' | 'hbo' | 'heated_pool' | 'heater' | 'high_chair' | 'high_touch_surfaces_disinfected' | 'horseriding' | 'hot_tub' | 'indoor_playground' | 'indoor_pool' | 'induction_cooktop' | 'insect_screens' | 'internet' | 'iron' | 'ironing_board' | 'jacuzzi' | 'kettle' | 'kingsize_bed' | 'kitchen' | 'kitchen_island' | 'kitchen_utensils' | 'kitchenette' | 'lake_front' | 'lake_view' | 'linens_high_temp_wash' | 'lounge_set' | 'loungers' | 'marina' | 'microwave' | 'minibar' | 'minigolf' | 'morning_sun' | 'motion_detector' | 'mountain_view' | 'mountains' | 'netflix' | 'ocean_front' | 'ocean_view' | 'office' | 'other' | 'outdoor_kitchen' | 'outdoor_playground' | 'outdoor_pool' | 'outdoor_shower' | 'oven' | 'paid_wifi' | 'parasol' | 'parking_area' | 'party_games' | 'patio' | 'paved_surface' | 'pedal_gokarts' | 'pellet_stove' | 'pet_friendly' | 'petting_zoo' | 'playground_front' | 'playground_view' | 'playpen' | 'pool_front' | 'pool_table' | 'printer' | 'private_garage' | 'private_golf' | 'private_parking' | 'private_pool' | 'private_sanitary' | 'private_tennis' | 'quay' | 'queensize_bed' | 'quiet_location' | 'radio' | 'refrigerator' | 'resort' | 'restaurant' | 'river' | 'rowboat' | 'rural' | 'safe' | 'sanitary_front' | 'satellite_tv' | 'sauna' | 'self_service_check_in' | 'semi_double_bed' | 'sewer_hookup' | 'shadow' | 'shower' | 'shower_chair' | 'single_bed' | 'single_floor' | 'smart_tv' | 'smoke_detector' | 'smoke_free' | 'smoking_allowed' | 'sofa_bed' | 'sound_system' | 'stair_gate' | 'storage_room' | 'streaming_service' | 'sunshower' | 'swing' | 'table_football_table' | 'table_tennis_table' | 'tanning_bed' | 'telephone' | 'tenniscourt' | 'toaster' | 'toilet' | 'towels' | 'toys' | 'trampoline' | 'twin_beds' | 'underfloor_heating' | 'vacuum_cleaner' | 'veranda' | 'videoland' | 'village' | 'volleyball_court' | 'wardrobe' | 'washbasin' | 'washer' | 'water_front' | 'water_hookup' | 'water_view' | 'wellness' | 'wheelchair_accessible' | 'wifi' | 'wood_stove' - `filterable` boolean: Administration has configured the amenity to appear as a filter - `highlightable` boolean: Administration has configured the amenity to appear as a highlight - `relationships` object: Relationships - `amenity_group` object: Group that the amenity belongs to - `data` object - … - `amenity_options` 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`: 31 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 - …27 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/costs/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)