{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"You will need an ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}}]},{"text":"API key","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}},{"type":"strong"}]},{"text":" for authorizing your requests. You can request an API key from our Customer Care team. ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}}]},{"type":"hardBreak"},{"text":"The API key must be passed in an HTTP header named ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}}]},{"text":"X-CA-AUTH","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}},{"type":"strong"}]},{"text":" when requesting any of the API endpoints.","type":"text","marks":[{"type":"subsup","attrs":{"type":"sub"}}]}]},{"type":"paragraph","content":[{"text":"The default endpoint is ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":"https://api.customer-alliance.com","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}},{"type":"strong"},{"type":"link","attrs":{"href":"https://api.customer-alliance.com"}}]},{"text":", if not stated differently.","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reviews","type":"text"}]},{"type":"expand","attrs":{"title":"GET /reviews/v2/ca.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /reviews/v2/ca.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The new version of the Review API is available ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://customer-alliance.atlassian.net/wiki/spaces/CAA/pages/3126427664"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"API allows access to the data that was collected via Customer Alliance review questionnaires. This may include information such as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Review content;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Average rating;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Information about the guest leaving the review.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"e3d31773-83d3-4a35-bddc-404b46ffdcd3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"page","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer greater than or equal to 1. ","type":"text"},{"type":"hardBreak"},{"text":"The number of reviews per request is limited to the value of limit, this parameter is responsible for pagination.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"180 days before the end date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the earliest review you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"today","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Must not be earlier than the value of start.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the latest review you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"category","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"'average'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"A valid review rating category, also known as a 'criteria'. ","type":"text"},{"type":"hardBreak"},{"text":"A list of categories can be seen in the response of this endpoint without supplying the parameters.","type":"text"},{"type":"hardBreak"},{"text":"Use this to filter reviews by subcategory, e.g, ‘price’, ‘breakfast’, etc.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"fromRating","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer between 0 and 100.","type":"text"},{"type":"hardBreak"},{"text":"The lowest review score you wish included in the result set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"toRating","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"100","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer between 0 and 100.","type":"text"},{"type":"hardBreak"},{"text":"The highest review score you wish included in the result set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"commentStatus","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Must be one of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"not_commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"drafted","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Filters reviews as to whether they have been commented, not commented or have had a comment drafted.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"categoryRatings","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Either 1 or 0.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Either 1 or 0. ","type":"text"},{"type":"hardBreak"},{"text":"If the published parameter is added with value 1. The results will only contain reviews that have been published (public reviews).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"limit","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"The number of reviews shown per page.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: \" https://api.customer-alliance.com/reviews/v2/ca.json?page=1&start=2021-01-01&end=2021-01-13&fromRating=0&toRating=100&categoryRatings=1&published=0&limit=20","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"totalCount\": 1,\n \"reviews\": [\n {\n \"hotel_name\": \"Restaurant The Eagle\",\n \"review_id\": \"careview52326183\",\n \"review_source\": \"customeralliance\",\n \"average_rating_normalized\": \"90.0000\",\n \"average_rating\": \"4.5000\",\n \"reviewer_type\": null,\n \"language\": \"en\",\n \"published\": false,\n \"reviewer_comment\": \"It was a nice experience, definitely worth coming again\",\n \"reviewer_comment_positive\": \"\",\n \"reviewer_comment_negative\": \"\",\n \"arrival_date\": \"2021-01-09\",\n \"departure_date\": \"2021-01-09\",\n \"review_date\": \"2021-01-12 09:07:46\",\n \"author\": \"Customer Alliance u.\",\n \"category_ratings\": {\n \"price\": {\n \"rating\": 80,\n \"label\": \"Price\",\n \"comment\": null\n },\n \"service\": {\n \"rating\": 100,\n \"label\": \"Service\",\n \"comment\": null\n },\n \"FoodQuality\": {\n \"rating\": 100,\n \"label\": \"Quality of Food\",\n \"comment\": null\n },\n \"Atmosphere\": {\n \"rating\": 80,\n \"label\": \"Atmosphere\",\n \"comment\": null\n }\n },\n \"nps\": 9,\n \"brand_nps\": null,\n \"age\": 30,\n \"hotelier_comment\": null\n }\n ]\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"GET /reviews/v2/all.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /reviews/v2/all.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Review data collected via Customer Alliance questionnaires and reviews from external portals (for example Booking, Google, Expedia, Tripadvisor, HolidayCheck","type":"text"},{"text":").","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6be24742-80cc-408f-a05e-41b8f2d41aac"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"43d331e3-a87b-4305-b925-b0392fa89d86"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"page","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer greater than or equal to 1. ","type":"text"},{"type":"hardBreak"},{"text":"The number of reviews per request is limited to the value of limit, this parameter is responsible for pagination.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"180 days before the end date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the earliest review you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"today","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Must not be earlier than the value of start.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the latest review you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"fromRating","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer between 0 and 100.","type":"text"},{"type":"hardBreak"},{"text":"The lowest review score you wish included in the result set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"toRating","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"100","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer between 0 and 100.","type":"text"},{"type":"hardBreak"},{"text":"The highest review score you wish included in the result set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"commentStatus","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Must be one of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"not_commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"drafted","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Filters reviews as to whether they have been commented, not commented or have had a comment drafted.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"categoryRatings","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Either 1 or 0.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Either 1 or 0. ","type":"text"},{"type":"hardBreak"},{"text":"If the published parameter is added with value 1. The results will only contain reviews that have been published (public reviews).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"limit","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"The number of reviews shown per page.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: \" https://api.customer-alliance.com/reviews/v2/all.json?page=1&start=2025-01-01&end=2025-01-12&categoryRatings=1","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4bbeb224-390c-4bda-822c-fb59d4929b03"}}]}]},{"type":"codeBlock","content":[{"text":"{\n \"totalCount\": 3,\n \"reviews\": [\n {\n \"hotel_name\": \"Some hotel\",\n \"review_id\": \"careview102033000\",\n \"review_source\": \"customeralliance\",\n \"average_rating_normalized\": \"64\",\n \"average_rating\": \"3.2\",\n \"reviewer_type\": \"alone\",\n \"language\": \"de\",\n \"published\": false,\n \"hotelier_comment\": null,\n \"nps\": 2,\n \"brand_nps\": null,\n \"reviewer_comment\": \"Wäre schön gewesen, wenn alles dass bei der Buchung telefonisch vereinbart wurde\",\n \"reviewer_comment_positive\": null,\n \"reviewer_comment_negative\": null,\n \"pms_guest_id\": \"4f9c8336-789c-4511-9844-20baac154d2e\",\n \"arrival_date\": \"2025-01-03\",\n \"departure_date\": \"2025-01-04\",\n \"review_date\": \"2025-01-06 23:27:19\",\n \"author\": null,\n \"category_ratings\": {\n \"price\": {\n \"rating\": 40,\n \"label\": \"Price\",\n \"comment\": null\n },\n \"room\": {\n \"rating\": 80,\n \"label\": \"Room\",\n \"comment\": null\n },\n \"location\": {\n \"rating\": 80,\n \"label\": \"Location\",\n \"comment\": null\n },\n \"clean\": {\n \"rating\": 80,\n \"label\": \"Cleanliness\",\n \"comment\": null\n },\n \"service\": {\n \"rating\": 40,\n \"label\": \"Service\",\n \"comment\": null\n },\n \"Funktionalität\": {\n \"rating\": 80,\n \"label\": \"Functionality\",\n \"comment\": null\n }\n }\n },\n {\n \"hotel_name\": \"Some hotel\",\n \"review_id\": \"booking12345_GR_geaK2WuV\",\n \"review_source\": \"booking\",\n \"average_rating_normalized\": \"90\",\n \"average_rating\": \"9\",\n \"reviewer_type\": null,\n \"language\": \"en\",\n \"published\": true,\n \"hotelier_comment\": null,\n \"reviewer_comment\": null,\n \"reviewer_comment_positive\": \"transfer services\",\n \"reviewer_comment_negative\": \"bar price\",\n \"review_date\": \"2025-01-08 10:56:41\",\n \"author\": \"John\",\n \"category_ratings\": {\n \"facilities\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Facilities\"\n },\n \"location\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Location\"\n },\n \"staff\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Staff\"\n },\n \"clean\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Cleanliness\"\n },\n \"comfort\": {\n \"rating\": 75,\n \"comment\": null,\n \"label\": \"Comfort\"\n },\n \"price\": {\n \"rating\": 50,\n \"comment\": null,\n \"label\": \"Price\"\n }\n }\n },\n {\n \"hotel_name\": \"Some hotel\",\n \"review_id\": \"expedia34521_6796510d21b7076af1b788b2\",\n \"review_source\": \"expedia\",\n \"average_rating_normalized\": \"100\",\n \"average_rating\": \"10\",\n \"reviewer_type\": null,\n \"language\": \"en\",\n \"published\": true,\n \"hotelier_comment\": \"Dear Guest,\\n\\nThank you for taking the time to leave us a review.\",\n \"reviewer_comment\": \"nice location\",\n \"reviewer_comment_positive\": null,\n \"reviewer_comment_negative\": null,\n \"review_date\": \"2025-01-10 16:15:05\",\n \"author\": \"Anna\",\n \"category_ratings\": {\n \"condition\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Hotel condition\"\n },\n \"room_clean\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Cleanliness & linen change\"\n },\n \"service\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Service\"\n },\n \"facilities\": {\n \"rating\": 100,\n \"comment\": null,\n \"label\": \"Facilities\"\n }\n }\n },\n ]\n}","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Please note that we have the latest version (V3) available here ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://customer-alliance.atlassian.net/wiki/spaces/CAA/pages/3126427664"}},{"text":" ","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Statistics","type":"text"}]},{"type":"expand","attrs":{"title":"GET /statistics/v1/categories.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /statistics/v1/categories.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Shows the rating categories currently used for aggregation on your API key.","type":"text"},{"type":"hardBreak"},{"text":"The data refreshes every 2 hours.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"cc344ecc-9b65-4b09-8aca-e234a181f6cf"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"review_subject","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"First created review subject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"It refers to Review Config's hash value. By default access key has access to 100 review subjects, by using \"review_subject\" parameter you can specify for which subject you would like to retrieve data.","type":"text"},{"type":"hardBreak"},{"text":"Must be a value from 'hash' field, looks like: e3600bf31c28b60e","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: YOUR_API_KEY\" https://api.customer-alliance.com/statistics/v1/categories.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The result here will vary depending on the categories configured for your business and the questions marked as 'Show in Statistics' or 'Public' in your questionnaire.","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"[\n \"Amenities\",\n \"Apartment\",\n \"Entertainment\",\n \"Hospitality\",\n \"Reception\",\n \"bar\",\n \"beach\",\n \"break\",\n \"childcare\",\n \"clean\",\n \"comfort\",\n \"conference\",\n \"food\",\n \"location\",\n \"pool\",\n \"price\",\n \"private_beach\",\n \"restaurant\",\n \"room\",\n \"service\",\n \"sport\",\n \"value_for_money\",\n \"vibe\",\n \"wellness\",\n \"wifi\"\n]","type":"text"}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"GET /statistics/v2/general/recent.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /statistics/v2/general/recent.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Shows statistics for rating categories, including the overall category, for all reviews authored in the past 6 months.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"ff2d76b8-be91-4c64-a502-a2c9c66f3698"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"_locale","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":" en","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Changes the language used to show the category labels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be a valid ISO 3166-1 alpha-2 language code. For example: 'en' for English, 'fr' for French.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"review_subject","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"First created review subject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"It refers to Review Config's hash value. By default access key has access to 100 review subjects, by using \"review_subject\" parameter you can specify for which subject you would like to retrieve data.","type":"text"},{"type":"hardBreak"},{"text":"Must be a value from 'hash' field, looks like: e3600bf31c28b60e","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Possible values: either 0 or 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"If set to 1 will return only data about published reviews (public reviews).","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: YOUR_API_KEY\" https://api.customer-alliance.com/statistics/v2/general/recent.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"start_date\": \"2020-08-17\",\n \"end_date\": \"2021-02-17\",\n \"comment_rate\": 30.798478707224334,\n \"category_statistics\": {\n \"overall\": {\n \"label\": \"Overall\",\n \"average_rating\": 90.51546391746737,\n \"review_count\": 582,\n \"positive_review_count\": 528,\n \"neutral_review_count\": 49,\n \"negative_review_count\": 5\n },\n \"clean\": {\n \"label\": \"Cleanliness\",\n \"average_rating\": 96.0,\n \"review_count\": 5,\n \"positive_review_count\": 5,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"comfort\": {\n \"label\": \"Comfort\",\n \"average_rating\": 86.66666666666667,\n \"review_count\": 3,\n \"positive_review_count\": 3,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"food\": {\n \"label\": \"Food\",\n \"average_rating\": 0.0,\n \"review_count\": 0,\n \"positive_review_count\": 0,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"location\": {\n \"label\": \"Location\",\n \"average_rating\": 100.0,\n \"review_count\": 3,\n \"positive_review_count\": 3,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"price\": {\n \"label\": \"Price\",\n \"average_rating\": 100.0,\n \"review_count\": 4,\n \"positive_review_count\": 4,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"restaurant\": {\n \"label\": \"Restaurant\",\n \"average_rating\": 0.0,\n \"review_count\": 0,\n \"positive_review_count\": 0,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"room\": {\n \"label\": \"Room\",\n \"average_rating\": 88.0,\n \"review_count\": 5,\n \"positive_review_count\": 4,\n \"neutral_review_count\": 1,\n \"negative_review_count\": 0\n },\n \"service\": {\n \"label\": \"Service\",\n \"average_rating\": 88.0,\n \"review_count\": 5,\n \"positive_review_count\": 4,\n \"neutral_review_count\": 1,\n \"negative_review_count\": 0\n }\n }\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"GET /statistics/v2/general/total.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /statistics/v2/general/total.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Shows statistics for rating categories, including the overall category, for all known reviews.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the parameter 'review_subject' is not set, the statistics will be shown for the first created review subject of the api-key.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"2458c00b-ed16-47ea-a1cc-d049599faf9a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"_locale","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":" en","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Changes the language used to show the category labels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be a valid ISO 3166-1 alpha-2 language code. For example: 'en' for English, 'fr' for French.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"review_subject","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"first created review subject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"It refers to Review Config's hash value. By default access key has access to 100 review subjects, by using \"review_subject\" parameter you can specify for which subject you would like to retrieve data.","type":"text"},{"type":"hardBreak"},{"text":"Must be a value from 'hash' field, looks like: e3600bf31c28b60e","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Possible values: either 0 or 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"If set to 1 will return only data about published reviews (public reviews).","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: YOUR_API_KEY\" https://api.customer-alliance.com/statistics/v2/general/total.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"start_date\": null,\n \"end_date\": null,\n \"comment_rate\": 11.12612972972973,\n \"category_statistics\": {\n \"overall\": {\n \"label\": \"Overall\",\n \"average_rating\": 88.03647184495651,\n \"review_count\": 6553,\n \"positive_review_count\": 6495,\n \"neutral_review_count\": 839,\n \"negative_review_count\": 64\n },\n \"clean\": {\n \"label\": \"Cleanliness\",\n \"average_rating\": 89.97303634044549,\n \"review_count\": 5118,\n \"positive_review_count\": 66,\n \"neutral_review_count\": 3,\n \"negative_review_count\": 0\n },\n \"food\": {\n \"label\": \"Food\",\n \"average_rating\": 0.0,\n \"review_count\": 0,\n \"positive_review_count\": 0,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"location\": {\n \"label\": \"Location\",\n \"average_rating\": 83.19193706981318,\n \"review_count\": 5085,\n \"positive_review_count\": 46,\n \"neutral_review_count\": 13,\n \"negative_review_count\": 0\n },\n \"price\": {\n \"label\": \"Price\",\n \"average_rating\": 89.97183098591549,\n \"review_count\": 4828,\n \"positive_review_count\": 54,\n \"neutral_review_count\": 3,\n \"negative_review_count\": 0\n },\n \"restaurant\": {\n \"label\": \"Restaurant\",\n \"average_rating\": 90.0,\n \"review_count\": 2,\n \"positive_review_count\": 0,\n \"neutral_review_count\": 0,\n \"negative_review_count\": 0\n },\n \"service\": {\n \"label\": \"Service\",\n \"average_rating\": 89.07062144180792,\n \"review_count\": 354,\n \"positive_review_count\": 92,\n \"neutral_review_count\": 11,\n \"negative_review_count\": 3\n }\n }\n}","type":"text"}]}]},{"type":"expand","attrs":{"title":"GET /statistics/v2/portal-overview.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /statistics/v2/portal-overview.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Statistics for all known reviews. Aggregated for overall and broken down by review portal (e.g. ","type":"text"},{"text":"Booking.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://Booking.com"}}]},{"text":", Google, Facebook, ...).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"b6e1d104-2c42-4b38-8759-4869c84503b6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"180 days before the end date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"To select the earliest review you wish to see.","type":"text"}]},{"type":"paragraph","content":[{"text":"A date of format yyyy-mm-dd, must be before the end date.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"today","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"To select the latest review you wish to see.","type":"text"}]},{"type":"paragraph","content":[{"text":"A date of format yyyy-mm-dd, must be after the start date.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"category","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"average","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"To filter reviews by subcategory, e.g. price, service, etc.","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be an available category (to get all the available categories check out the api '","type":"text"},{"text":"/statistics/v1/categories.json","type":"text","marks":[{"type":"code"}]},{"text":"').","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"review_subject","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"first created review subject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"It refers to Review Config's hash value. By default access key has access to 100 review subjects, by using \"review_subject\" parameter you can specify for which subject you would like to retrieve data.","type":"text"},{"type":"hardBreak"},{"text":"Must be a value from 'hash' field, looks like: e3600bf31c28b60e","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Possible values: either 0 or 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"If set to 1 will return only data about published reviews (public reviews).","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: YOUR_API_KEY\" https://api.customer-alliance.com/statistics/v2/portal-overview.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"reviewCount\": 491,\n \"averageRating\": 90.32993890011609,\n \"commentRate\": 29.14798206278027,\n \"reviewCountPositive\": 441,\n \"reviewCountNeutral\": 44,\n \"reviewCountNegative\": 6,\n \"portalStats\": {\n \"customeralliance\": {\n \"reviewCount\": 2,\n \"reviewCountPositive\": 2,\n \"reviewCountNeutral\": 0,\n \"reviewCountNegative\": 0,\n \"averageRating\": 80,\n \"commentRate\": null\n },\n \"booking\": {\n \"reviewCount\": 414,\n \"reviewCountPositive\": 373,\n \"reviewCountNeutral\": 37,\n \"reviewCountNegative\": 4,\n \"averageRating\": 90.56038647332849,\n \"commentRate\": 32.432432432432435\n }, \n \"google\": {\n \"reviewCount\": 61,\n \"reviewCountPositive\": 55,\n \"reviewCountNeutral\": 4,\n \"reviewCountNegative\": 2,\n \"averageRating\": 90.49180327867212,\n \"commentRate\": 11.475409836065573\n },\n \"hotelscom\": {\n \"reviewCount\": 3,\n \"reviewCountPositive\": 3,\n \"reviewCountNeutral\": 0,\n \"reviewCountNegative\": 0,\n \"averageRating\": 80,\n \"commentRate\": 100\n },\n \"hrs\": {\n \"reviewCount\": 0,\n \"reviewCountPositive\": 0,\n \"reviewCountNeutral\": 0,\n \"reviewCountNegative\": 0,\n \"averageRating\": 0,\n \"commentRate\": null\n },\n \"tripadvisor\": {\n \"reviewCount\": 11,\n \"reviewCountPositive\": 8,\n \"reviewCountNeutral\": 3,\n \"reviewCountNegative\": 0,\n \"averageRating\": 85.45454545454545,\n \"commentRate\": 63.63636363636363\n },\n \"tui\": {\n \"reviewCount\": 0,\n \"reviewCountPositive\": 0,\n \"reviewCountNeutral\": 0,\n \"reviewCountNegative\": 0,\n \"averageRating\": 0,\n \"commentRate\": null\n }\n }\n}","type":"text"}]}]},{"type":"expand","attrs":{"title":"GET /statistics/v1/reviews-over-time.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /statistics/v1/reviews-over-time.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Statistics for all known reviews. Aggregated weekly.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"All parameters are optional.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"f5110ff5-7c1f-455e-a0f7-11e51b850587"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"180 days before the end date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"paragraph","content":[{"text":"To select the earliest review you wish to see.","type":"text"}]},{"type":"paragraph","content":[{"text":"A date of format yyyy-mm-dd, must be before the end date.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"today","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"paragraph","content":[{"text":"To select the latest review you wish to see.","type":"text"}]},{"type":"paragraph","content":[{"text":"A date of format yyyy-mm-dd, must be after the start date.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"category","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"average","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"paragraph","content":[{"text":"To filter reviews by subcategory, e.g. price, service, etc.","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be an available category (to get all the available categories check out the api '","type":"text"},{"text":"/statistics/v1/categories.json","type":"text","marks":[{"type":"code"}]},{"text":"').","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"review_subject","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"first created review subject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"paragraph","content":[{"text":"It refers to Review Config's hash value. By default access key has access to 100 review subjects, by using \"review_subject\" parameter you can specify for which subject you would like to retrieve data.","type":"text"},{"type":"hardBreak"},{"text":"Must be a value from 'hash' field, looks like: e3600bf31c28b60e","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"forced_interval","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"depending on time range","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[398.0]},"content":[{"type":"paragraph","content":[{"text":"Possible value: ","type":"text"},{"text":"months","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To force the statistics to be grouped by months. If parameter is not given, then certain rules are applied depending on the time range (see table below).","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The time intervals used for grouping are determined by these rules:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"1ba64e62-1da2-4ce8-96d7-f7861fc680cc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[221.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Δ","type":"text","marks":[{"type":"strong"}]},{"text":" = difference in days between start & end","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[101.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Interval","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[328.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[221.0]},"content":[{"type":"paragraph","content":[{"text":"31 days <","type":"text"},{"text":" Δ ","type":"text","marks":[{"type":"strong"}]},{"text":"<= 182 days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[101.0]},"content":[{"type":"paragraph","content":[{"text":"weekly","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[328.0]},"content":[{"type":"paragraph","content":[{"text":"If parameter ","type":"text"},{"text":"forced_interval=months","type":"text","marks":[{"type":"code"}]},{"text":" is not given, then values by default will be grouped weekly. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[221.0]},"content":[{"type":"paragraph","content":[{"text":"182 days < ","type":"text"},{"text":"Δ","type":"text","marks":[{"type":"strong"}]},{"text":" <= 720 days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[101.0]},"content":[{"type":"paragraph","content":[{"text":"monthly ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[328.0]},"content":[{"type":"paragraph","content":[{"text":"Values will be always grouped monthly.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[221.0]},"content":[{"type":"paragraph","content":[{"text":"Δ","type":"text","marks":[{"type":"strong"}]},{"text":" <= 31 days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[101.0]},"content":[{"type":"paragraph","content":[{"text":"daily ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[328.0]},"content":[{"type":"paragraph","content":[{"text":"If parameter ","type":"text"},{"text":"forced_interval=months","type":"text","marks":[{"type":"code"}]},{"text":" is not given, then values by default will be grouped daily. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[221.0]},"content":[{"type":"paragraph","content":[{"text":"Δ","type":"text","marks":[{"type":"strong"}]},{"text":" > 720 days","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[101.0]},"content":[{"type":"paragraph","content":[{"text":"yearly ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[328.0]},"content":[{"type":"paragraph","content":[{"text":"If parameter ","type":"text"},{"text":"forced_interval=months","type":"text","marks":[{"type":"code"}]},{"text":" is not given, then values by default will be grouped yearly. ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --header \"X-CA-AUTH: YOUR_API_KEY\" https://api.customer-alliance.com/statistics/v1/reviews-over-time.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"Hotel XYZ\": {\n \"8 / 2020\": {\n \"review_count\": 54,\n \"positive_reviews\": 49,\n \"neutral_reviews\": 5,\n \"negative_reviews\": 0\n },\n \"9 / 2020\": {\n \"review_count\": 144,\n \"positive_reviews\": 129,\n \"neutral_reviews\": 13,\n \"negative_reviews\": 2\n },\n \"10 / 2020\": {\n \"review_count\": 88,\n \"positive_reviews\": 83,\n \"neutral_reviews\": 4,\n \"negative_reviews\": 1\n },\n \"11 / 2020\": {\n \"review_count\": 77,\n \"positive_reviews\": 70,\n \"neutral_reviews\": 7,\n \"negative_reviews\": 0\n },\n \"12 / 2020\": {\n \"review_count\": 69,\n \"positive_reviews\": 63,\n \"neutral_reviews\": 5,\n \"negative_reviews\": 1\n },\n \"1 / 2021\": {\n \"review_count\": 64,\n \"positive_reviews\": 52,\n \"neutral_reviews\": 12,\n \"negative_reviews\": 0\n },\n \"2 / 2021\": {\n \"review_count\": 55,\n \"positive_reviews\": 51,\n \"neutral_reviews\": 3,\n \"negative_reviews\": 1\n }\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Feedbacks","type":"text"}]},{"type":"expand","attrs":{"title":"GET /feedback/v2/questionnaires.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /feedback/v2/questionnaires.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Allows access feedback questionnaires (receive list of feedback questionnaires).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"This endpoint has no parameters.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"$ curl --header \"X-CA-AUTH: \" https://api.customer-alliance.com/feedback/v2/questionnaires.json","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"id\": 699083,\n \"name\": \"Breakfast Survey\"\n },\n {\n \"id\": 699093,\n \"name\": \"During Stay Feedback\"\n }\n]","type":"text"}]}]},{"type":"expand","attrs":{"title":"GET /feedback/v2/stream.json"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"GET /feedback/v2/stream.json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"Allows access to all of the feedbacks that were gathered.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"b9e06ba7-86e6-4f03-a630-405f43e5db5b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"questionnaireIds","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"A required parameter with Interger value.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: this parameter may be included multiple times, e.g.","type":"text"},{"type":"hardBreak"},{"text":"questionnaireIds=","type":"text"},{"text":"1000","type":"text","marks":[{"type":"strong"}]},{"text":"&questionnaireIds=","type":"text"},{"text":"1001","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"page","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer greater than or equal to 1. ","type":"text"},{"type":"hardBreak"},{"text":"The number of feedback items per request is limited to the value of limit, this parameter is responsible for pagination.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"180 days before the end date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the earliest feedback you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"today","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Date in the YYYY-MM-DD format.","type":"text"},{"type":"hardBreak"},{"text":"Must not be earlier than the start date.","type":"text"},{"type":"hardBreak"},{"text":"Use this to select the latest feedback you wish to see.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"limit","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Integer between 1 and 50. Used to limit the number of results per page.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"commentStatus","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Must be one of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"not_commented","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"drafted","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Filters feedbacks as to whether they have been commented, not commented or have had a comment drafted.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"language","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"To show the feedbacks submitted for the selected language. Values can be one of these ","type":"text"},{"text":"language codes","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/ISO_639-1"}}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"de, en, es, fr, nl, cs, da, hu, it, pl, pt, ru, sr, sv, ar, zh, ja, fi, no","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"_locale","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":" en","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Changes the language used to show the question labels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be a valid ISO 3166-1 alpha-2 language code. For example: 'en' for English, 'fr' for French.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"$ curl --header \"X-CA-AUTH: \" https://api.customer-alliance.com/feedback/v2/stream.json?questionnaireIds=699083","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"pagination\": {\n \"current_page\": 1,\n \"total_pages\": 1,\n \"total_items\": 1\n },\n \"items\": [\n {\n \"id\": 52749453,\n \"language\": \"en\",\n \"created_date\": \"2021-02-18 12:25:52\",\n \"author\": {\n \"name\": \"John\",\n \"email\": \"john@email.com\",\n \"age\": null\n },\n \"meta\": {\n \"traveller_type\": null,\n \"room_number\": null,\n \"arrival_date\": \"2021-02-01\",\n \"departure_date\": \"2021-02-28\"\n },\n \"questionnaire\": {\n \"id\": 699083,\n \"name\": \"Breakfast Survey\"\n },\n \"question_answers\": [\n {\n \"question\": {\n \"id\": 11918603,\n \"type\": \"rating\",\n \"label\": \"Service\"\n },\n \"answer\": {\n \"rating\": 5,\n \"text\": null\n },\n \"sub_question_answers\": []\n },\n {\n \"question\": {\n \"id\": 11918613,\n \"type\": \"rating\",\n \"label\": \"Buffet / Menu selection\"\n },\n \"answer\": {\n \"rating\": 4,\n \"text\": null\n },\n \"sub_question_answers\": []\n },\n {\n \"question\": {\n \"id\": 11918623,\n \"type\": \"rating\",\n \"label\": \"Quality of food\"\n },\n \"answer\": {\n \"rating\": 5,\n \"text\": null\n },\n \"sub_question_answers\": []\n },\n {\n \"question\": {\n \"id\": 11918633,\n \"type\": \"rating\",\n \"label\": \"Selection of beverages\"\n },\n \"answer\": {\n \"rating\": 3,\n \"text\": null\n },\n \"sub_question_answers\": []\n },\n {\n \"question\": {\n \"id\": 11918643,\n \"type\": \"text\",\n \"label\": \"How would you describe your overall experience?\"\n },\n \"answer\": {\n \"text\": \"All in all it was almost perfect, except there were no apple juice.\"\n },\n \"sub_question_answers\": []\n },\n {\n \"question\": {\n \"id\": 11918653,\n \"type\": \"choice\",\n \"label\": \"Are you a guest of the hotel?\"\n },\n \"answer\": {\n \"choices\": [\n {\n \"label\": \"Yes\"\n }\n ]\n },\n \"sub_question_answers\": [\n {\n \"question\": {\n \"id\": 11918663,\n \"type\": \"text\",\n \"label\": \"Your room number\"\n },\n \"answer\": {\n \"text\": \"119\"\n },\n \"sub_question_answers\": []\n }\n ]\n },\n {\n \"question\": {\n \"id\": 11918673,\n \"type\": \"text\",\n \"label\": \"Your email address\"\n },\n \"answer\": {\n \"text\": \"john@email.com\"\n },\n \"sub_question_answers\": []\n }\n ],\n \"comment\": null,\n \"rating_scale\": {\n \"min\": 1,\n \"max\": 5\n }\n }\n ]\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Monitoring","type":"text"}]},{"type":"expand","attrs":{"title":"POST /account/{googlePlaceId}"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"POST","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]},{"text":" ","type":"text"},{"text":"/account/{googlePlaceId}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]}]},{"type":"paragraph","content":[{"text":"This API is to be used by a partner to create a monitoring account for one of its customers. A monitoring account is a Customer Alliance account created for the purpose of monitoring a customer's online reviews on the public review portals.","type":"text"}]},{"type":"paragraph","content":[{"text":"When a monitoring account is created via this API the partner can retrieve an API Key to get access to the customer data of the created monitoring account. Access to the customer data is granted via one of our APIs (JSON or iFrame APIs).","type":"text"}]},{"type":"paragraph","content":[{"text":"There is a limit on creating monitoring accounts using this API: 50 per day per partner. Reaching the mentioned limit returns a 429 HTTP error in the API request.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"055072e4-f523-4600-bc7b-88150950534e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Default value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"{googlePlaceId}","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":" no value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[399.0]},"content":[{"type":"paragraph","content":[{"text":"Google place id.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the link to the Google Places API documentation, where Google Places ID can be retrieved: ","type":"text"},{"text":"https://developers.google.com/maps/documentation/javascript/examples/places-placeid-finder","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/maps/documentation/javascript/examples/places-placeid-finder"}}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl --location --request POST 'https://api.customer-alliance.com/account/{googlePlaceId}' \\\n--header 'X-CA-AUTH: ' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is the JSON structure you can expect from the POST endpoint: ","type":"text"},{"type":"hardBreak"},{"text":"https://api.customer-alliance.com/account/{googlePlaceId}","type":"text","marks":[{"type":"link","attrs":{"href":"https://api.customer-alliance.com/account/{googlePlaceId}"}}]},{"type":"hardBreak"},{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"{\n 'result': 'ok',\n 'account': {\n 'id': 1,\n 'name': 'TEST HOTEL BERLIN',\n 'address': '118 Ullsteinstr, 10719 Berlin, DE',\n 'website': 'http://www.test-hotel.de/',\n 'type': 'Hotel',\n 'api_key': '9891229a2ef309a123456de0e846ce8c30f8'\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Guests","type":"text"}]},{"type":"expand","attrs":{"title":"POST /api/{AccessKey}/{ReviewSubject}"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"POST /api/{AccessKey}/{ReviewSubject}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"With this API you can seamlessly add guest/customer data to the Customer Alliance product back-end. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"To access the API, you will need: ","type":"text"},{"text":"AccessKey ","type":"text","marks":[{"type":"strong"}]},{"text":"and","type":"text"},{"text":" ReviewSubject ","type":"text","marks":[{"type":"strong"}]},{"text":"(hash value of the Review Config) - both should be requested from Customer Support team.","type":"text"},{"type":"hardBreak"},{"text":"URL endpoint is: ","type":"text"},{"text":"https://interfaces.customer-alliance.com/api/{AccessKey}/{ReviewSubject","type":"text","marks":[{"type":"link","attrs":{"href":"https://interfaces.customer-alliance.com/api/Access_Key/Hotel_ID"}}]},{"text":"}","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Our service requires SSL transport encryption. We only support TLS 1.2+. ","type":"text"},{"text":"TLS 1.0, 1.1 and SSL v2, v3 are no longer supported due to massive security vulnerabilities. ","type":"text","marks":[{"type":"underline"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"For testing purposes, you can request test access credentials that are connected to a test hotel. The added guests are NOT treated as real guests, and therefore will NOT be sent emails requesting a review.","type":"text"}]},{"type":"paragraph","content":[{"text":"Other than that the API behaves and responds normally. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Specification for POST","type":"text"}]},{"type":"paragraph","content":[{"text":"The guest data can be sent to our server using a POST request with JSON data within the request body. The following content type should be set on the request: ","type":"text"}]},{"type":"paragraph","content":[{"text":"'Content-Type: application/json; charset=utf-8'","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Expected structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The request body has to match the following structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"[\n {\n \"id\": \"1\",\n \"reservation_id\": \"0123ABC\",\n \"name\": \"Mustermann\",\n \"gender\": \"m\",\n \"email\": \"max@mustermann.de\",\n \"language\": \"de\",\n \"arrival_date\": \"2021-07-01\",\n \"departure_date\": \"2021-07-08\",\n \"phone_number\": \"+4915777777777\"\n },\n {\n \"id\": \"2\",\n \"name\": \"M\\u00fcller\",\n \"gender\": \"f\",\n \"email\": \"lieschen@mueller.de\",\n \"language\": \"de\",\n \"departure_date\": \"2021-07-08\"\n },\n {\n \"id\": \"3\",\n \"reservation_id\": \"0123ABCEF\",\n \"name\": \"Mustermann\",\n \"gender\": \"m\",\n \"email\": \"otto@mustermann.de\",\n \"language\": \"de\",\n \"departure_date\": \"2021-07-08\",\n \"cancelled\": true\n }\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"The request body consists of a JSON array that can contain multiple guests and so it is possible to send multiple guests within one request. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Our servers expect any unicode non-ASCII characters in the json payload to be escaped.","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"So for example the name \"Müller\" has to be provided as \"M\\u00fcller\"","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"limit","type":"text","marks":[{"type":"strong"}]},{"text":" for the number of guests inside one request is ","type":"text"},{"text":"1000","type":"text","marks":[{"type":"strong"}]},{"text":". A 400 “Bad Request” error might be returned if this limit is exceeded.","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The API is subject to rate-limiting and allows ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"10 requests per second","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"60 requests per minute","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"250 requests per hour","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attributes","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"092421d9-3be0-44bc-a436-d729b77d36ea"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Required","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Unique ID of the guest in context of the current request. This could be the same as the reservation ID.","type":"text"}]},{"type":"paragraph","content":[{"text":"This ID is used to distinguish the guests in the event of an error during transfer. More about this within the \"Errors\" table below.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Also, it is stored with relation to the review and is displayed in the external review API ","type":"text"},{"text":"CA & Ext. Review Data (JSON), API Documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://customer-alliance.atlassian.netnull/pages/createpage.action?spaceKey=CAA&title=CA%20%26%20External%20Review%20Data%20%28JSON%29%2C%20API%20Documentation&linkCreation=true&fromPageId=1996455957"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"last name","type":"text","marks":[{"type":"strong"}]},{"text":" of the guest","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"email","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Email address to which the invitation is to be sent.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"gender","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Gender is required for the guest salutation","type":"text"}]},{"type":"paragraph","content":[{"text":"Valid values are: m (male), f (female), fam (family). na (unknown/neutral)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"language","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Language of the guest in ISO 639-1 format","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported values are: ","type":"text"}]},{"type":"paragraph","content":[{"text":"ar, bg, bs, cs, da, de, el, en, es, fi, fr, hr, hu, it, ja, mk, mo, nl, no, pl, pt, ro, ru, sk, sl, sq, sr, sv, tr, zh","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"arrival_date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Arrival date of the guest, must be provided in YYYY-MM-DD format.","type":"text"}]},{"type":"paragraph","content":[{"text":"The arrival date of the guest can be given optionally.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"departure_date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Departure date of the guest","type":"text"}]},{"type":"paragraph","content":[{"text":"Must be provided in YYYY-MM-DD format","type":"text"}]},{"type":"paragraph","content":[{"text":"At most 180 days in the past or future, no more","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"phone_number","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"The phone number of the guest can be given optionally. The phone number has to follow the E.164 recommendation. ","type":"text"},{"text":"https://en.wikipedia.org/wiki/E.164","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/E.164"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"cancelled","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Guest cancellation status as boolean field. If a true value is given, then the guest is marked as cancelled and any further communication with the guest is stopped.","type":"text"}]},{"type":"paragraph","content":[{"text":"It's recommended to update the guest cancellation status at least once a day to ensure a fluid guest communication flow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"reservation_id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Unique ID of the reservation/booking by the guest in a given hotel. This field is mandatory if the arrival_date given is in the future.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"guest_profile_id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Unique ID of the guest within a given hotel. This usually corresponds to the guest profile ID within a given hotel. This field can be a string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"room_number","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"The room number where the guest stayed. This field can be a string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"room_category","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"The category of the room where the guest stayed, e.g. suite, single, double-room. This field can be a string.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Server Responses","type":"text"}]},{"type":"paragraph","content":[{"text":"The result of the request is shown in the response of our server. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Status codes for responses","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"bad0c4c7-de39-45ad-98d6-7b471c7b5e35"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Status Code","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"200 OK","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Request has been accepted successfully. Body of the response gives further information","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"403 Forbidden","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Not authenticated, combination of Review Subject and Access Key invalid [no guests imported]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Invalid format of the request (e.g. missing parameter or invalid JSON) [no guests imported]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"503 Service Unavailable","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Most likely we are doing maintenance work (updates, etc.) and the system will be back up in a couple of minutes [no guests imported]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"Other (404, 500...)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[459.0]},"content":[{"type":"paragraph","content":[{"text":"Other error [no guest imported]","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In the case of ","type":"text"},{"text":"status code 200","type":"text","marks":[{"type":"code"}]},{"text":", there is further JSON encoded data in the body of the response:","type":"text"}]},{"type":"paragraph","content":[{"text":"All guests successfully added:","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"{ “success“ : true }","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In case of ","type":"text"},{"text":"error","type":"text","marks":[{"type":"strong"}]},{"text":", there is a list of errors for the individual guests.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"In case of error, we use the ","type":"text"},{"text":"guest ID","type":"text","marks":[{"type":"strong"}]},{"text":" given in the request to identify the guests with errors. ","type":"text"},{"type":"hardBreak"},{"text":"All guests that do not appear in the error list have been added successfully. ","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Expected JSON response for error","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"success\": false,\n \"errors\": [\n {\n \"guest_id\": \"0\",\n \"error_details\": [\n {\n \"error_code\": \"0\",\n \"error_message\": \"...\"\n }\n ]\n }\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Potential Errors","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"72f6c7cc-1f88-4d0b-9384-a39fe34b856e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Attribute","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"error_code","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"error_message","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Further information","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"departure date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for date","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"email","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"3","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for email","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"gender","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for gender","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"language","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for language","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"phone_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"6","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for phone number","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"reservation_id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"7","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Validation failed for reservation id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"The \"reservation_id\" field is mandatory if the \"arrival_date\" of a guest is in the future.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"other error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Unexpected error inserting guest to database","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Shell","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"$ curl --location --request POST 'https://interfaces.customer-alliance.com/api/{ApiKey}/{ReviewSubject}' \\\n--header 'charset: utf-8' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n {\n \"id\": \"1\",\n \"reservation_id\": \"0123A3B4C5679\",\n \"name\": \"M\\u00fcller\",\n \"gender\": \"f\",\n \"email\": \"lieschen@mueller.de\",\n \"language\": \"de\",\n \"arrival_date\": \"2021-07-01\",\n \"departure_date\": \"2021-07-02\",\n \"phone_number\": \"+491578777769978\",\n \"billing_address\": \"adress billing\",\n \"revenue_logis\": \"2000\",\n \"age\": \"33\",\n \"room_number\":\"24\",\n \"room_category\": \"premium\"\n }\n]'","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"success\": true,\n \"added_guest_count\": 1,\n \"cancelled_guest_count\": 0,\n \"blacklisted_guest_count\": 0,\n \"already_invited_guest_count\": 0\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"paragraph"}],"version":1}