A new endpoint is available to retrieve the list of Purpose of Stay codes configured for a hotel. Requires the Purpose of Stay feature to be activated in PMS Hotel Settings. If the feature is not activated or no codes are configured, the endpoint returns an empty results array. The endpoint supports pagination via page and per_page query parameters (maximum 50 per page).

Example response:

{
  "results": [
    {
      "id": 1262,
      "code": "Business",
      "active": true
    },
    {
      "id": 1231,
      "code": "Leisure",
      "active": true
    },
    {
      "id": 1282,
      "code": "Mix Business/Leisure",
      "active": true
    }
  ],
  "total_count": 9
}