---
title: 'Get allotments'
url: 'https://documentation.netstorming.net/channel-manager/channel-manager-protocol/get-allotments'
markdown: 'https://documentation.netstorming.net/channel-manager/channel-manager-protocol/get-allotments.md'
date: '2026-11-10'
description: 'The supplier sends this message to request the availability about saved structures. The query type(type) is set to getavail. Below you can see the fields you can find in the message body and their meanings. Request roomtype Room type. It collects all data relating to a room type. roomcode Room …'
taxonomy:
  category:
    - docs
---

# Get allotments

[](#)  [ Channel Manager ](https://documentation.netstorming.net/channel-manager)     [ Channel Manager Protocol ](https://documentation.netstorming.net/channel-manager/channel-manager-protocol)      Get allotments    

The supplier sends this message to request the availability about saved structures. The query type(**type**) is set to **getavail**.

Below you can see the fields you can find in the message body and their meanings.

##### Request

- **roomtype**

    Room type. It collects all data relating to a room type.
- **roomcode**

    Room type. Collects all data for a type of room.
- - **SGL single room**
- - The availabilities of the **TSU (twin for sole use room)** are inherited from the TWN.
- - **TWN twin room**
- - **DBL double room**
- - **TRP triple room**
- - **QUD quadruple room**
- - **STR big accommodations**
- **startdate**

    requested effective date
- **days**

    requested number of days of availability. (You can add this number to the start date to get the end date. If these two dates correspond you must set this value to 0)

Let’s see an example of message the client could send.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<envelope>
       <header>
        <actor>...</actor>
        <user>...</user>
        <password>...</password>
          <version>0.1b</version>
          <timestamp>20210427</timestamp>
          <transaction>160125</transaction>
      </header>
  <query type="getavail" product="hotel" agrement="1299">
        <roomtype roomcode="SGL">
          <startdate>2018-12-01</startdate>
          <days>60</days>
        </roomtype>
        <roomtype roomcode="DBL">
          <startdate>2022-12-01</startdate>
          <days>60</days>
        </roomtype>
        <roomtype roomcode="TRP">
          <startdate>2022-12-01</startdate>
          <days>60</days>
        </roomtype>
    </query>
</envelope>
```

##### Response

The reply message contains, within tag response, a XML text with the structure you can see below.

**roomtype**

Room type. It collects all data relating to a room type.

- **roomcode**

    Parameter that identifies the room type
- - **SGL single room**
- - **TWN twin room**
- - **DBL double room**
- - **TRP triple room**
- - **QUD quadruple room**
- - **STR big accommodations**
- **date**
- - **value**

    effective date
- - **days**

    number of days (You can add this number to the start date to get the end date. If these two dates correspond this value has to be set to 0).
- - **avail**

    number of available rooms
- - **release**

    number of release hour
- - **maxrelease**

    maximum number of release hour

Let’s see an example of message the client could receive.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<envelope>
    <header>
        <actor>...</actor>
        <user>...</user>
        <version>0.1b</version>
        <timestamp>20210219163902</timestamp>
        <transaction>160125</transaction>
    </header>
    <response type="getavail"/>
    <roomtype roomcode="TRP">
        <date value="2022-12-03">
            <days>1</days>
            <avail>4</avail>
            <release>7</release>
            <maxrelease>9</maxrelease>
            <generic>F</generic>
        </date>
    </roomtype>
    <roomtype roomcode="SGL">
        <date value="2022-12-03">
            <days>1</days>
            <avail>0</avail>
            <release>7</release>
            <maxrelease>9</maxrelease>
            <generic>F</generic>
        </date>
    </roomtype>
    <roomtype roomcode="DBL">
        <date value="2022-12-03">
            <days>1</days>
            <avail>4</avail>
            <release>7</release>
            <maxrelease>9</maxrelease>
            <generic>F</generic>
        </date>
    </roomtype>
</envelope>
```

In case of error the reply message contains, within tag **response**, the string "error code XX (description)", where XX represents an error code.

 [ ](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-all) [](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/get-tariffs)

---

## Navigation

- Parent: [Channel Manager Protocol](https://documentation.netstorming.net/channel-manager/channel-manager-protocol.md)
- Previous: [Set all](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-all.md)
- Next: [Get tariffs](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/get-tariffs.md)
