Sign in

v1

latestOpenAPI 3.0.12026-07-245277551.2 MB
Items

Post one or more items to a reservation, house account, or group profile

Adds items to a reservation, house account, or group profile. This endpoint supports batch operations, allowing multiple items to be posted in a single request. Each item can have associated payments and custom pricing.

post/item/v1/items

Headers

x-property-idstring required
Example:1,2,3

A numeric, comma-separated string representing the property IDs, sent in the header.

Request body

OR
OR

Example request

{
  "reservationId": "RES123456",
  "houseAccountId": "123456",
  "groupCode": "GRP2025",
  "saleDate": "2025-10-06T14:30:00-07:00",
  "items": [
    {
      "itemId": "123456",
      "itemQuantity": 2,
      "itemPrice": "1050",
      "itemNote": "Extra towels requested",
      "subReservationId": "SUB123",
      "payments": [
        {
          "paymentType": "cash",
          "amount": "1050",
          "notes": "Paid at check-in"
        }
      ]
    }
  ]
}

Response

Items successfully posted

Example response

{
  "data": [
    {
      "soldProductId": "382900",
      "externalRelationId": "382900",
      "transactionStatus": "completed",
      "remainingItemQuantity": 10
    }
  ]
}