# Get price breakdown for a reservation

Retrieve a detailed price breakdown for a given reservation, including VAT, applicable taxes, and fees, per each room the guest booked.

Endpoint: GET /connectivity-payments/reservations/{reservation-id}/breakdown
Version: 1.0

## Header parameters:

  - `Authorization` (string, required)
    Bearer token for authentication.
    Example: "Bearer <your_token>"

  - `accept-version` (string)
    API version to use.

## Path parameters:

  - `reservation-id` (integer, required)
    The unique identifier of the reservation.

## Response 200 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    The data

  - `data.reservation_id` (string)
    Accommodation reservation identifier

  - `data.property_id` (string)
    Property identifier

  - `data.payout_type` (string)
    Type of payout: GROSS, NET, or UNKNOWN.

  - `data.payment_tags` (array)
    Payment tags associated with the reservation.

  - `data.total_price_of_reservation` (object)
    Breakdown of the total reservation price

  - `data.total_price_of_reservation.total_amount_paid` (object)
    Contains information on the total amount the guest paid to Booking.com.

  - `data.total_price_of_reservation.total_amount_paid.currency` (string)
    Currency of the amount.

  - `data.total_price_of_reservation.total_amount_paid.value` (string)
    Amount paid by the guest.

  - `data.total_price_of_reservation.total_amount_paid.decimals` (integer)
    Number of decimals in the amount.

  - `data.total_price_of_reservation.total_amount_to_collect_at_property` (object)
    Contains information on the estimated amount the partner needs to collect from the guest at checkin.

  - `data.total_price_of_reservation.total_amount_to_collect_at_property.currency` (string)
    Currency of the amount.

  - `data.total_price_of_reservation.total_amount_to_collect_at_property.value` (string)
    Estimated amount to be collected from the guest at checkin.

  - `data.total_price_of_reservation.total_amount_to_collect_at_property.decimals` (integer)
    Number of decimals in the amount.

  - `data.partner_payout` (object)
    Partner payout summary

  - `data.partner_payout.total_payout` (object)
    Contains information on the total amount to be paid out to the partner.

  - `data.partner_payout.total_payout.currency` (string)
    Currency of the amount.

  - `data.partner_payout.total_payout.value` (string)
    Total payout amount.

  - `data.partner_payout.total_payout.decimals` (integer)
    Number of decimals in the amount.

  - `data.partner_payout.commissionable_price` (object)
    Contains information on the total commissionable price.

  - `data.partner_payout.commissionable_price.currency` (string)
    Currency of the amount.

  - `data.partner_payout.commissionable_price.value` (string)
    Total commissionable price.

  - `data.partner_payout.commissionable_price.decimals` (integer)
    Number of decimals in the amount.

  - `data.partner_payout.commissions_and_charges` (object)
    Contains information on the total amount of commissions and other charges such as fees.

  - `data.partner_payout.commissions_and_charges.currency` (string)
    Currency of the amount.

  - `data.partner_payout.commissions_and_charges.value` (string)
    Total amount of commissions and other charges.

  - `data.partner_payout.commissions_and_charges.decimals` (integer)
    Number of decimals in the amount.

  - `data.partner_payout.commissions_and_charges.breakdown` (object)
    Breakdown of commissions and charges.

  - `data.partner_payout.commissions_and_charges.breakdown.total_commissions` (object)
    Total commission amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_commissions.currency` (string)
    Currency of the amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_commissions.value` (string)
    Total commission amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_commissions.decimals` (integer)
    Number of decimals in the amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_charges` (object)
    Total charges amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_charges.currency` (string)
    Currency of the amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_charges.value` (string)
    Total charges amount.

  - `data.partner_payout.commissions_and_charges.breakdown.total_charges.decimals` (integer)
    Number of decimals in the amount.

  - `data.price_breakdown` (array)
    Per-room price breakdown

  - `data.price_breakdown.room_reservation_id` (string)
    Room reservation identifier

  - `data.price_breakdown.charges` (array)

  - `data.price_breakdown.charges.type` (string)
    Charge type (e.g. Tax, COMMISSION)

  - `data.price_breakdown.charges.amount` (object)
    Contains information on the total amount of all charges.

  - `data.price_breakdown.charges.amount.currency` (string)
    Currency of the amount.

  - `data.price_breakdown.charges.amount.value` (string)
    Total amount of all charges.

  - `data.price_breakdown.charges.amount.decimals` (integer)
    Number of decimals in the amount.

  - `data.price_breakdown.charges.is_already_collected_from_guest` (string)
    If set to TRUE, the charged amount has already been collected from the guest and the partner does not need to collect anything. If set to FALSE, the partner has to collect the money at checkin. If set to UNKNOWN, no information is available.

  - `data.price_breakdown.charges.is_included_total_partner_payout` (string)
    If set to TRUE, the charged amount is included in the payout and will be transferred to the partner. If set to FALSE, the charged amount is intended for another party, such as the government. If set to UNKNOWN, no information is available.

  - `data.price_breakdown.charges.applicable_rate` (object,null)
    The rate applied to calculate the charge.

  - `data.price_breakdown.charges.applicable_rate.type` (string)
    How the rate is applied (e.g. PERCENTAGE).

  - `data.price_breakdown.charges.applicable_rate.value` (string)
    Rate value.

  - `data.price_breakdown.charges.applicable_rate.decimals` (integer)
    Number of decimals in the rate value.

  - `data.price_breakdown.charges.applicable_type` (array,null)
    The type of applicable rate.

  - `errors` (array)

  - `warnings` (array)

## Response 400 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"

## Response 401 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `warnings` (array)
    List of warnings for the response

  - `errors` (array)
    List of errors for the response

  - `errors.message` (string)
    Error message

  - `errors.code` (string)
    Error code

  - `errors.details` (string,null)
    Additional error details

## Response 403 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"

## Response 404 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"

## Response 410 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"

## Response 500 fields (application/json):

  - `meta` (object)
    The meta

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"


