{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"bbe29d1b-8606-41f6-bc87-866912882a53","name":"Casona API v1","description":"## Introduction\n\nThe Casona API provides a secure, RESTful interface for automating your hotel management workflows. By leveraging standard HTTP methods and JSON payloads, you can seamlessly integrate reservation and guest management into your own applications or scripts. Whether you need to pull a list of upcoming bookings, create new reservations, or update guest profiles, the Casona API makes it simple to keep your operations in sync.\n\n**Please note that the Casona API is under active development. As a result, endpoints, request/response formats, and behaviors may change at short notice. We recommend keeping your integration flexible, subscribing to our changelog, and consulting the latest documentation to stay up to date.**\n\n## Key points\n\n- The API only responds to HTTPS-secured communications. Any requests sent via HTTP return an HTTP 301 redirect to the corresponding HTTPS resources.\n    \n- The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.\n    \n- Authenticate by POSTing your email and password to the `/auth` endpoint to receive a Bearer token.\n    \n- Include the header `Authorization: Bearer {token}` on all requests after login.\n    \n- Always set `Content-Type: application/json` when sending a JSON body.\n    \n\n## **Getting started guide**\n\nFirst, the login details (email, password) and hotel ID must be entered in the Postman environment. Once you have successfully logged in, the venture ID will be added automatically.\n\nAfter that, categories, rooms, guests, and statuses can be added. The remaining models can only be used afterwards, as creating a reservation, for example, requires an existing guest ID. To test the creation of reservations, this sequence must be followed:\n\n1. Create a guest with first name, last name, and email address.\n    \n2. Create a reservation with the check-in and check-out dates and the `guest_id`.\n    \n3. Now create the booked rooms (rooming) for this reservation. These require the reservation ID (`reservation_id`).\n    \n\n## Authentication\n\nTo authenticate, the Casona API requires your email address and password in exchange for a Bearer token.\n\nYou can create a new user with the desired rights for using the API within Casona. Please contact the administrator if you do not have the necessary user rights to do so.\n\n### Authentication error response\n\nIf an API key is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.\n\n## Rate and usage limits\n\nThe Casona API is provided to help you build powerful integrations while ensuring a fair and reliable service for everyone. Please use your allocated requests thoughtfully and in accordance with your plan’s guidelines — unnecessarily frequent or abusive traffic can degrade performance for all users.\n\nIf an account consistently exceeds reasonable usage limits or otherwise violates these policies, Casona reserves the right to throttle, suspend, or revoke API access to protect the overall stability of the platform. We appreciate your cooperation in helping us maintain a high-quality experience for the entire community.\n\n### 503 response\n\nAn HTTP `503` response from our servers indicates there is an unexpected spike in API access traffic. The server is usually operational within the next five minutes. If the outage persists or you receive any other form of an HTTP `5XX` error, contact support at: [support@casona.com](https://mailto:support@casona.com)\n\n### **Need some help?**\n\nIn case you have questions, visit our German help page, which provides instructions on important topics: [https://www.casona.com/de/hilfe](https://www.casona.com/de/hilfe)\n\nAny other questions will be answered by our friendly support team. Simply write to: [support@casona.com ](https://mailto:support@casona.com) — please remember to name the hotel concerned.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"15123537","team":9308439,"collectionId":"bbe29d1b-8606-41f6-bc87-866912882a53","publishedId":"2sB3BBqBgN","public":true,"publicUrl":"https://developer.casona.com","privateUrl":"https://go.postman.co/documentation/15123537-bbe29d1b-8606-41f6-bc87-866912882a53","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"d92e73"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"Casona API v1 Documentation"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/b15c5d72-a49f-4846-a60f-55ea6039b994/Y2Fzb25hLWxvZ28tc21hbGwucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"d92e73"}},{"name":"light","logo":"https://content.pstmn.io/b15c5d72-a49f-4846-a60f-55ea6039b994/Y2Fzb25hLWxvZ28tc21hbGwucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"d92e73"}}]}},"version":"8.10.1","publishDate":"2025-08-05T14:14:29.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Casona API v1 Documentation","description":""},"logos":{"logoLight":"https://content.pstmn.io/b15c5d72-a49f-4846-a60f-55ea6039b994/Y2Fzb25hLWxvZ28tc21hbGwucG5n","logoDark":"https://content.pstmn.io/b15c5d72-a49f-4846-a60f-55ea6039b994/Y2Fzb25hLWxvZ28tc21hbGwucG5n"}},"statusCode":200},"environments":[{"name":"Casona API v1 Example","id":"e939fa9a-7406-49f7-9839-d4bb945760d5","owner":"15123537","values":[{"key":"base_url","value":"https://api.casona.com/api/v1","enabled":true,"type":"default"},{"key":"user_email","value":"hotel-user@example.com","enabled":true,"type":"default"},{"key":"user_password","value":"password","enabled":true,"type":"secret"},{"key":"hotel_id","value":"Ab1Cd2Ef","enabled":true,"type":"default"},{"key":"bearer_token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","enabled":true,"type":"any"},{"key":"venture_id","value":"2e85bd7e-3565-43cc-a79b-d996361e6f19","enabled":true,"type":"default"},{"key":"guest_id","value":"72586d7c-70ae-436d-b1fa-baab75e6a511","enabled":true,"type":"default"},{"key":"reservation_id","value":"393d3f8a-2fde-42f9-acc3-ec6e3f089ea9","enabled":true,"type":"default"},{"key":"status_id","value":"dadacefb-2060-4297-95f7-84ce16d1addc","enabled":true,"type":"default"},{"key":"category_id","value":"f603b5b2-766d-47f5-8bc1-58e17c87c230","enabled":true,"type":"any"},{"key":"room_id","value":"1b88e11f-bbc0-4fb3-afa3-9b1dcde7757a","enabled":true,"type":"default"},{"key":"rooming_id","value":"555b0c77-43a7-450f-b7c4-ff29c4a9d362","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/6bdef107800876363a7f2912304c43eac772acacddcbd19c08afb5628c4f4a64","favicon":"https://casona.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Casona API v1 Example","value":"15123537-e939fa9a-7406-49f7-9839-d4bb945760d5"}],"canonicalUrl":"https://developer.casona.com/view/metadata/2sB3BBqBgN"}