# Extras

Represents Extras within the Property Management System (PMS), which are additional services or products that can be added to a booking. Extras may include amenities such as parking, breakfast, airport transfers, housekeeping services, or any custom add-ons offered by the property. These entities are used to enhance guest experiences, provide personalised services, and generate additional revenue streams. Extras can be configured with pricing, availability rules, and booking conditions to ensure seamless integration with reservation workflows.

## Search for chargeable extras

 - [GET /api/v3/extras](https://apidocs.resharmonics.com/apis/resharmonics-pms/extras/searchallextras.md): Retrieve a paginated list of chargeable extras within the Property Management System (PMS). Chargeable extras represent additional services or products that can be added to bookings, such as parking, meals, or cleaning services. This endpoint allows filtering by billing frequency, building ID, and whether the extra is available through the Internet Booking Engine (IBE). The response includes details about each extra, such as pricing, availability, and applicable billing rules. If an invalid billing frequency is provided, a  error will be returned. If no filters are applied, all available chargeable extras will be returned in a paginated format, making it easier to manage and integrate additional services into property operations.

## Retrieve compulsory chargeable extras for a rate ID

 - [GET /api/v3/extras/{rateId}](https://apidocs.resharmonics.com/apis/resharmonics-pms/extras/retrievecompulsoryextrasforrateid.md): Fetch a list of compulsory chargeable extras associated with a specific rate code within the Property Management System (PMS). Compulsory extras are additional services or fees that must be included when booking a rate, such as cleaning fees, resort fees, or mandatory meal plans. This endpoint requires the  as a path variable and a date range ( and ) as query parameters to determine the applicable extras for the specified period. The response includes details about each extra, including pricing, validity dates, and availability. This functionality is useful for ensuring that mandatory add-ons are applied correctly in booking workflows and pricing calculations. If the rate code does not exist or is invalid, an appropriate error response will be returned.

## Record a payment against an extra attached to a room stay

 - [POST /api/v3/extras/{roomStayExtraId}/payment](https://apidocs.resharmonics.com/apis/resharmonics-pms/extras/updateextrapayment.md): Registers a payment for a chargeable extra linked to a specific room stay within the Property Management System (PMS). This endpoint requires the  as a path variable to identify the extra and a payment request body containing the payment details. It verifies the existence of the room stay extra and checks for any associated sales invoices. If an outstanding balance remains, the payment is processed and recorded. The response includes financial details related to the transaction, such as the payment reference and updated invoice status. If the extra does not exist, the invoice is already paid, or there are no invoices to process, a  error will be returned.