# hetras Hotel API Version 0 API

> hetras Hotel API Version 0 API on Apizie: 21 endpoints (Get a list of all the hotels of a chain your application has access to., Get the details of the hotel with the speccified hotel id., Get a list of codes for the specified hotel either filtered by type or code., Get all the details for a specific code available for the hotel., …) returned as clean JSON through one API key. 21 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:hetras-certification-hotel`
- Category: Open Data
- Status: live
- Source: https://hetras-certification.net
- Page: https://zieapi.vercel.app/api/open-data/hetras-certification-hotel
- OpenAPI: https://zieapi.vercel.app/api/open-data/hetras-certification-hotel/openapi.json



## Endpoints

### Get a list of all the hotels of a chain your application has access to.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/hotels-get-hotels`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |

### Get the details of the hotel with the speccified hotel id.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/hotels-get-hotel`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes |  |

### Get a list of codes for the specified hotel either filtered by type or code.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/codes-get-codes`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id you are trying to find codes for. |
| code | string | no | Return all results matching the specified code. A code is unique in combination with the type which means when you query for a code you… |
| type | string | no | Return all codes for the specified type |

### Get all the details for a specific code available for the hotel.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/codes-get-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the code available for. |
| id | string | yes | The code identifier you want to see details for. |

### Get a list of rateplans for the specified hotel id matching the filter criteria.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rateplans`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id you are trying to find rateplans for. |
| sellingStatus | string | no | Specify which rateplans to return. If you do not specify a value you will by default get active rateplans. |
| commissionable | boolean | no | Return all rateplans having commisionable status |
| group | string | no | Return all rateplans belonging to the specified rateplan group |
| baseRateplan | string | no | Return all rateplans having the specified rateplan as base rateplan |
| channelGroup | string | no | Return all rateplans that are sold through at least one channel out of the specified channel group |
| channelCode | string | no | Return all rateplans sold through the specified channel |
| marketCodes | array | no | Return all rateplans having one of the specified values as a market code |
| roomTypes | array | no | Return all rateplans by which at least one of the specified room types are sold |
| includedServices | array | no | Return all rateplans having at least one of the specified services included |
| skip | integer | no | Amount of items to skip. |
| top | integer | no | Amount of items to select. |
| inlinecount | string | no | Return total number of items for a given filter criteria. |

### Get the count of all rateplans in the hotel matching the given filter criteria.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rateplans-count`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel you are counting the rateplans for. |
| sellingStatus | string | no | Specify which rateplans to return. If you do not specify a value you will by default get active rateplans. |
| commissionable | boolean | no | Return all rateplans having commisionable status |
| group | string | no | Return all rateplans belonging to the specified rateplan group |
| baseRateplan | string | no | Return all rateplans having the specified rateplan as base rateplan |
| channelGroup | string | no | Return all rateplans that are sold through at least one channel out of the specified channel group |
| channelCode | string | no | Return all rateplans sold through the specified channel |
| marketCodes | array | no | Return all rateplans having one of the specified values as a market code |
| roomTypes | array | no | Return all rateplans by which at least one of the specified room types are sold |
| includedServices | array | no | Return all rateplans having at least one of the specified services included |

### Update a list of base rateplans for a given period and a given base price for single occupancy.
`POST https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-batch-update-rates`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| body | object | yes | JSON request body |

### Get all the details for a specific rateplan in the hotel.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rateplan`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to see details for. |

### Get the setup of the daily rates for a specific rateplan and a defined timeperiod.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rates`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to see details for. |
| expand | string | no | You can expand the supplements per room type on demand. By default they are not shown. |
| from | string | yes | Defines the last business day you would like to get rates for. The maximum time span between from ´and to is limited to 365 days. |
| to | string | yes | Defines the first business day you would like to get rates for. |
| skip | integer | no | Amount of items to skip. |
| top | integer | no | Amount of items to select. |
| inlinecount | string | no | Return total number of items for a given filter criteria. |

### Partially update a rate of the specified rateplan for the defined time period.
`POST https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-patch-rates`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to update the daily rate details for. |
| from | string | yes | Defines the last business day you would like to get rates for. The maximum time span between from ´and to is limited to 365 days. |
| to | string | yes | Defines the first business day you would like to get rates for. |
| body | object | yes | JSON request body |

### Get the count of all active and loaded daily rates for the defined rateplan in a specified time period.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rates-count`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to count daily rates for. |
| from | string | yes | Defines the last business day you would like to get rates for. The maximum time span between from ´and to is limited to 365 days. |
| to | string | yes | Defines the first business day you would like to get rates for. |

### Get the setup of a daily rate for a specific business day and rateplan.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-get-rate`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to see details for. |
| businessDay | string | yes | The business day you want to get the rate setup for. |

### Partially update a rate of the specified rateplan for a defined business day.
`POST https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rate-plans-patch-rate`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the rateplan belongs to. |
| rateplanCode | string | yes | The code of the rateplan you want to update the daily rate details for. |
| businessDay | string | yes | The business day of the daily rate you want to update. |
| body | object | yes | JSON request body |

### Get a list with the details of all room types for for the specified hotel id.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/room-types-get-room-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the room type belongs to. |

### Get all the details for a specific room type in the hotel.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/room-types-get-room-type`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the room type belongs to. |
| code | string | yes | The code of the room type you want to see details for. |

### Get a list of rooms using the provided filtering and pagination criteria.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rooms-get-rooms`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel you are trying to find rooms for. |
| occupancy | string | no | Return results only for rooms that have the given frontdesk ocuppancy status. |
| conditions | array | no | Return results only for rooms that have the given room condition status. |
| maintenances | array | no | Return results only for rooms that have the given maintenance status. |
| roomTypes | array | no | Return result only for rooms for the given room types. Allows to pass a comma-separated list of room types. |
| amenities | array | no | Return result only for rooms having all of the given amenities. You can provide a comma seperated list of amenity codes. |
| views | array | no | Return result only for rooms having at least one of the specified views. You can provide a comma seperated list of view codes. |
| locations | array | no | Return result only for rooms having at least one of the specified locations. You can provide a comma seperated list of location codes. |
| skip | integer | no | Amount of items to skip. |
| top | integer | no | Amount of items to select. |
| inlinecount | string | no | Return total number of items for a given filter criteria. |

### Get the count of all rooms in the hotel matching the given filter criteria.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rooms-get-rooms-count`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel you are counting the rooms for. |
| occupancy | string | no | Return results only for rooms that have the given frontdesk ocuppancy status. |
| conditions | array | no | Return results only for rooms that have the given room condition status. |
| maintenances | array | no | Return results only for rooms that have the given maintenance status. |
| roomTypes | array | no | Return result only for rooms for the given room types. Allows to pass a comma-separated list of room types. |
| amenities | array | no | Return result only for rooms having all of the given amenities. You can provide a comma seperated list of amenity codes. |
| views | array | no | Return result only for rooms having at least one of the specified views. You can provide a comma seperated list of view codes. |
| locations | array | no | Return result only for rooms having at least one of the specified locations. You can provide a comma seperated list of location codes. |

### Request available rooms using a given criteria.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rooms-get-available-rooms`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel you are looking for available rooms. |
| from | string | yes | Rooms returned will not be assigned to a reservation or be under maintenance between this date and the specified to date. Still there… |
| to | string | yes | Rooms returned will not be assigned to a reservation or be under maintenance between the specified from date and this date. Still there… |
| adults | string | no | Specifies number of adults the returned rooms will have to be able to house. The default value is 1. |
| includeOutOfService | boolean | no | Should rooms that are set OutOfService in the defined time period be returned as available. By default they are not. |
| roomTypes | array | no | Return result only for rooms for the given room types. Allows to pass a comma-separated list of room types. |
| amenities | array | no | Return result only for rooms having all of the given amenities. You can provide a comma seperated list of amenity codes. |
| views | array | no | Return result only for rooms having at least one of the specified views. You can provide a comma seperated list of view codes. |
| locations | array | no | Return result only for rooms having at least one of the specified locations. You can provide a comma seperated list of location codes. |
| skip | integer | no | Amount of items to skip. |
| top | integer | no | Amount of items to select. |
| inlinecount | string | no | Return total number of items for a given filter criteria. |

### Get all the details for a specific room in the hotel.
`GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rooms-get-room`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the room belongs to. |
| roomNumber | string | yes | The room number you want to see details for. |

### Partially updates a room.
`POST https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/rooms-patch-room`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | The hotel id the room belongs to. |
| roomNumber | string | yes | The room number of the room you would like to update. |
| body | object | yes | JSON request body |

### Saves Yieldable Rate Prices for existing Yieldable Rateplan.
`POST https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/yieldable-rates-save-prices`

| Parameter | Type | Required | Description |
|---|---|---|---|
| App-Id | string | yes | Application identifier |
| App-Key | string | yes | Application key. |
| hotelId | integer | yes | Specifies the hotelId which identifies Hotel for which the operation will be performed. |
| rateplanCode | string | yes | Specifies the rateplanCode for which the operation will be performed. |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/hotels-get-hotels" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the hetras Hotel API Version 0 API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:hetras-certification-hotel/hotels-get-hotels with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the hetras Hotel API Version 0 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the hetras Hotel API Version 0 API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:hetras-certification-hotel.

### What is the status of the hetras Hotel API Version 0 API?
Live: works with just an Apizie key