# Occupancy

## Fields

| Field | Description | Type | Min/max | Notes |
|  --- | --- | --- | --- | --- |
| [GuestRoom](/connectivity/docs/api-reference/guestroom)/`Occupancy` | Room occupancy details. | object | 1..1 | - |
| `Occupancy`/`@MaxOccupancy` | Specifies the maximum number of guests allowed to stay in the room type. | int | 0..1 | The value for `@MaxOccupancy` cannot be higher than the sum of the values for `@MaxAdultOccupancy` and `@MaxChildOccupancy`. You can separately [specify extra bed options](/connectivity/docs/setting-up-children-policies-and-pricing) at property level. |
| `Occupancy`/`@MaxAdultOccupancy` | Specifies the maximum number of adult guests allowed to stay in the room type. | int | 0..1 |  |
| `Occupancy`/`@MaxChildOccupancy` | Specifies the maximum number of children allowed to physically stay in the room type. | int | 0..1 | The value for `@MaxChildOccupancy` is always lower than that for `@MaxOccupancy`, because you cannot have a room with only children. |
| [GuestRoom](/connectivity/docs/api-reference/guestroom)/`TPA_Extensions` | Room occupancy details. | object | 1..1 | - |
| [TPA_Extensions](/connectivity/docs/api-reference/tpa_extensions)/`Occupancy` | Extra child occupancy details. | object | 0..1 | - |
| `Occupancy`/`@MaxChildPayableOccupancy` | Specifies the maximum number of children that are eligible for the children rate. | int | 0..1 | [This field is going to be deprecated on 23 June 2026](/connectivity/docs/deprecation-policy/deprecation-and-sunsetting#deprecating-legacy-max-payable-child-field). The value for `@MaxChildPayableOccupancy` cannot be higher than the value of `@MaxChildOccupancy`. |


## XML


```xml
<Occupancy MaxOccupancy="2" MaxAdultOccupancy="2" MaxChildOccupancy="1"/>
<TPA_Extensions>  
        <Occupancy MaxChildPayableOccupancy="1" />  
</TPA_Extensions>
```

## Related endpoints

* [/ota/OTA_HotelInvNotif](/connectivity/docs/ota-hotelinvnotif)