Hotel Inventory

Updates Hotel Inventory Count

post

https://ratehub.rategain.com/supplierhttps://ratehub-uat.rategain.com/supplier

/ari/inv_count

The Inventory message (OTA_HotelInvCountNotifRQ) defines the inventory counts (number of physical rooms) that are available to be booked for specific room types. When you send an Inventory message, you indicate how many rooms of that type are available on a given date. If no rooms of that type are available, products involving that room type and date will not be displayed.

Authorizations

BasicAuth

AuthorizationstringRequired

Body

application/xmlapplication/json

The root element for a message that defines room rate availability.

EchoTokenstring · min: 1 · max: 100Required

A unique identifier for this request message. This value is returned in the response message. Allowed characters are a-z, A-Z, 0-9, _ (underscore), and - (dash). The minimum length of this identifier is 1 (inclusive) and maximum length is 100 (inclusive)

Example: 5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9Pattern: ^[a-zA-Z0-9_-]{1,}$

TimeStampstring · date-timeRequired

The creation date and time of this message. The date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z Format :YYYY-MM-DDTHH:mm:ss.SSS+|-HH:mm[Z]

VersionstringOptional

Current API Version. Example- '1.0'

Example: 1.0

Responses

200

Success Response

application/xmlapplication/json

Indicates that the request message was processed successfully or not. Either 'Success' or 'Errors' is present in each message.

Timestampstring · date-timeRequired

The creation date and time of this message. The date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z Format :YYYY-MM-DDTHH:mm:ss.SSS+|-HH:mm[Z]

VersionstringOptional

Current API Version. Example- '1.0'

Example: 1.0

EchoTokenstring · min: 1 · max: 100Required

A unique identifier for this request message. This value is returned in the response message. Allowed characters are a-z, A-Z, 0-9, _ (underscore), and - (dash). The minimum length of this identifier is 1 (inclusive) and maximum length is 100 (inclusive)

Example: 5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9Pattern: ^[a-zA-Z0-9_-]{1,}$

SuccessobjectOptional

Indicates that the request message was processed successfully

400

Bad Request

application/xmlapplication/json

401

Not Authorized

application/xmlapplication/json

405

Request Method Not Supported

application/xmlapplication/json

500

Internal Server Error

application/xmlapplication/json

default

Unexpected error

application/xmlapplication/json

post

/ari/inv_count

HTTPcURLJavaScriptPython

POST /supplier/ari/inv_count HTTP/1.1
Host: ratehub.rategain.com
Authorization: Basic username:password
Content-Type: application/xml
Accept: */*
Content-Length: 725

"<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9" TimeStamp="2023-04-14T13:48:42.647Z" Version="1.0">
  <POS>
    <Source>
      <RequestorID ID="Partner Key">
      </RequestorID>
    </Source>
  </POS>
  <Inventories HotelCode="TEST_Hotel">
    <Inventory>
      <StatusApplicationControl Start="2023-04-14" End="2023-04-14" InvTypeCode="ITC_1" RatePlanCode="RPC_1">
      </StatusApplicationControl>
      <InvCounts>
        <InvCount Count="5" CountType="2">
        </InvCount>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>"

application/xmlapplication/json

Schema ExampleSetRoomsStopSell

<?xml version="1.0" encoding="UTF-8"?> <HotelNotifRS Timestamp="2023-02-28T11:44:23.691Z" Version="1.0" EchoToken="5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9">
    <Success>
    </Success>
</HotelNotifRS>

Get Hotel Inventories

get

https://ratehub.rategain.com/supplierhttps://ratehub-uat.rategain.com/supplier

/ari/inv_count/{hotelCode}/{itc}

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

hotelCodestringRequired

itcstringRequired

Query parameters

datesstring · yyyy-MM-dd[]Required

List of check-in dates

Requester_IDstringOptional

Responses

200

Success

application/json

Get the inventory information by hotel code and inventory code.

EchoTokenstring · min: 1 · max: 100Optional

A unique identifier for this request message. This value is returned in the response message. Allowed characters are a-z, A-Z, 0-9, _ (underscore), and - (dash). The minimum length of this identifier is 1 (inclusive) and maximum length is 100 (inclusive)

Example: 5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9Pattern: ^[a-zA-Z0-9_-]{1,}$

Timestampstring · date-timeOptional

The creation date and time of this message. The date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z Format :YYYY-MM-DDTHH:mm:ss.SSS+|-HH:mm[Z]

ApiVersionstringOptional

Current API Version. Example- '1.0'

Example: 1.0

get

/ari/inv_count/{hotelCode}/{itc}

HTTPcURLJavaScriptPython

GET /supplier/ari/inv_count/{hotelCode}/{itc}?dates=text HTTP/1.1
Host: ratehub.rategain.com
Authorization: Basic username:password
Accept: */*

200

Success

{
  "EchoToken": "5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9",
  "Timestamp": "2026-05-08T09:25:49.611Z",
  "ApiVersion": "1.0",
  "Message": [
    {
      "LastUpdatedEchoToken": "5fe69c95ed70a9869d9f9af7d8400a6673bb9ce9",
      "CreatedAt": "2026-05-08T09:25:49.611Z",
      "UpdatedAt": "2026-05-08T09:25:49.611Z",
      "HotelCode": "TEST_Hotel",
      "CheckInDate": "2026-05-08",
      "Itc": "ITC_1",
      "RoomName": "text",
      "Count": 4
    }
  ],
  "Errors": {
    "Error": [
      {
        "Type": 12,
        "Code": 450,
        "Status": "Not processed",
        "Text": "Error Text"
      }
    ]
  }
}