--- title: "GET primary package" method: GET path: "/v3/channels/{channel_id}/primary_packages/{id}" tags: ["Channel PrimaryPackages"] --- # GET primary package `GET /v3/channels/{channel_id}/primary_packages/{id}` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/channels/{channel_id}/primary_packages/{id}` - 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 primary package for the given ID ## Path parameters - `channel_id` string, required - `id` string, required ## Query parameters - `fields[primary_package]` string - `include` string ## Headers - `Accept-Language` string ## Response `200` PrimaryPackageResponse - object - `data` PrimaryPackage: In contrast to ExtraPackages, primary packages can be applied only once to a Reservation. They usually provide a fixed price for a stay that is combined with several special costs and/or extras. For example: a Sauna package which includes "Towels", "Sauna tickets" and "Bathrobes" can be bought together as one package that is normally cheaper than buying all the same extras individually. - `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 - `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 - `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 - `confirm_by_guest` boolean - `searchable` boolean - `fixed_period` boolean - `start_date` string, date - `end_date` string, date - `fixed_number_of_nights` string - `position` integer - `archived` boolean: Whether this primary package has been archived or not. - `applies_to_all_categories` boolean: Whether this primary package applies to all RentableTypes of the Administration. DEPRECATED: use applies_to_all_rentable_types instead. - `applies_to_all_rentable_types` boolean: Whether this primary package applies to all RentableTypes of the Administration. - `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. - `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. - `discount_action` object - `data` object - `id` string: discount_action 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. - `images` object - `data` object[] - `id` string: images 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. - `package_entries` object - `data` object[] - `id` string: package_entries 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. - 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. - DiscountAction: Represents a fixed or percentage discount that may be applied to a Reservation. DiscountActions can apply to specific Channels and/or RentableTypes. - `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 - … - `discount_campaign` object: DEPRECATED use promotion instead - `data` object - … - `promotion` object - `data` object - … - `book_period` object: Applies to reservations that were booked in the given period - `data` object - … - `stay_period` object: Applies to reservations with stay overlapping with the given period - `data` object - … - `guest_group_limits` object: Applies to reservations that satisfy **all** of the given guest group limits. - `data` object[] - … - `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[] - … - `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[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Image: Represents an image with multiple versions. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `image` object - `original` string - `banner` string - `cover` string - `large` string - `polaroid` string - `thumb` string - `filename` string - `data` string, byte: Base64-encoded image data of the original image. Must be specified when adding a new image. - `alt_text` 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 - `season` 'whole_year' | 'winter' | 'summer': The season to which the image applies - `position` integer - `created_at` string, date-time - `updated_at` string, date-time - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - PackageEntry: Represents a Cost or Extra of a Package with a specific price as part of the Package. - `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 - `quantity` integer - `surcharge` boolean - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. ## Other responses - `429`: Error - `default`: Error ## Changes - **2026-11-03** `ff81bc4fefa9`: 39 info - added the optional property `data/attributes/description/da-DK` to the response with the `200` status - added the optional property `data/attributes/description/en-GB` to the response with the `200` status - added the optional property `data/attributes/description/en-US` to the response with the `200` status - added the optional property `data/attributes/name/da-DK` to the response with the `200` status - …35 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/channels/:channel_id/primary_packages/:id/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)