GET hotels/{hotelId}/transactions?key={key}&fromDate={fromDate}&toDate={toDate}

Gets all Transactions created during a specific Date Range for the hotel specified.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
hotelId

Hotel-Id => checked against the calling applications permissions

string

Required

key

API - Key identifying the caller

string

Required

fromDate

Start Day of the Date Range during which the transaction was created, Format YYYY-MM-DD

date

Required

toDate

End Day of the Date Range during which the transaction was created, Format YYYY-MM-DD

date

Required

Body Parameters

None.

Response Information

Resource Description

List of Transactions

Collection of Transaction
NameDescriptionTypeAdditional information
AmountNoTax

Net amount spend (excluding taxes)

decimal number

None.

AmountTax

Amount of tax spend

decimal number

None.

Details

Description of the transaction details

string

None.

FolioTranNumber

A unique numerical identifier for the transaction posted to the guest folio

integer

None.

GuestId

Unique ID of the Guest

string

None.

HotelId

Unique Hotel - Id

string

None.

ReservationId

Id of the reservation this transaction is mapped to

integer

None.

SpendCode

Transaction Code as defined in the roomkey - backend

string

None.

TransactionDateTime

Date and time the transaction was started

date

None.

TransactionId

Transaction Id - unique per reservation

integer

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "AmountNoTax": 1.0,
    "AmountTax": 2.0,
    "Details": "sample string 3",
    "FolioTranNumber": 4,
    "GuestId": "sample string 5",
    "HotelId": "sample string 6",
    "ReservationId": 7,
    "SpendCode": "sample string 8",
    "TransactionDateTime": "2024-11-21T10:41:15.8122998-08:00",
    "TransactionId": 10
  },
  {
    "AmountNoTax": 1.0,
    "AmountTax": 2.0,
    "Details": "sample string 3",
    "FolioTranNumber": 4,
    "GuestId": "sample string 5",
    "HotelId": "sample string 6",
    "ReservationId": 7,
    "SpendCode": "sample string 8",
    "TransactionDateTime": "2024-11-21T10:41:15.8122998-08:00",
    "TransactionId": 10
  }
]

application/xml, text/xml

Sample:
<ArrayOfTransaction xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RoomKeyAPI.Models">
  <Transaction>
    <AmountNoTax>1</AmountNoTax>
    <AmountTax>2</AmountTax>
    <Details>sample string 3</Details>
    <FolioTranNumber>4</FolioTranNumber>
    <GuestId>sample string 5</GuestId>
    <HotelId>sample string 6</HotelId>
    <ReservationId>7</ReservationId>
    <SpendCode>sample string 8</SpendCode>
    <TransactionDateTime>2024-11-21T10:41:15.8122998-08:00</TransactionDateTime>
    <TransactionId>10</TransactionId>
  </Transaction>
  <Transaction>
    <AmountNoTax>1</AmountNoTax>
    <AmountTax>2</AmountTax>
    <Details>sample string 3</Details>
    <FolioTranNumber>4</FolioTranNumber>
    <GuestId>sample string 5</GuestId>
    <HotelId>sample string 6</HotelId>
    <ReservationId>7</ReservationId>
    <SpendCode>sample string 8</SpendCode>
    <TransactionDateTime>2024-11-21T10:41:15.8122998-08:00</TransactionDateTime>
    <TransactionId>10</TransactionId>
  </Transaction>
</ArrayOfTransaction>