{
"info": {
"_postman_id": "a0faca37-32ae-40e1-8f90-eceb72267300",
"name": "Quandoo Public Partner Availabilities Merchants API",
"description": "The Quandoo Public Partner API is a multi-purpose REST API for the Quandoo restaurant reservations platform. It lets partners check merchant availability, search merchants, read merchant reservation and enquiry settings, create and manage reservations and reservation enquiries, manage customers and reviews, handle preorders and reservation tags, and validate phone numbers. Reservation and enquiry creation is idempotent via an agent-specific unique identifier. Derived from the official Quandoo Swagger specification at https://api.quandoo.com/swagger.json.\n\nContact Support:\n Name: Quandoo Developers\n Email: developers@quandoo.com",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"createdAt": "2026-07-28T02:42:32.000Z",
"updatedAt": "2026-07-28T02:42:32.000Z",
"lastUpdatedBy": "35240",
"uid": "35240-a0faca37-32ae-40e1-8f90-eceb72267300"
},
"item": [
{
"name": "v1",
"item": [
{
"name": "merchants",
"item": [
{
"name": "{merchantId}",
"item": [
{
"name": "similar",
"item": [
{
"name": "Quandoo Allows to Get a Merchant by Id and Find Similar Merchants",
"id": "c0831906-d02f-49a9-93e7-e81f354f71df",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"description": "Locale.
Format:
<language code>[_<country code>]",
"key": "Accept-Language",
"value": "en_GB"
},
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/similar?sort=CLOSEST&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"similar"
],
"query": [
{
"description": "Sort order. Default sorting will be by proximity.",
"key": "sort",
"value": "CLOSEST"
},
{
"description": "Max number of merchant recommendations to return.",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"id": "d33cff9d-5ad3-4156-9db2-10e67a2c2ffb",
"key": "merchantId",
"value": "",
"description": "(Required) merchantId"
}
]
},
"description": "This endpoint allows to receive detailed information for a particular merchant in the system and for restaurants that are similar to this one.\nA merchant is similar if all the following conditions are met:\n1. Location: the recommended merchants are within 30 km radius from the main merchant\n2. The similar merchants are bookable online\n3. The similar merchants have the main cuisine in common\n\nThis merchant should be specified by their identifier **merchantId**, which is mandatory.\nThe endpoint can take optional request header **Accept-Language**.\nThis header is used to determine correct locale and has an effect on translation of merchant's entity fields, that may be omitted.\n\nThe expected value of the header **Accept-Language** should contain language and can contain country, e.g. \"de_DE\" or \"de\". Locale by default is \"en_GB\".\n\nThe endpoint returns status `HTTP 200` if the request is successful. In a successful requests the specified merchant was found.\n\nIf the merchant has no products allowed for a web search, i.e. is not bookable, response data with `HTTP 200` is returned, but the field `merchant` is not set. Instead, the merchant search message is set.\n\nThe endpoint will return status `HTTP 404` if the merchant, specified by identifier, was not found.\n\nExample curl:\n```\ncurl -H 'X-Quandoo-AuthToken: {INSERT_KEY_HERE}' -H 'Accept-Language: de_DE' 'https://{host}/v{X}/merchants/11/similar'\n```\n\nExample responses:\n`merchant bookable`\n```\n{\n \"merchant\": {\n \"id\":11,\n \"name\":\"Test merchant\",\n \"phoneNumber\":\"+27113901837\",\n \"currency\":\"ZAR\",\n \"locale\":\"en_ZA\",\n \"timezone\":\"Africa/Johannesburg\",\n \"location\":{\n \"coordinates\":{\n \"latitude\":33.9,\n \"longitude\":18.4\n },\n \"address\":{\n \"street\":\"Tamerlan street\",\n \"number\":\"6A\",\n \"zipcode\":\"10787\",\n \"city\":\"Cape Town\",\n \"country\":\"ZAF\"\n }\n },\n \"reviewScore\": \"5.3\",\n \"tagGroups\":[\n {\n \"type\":\"CUISINE\",\n \"tags\":[\n {\n \"id\":25,\n \"name\":\"Testk\u00fcche Hauptkategorie\"\n },\n {\n \"id\":28,\n \"name\":\"Test cuisine\"\n }\n ]\n }\n ],\n \"images\":[\n {\n \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"\n }\n ],\n \"documents\":[],\n \"links\":[\n {\n \"href\":\"https://{host}/{path}?aid=16\",\n \"method\":\"GET\",\n \"rel\":\"DETAILS\"\n },\n {\n \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET\"\n },\n {\n \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET_DETAILS\"\n }\n ],\n \"bookable\": true,\n \"openingTimes\": {\n \"standardOpeningTimes\": {\n \"SATURDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"20:00:00\"\n }\n ],\n \"SUNDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"18:00:00\"\n }\n ]\n }\n },\n \"ccvEnabled\": true,\n \"chain\": {\n \"id\": 1,\n \"name\": \"Test chain\"\n }\n },\n \"recommendedMerchants\": {\n \"merchants\": [\n {\n \"id\":12,\n \"name\":\"similar merchant\",\n \"phoneNumber\":\"+27113901838\",\n \"currency\":\"ZAR\",\n \"locale\":\"en_ZA\",\n \"timezone\":\"Africa/Johannesburg\",\n \"location\":{\n \"coordinates\":{\n \"latitude\":33.8,\n \"longitude\":18.4\n },\n \"address\":{\n \"street\":\"Tamerlan street\",\n \"number\":\"5A\",\n \"zipcode\":\"10787\",\n \"city\":\"Cape Town\",\n \"country\":\"ZAF\"\n }\n },\n \"reviewScore\": \"5.3\",\n \"tagGroups\":[\n {\n \"type\":\"CUISINE\",\n \"tags\":[\n {\n \"id\":25,\n \"name\":\"Testk\u00fcche Hauptkategorie\"\n },\n {\n \"id\":28,\n \"name\":\"Test cuisine\"\n }\n ]\n }\n ],\n \"images\":[\n {\n \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"\n }\n ],\n \"documents\":[],\n \"links\":[\n {\n \"href\":\"https://{host}/{path}?aid=16\",\n \"method\":\"GET\",\n \"rel\":\"DETAILS\"\n },\n {\n \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET\"\n },\n {\n \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET_DETAILS\"\n }\n ],\n \"bookable\": true,\n \"openingTimes\": {\n \"standardOpeningTimes\": {\n \"SATURDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"20:00:00\"\n }\n ],\n \"SUNDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"18:00:00\"\n }\n ]\n }\n },\n \"ccvEnabled\": true,\n \"chain\": {\n \"id\": 1,\n \"name\": \"Test chain\"\n }\n }\n ],\n \"size\": 1,\n \"offset\": 0,\n \"limit\": 10\n }\n}\n```\n\n`merchant not bookable`\n```\n{\n \"merchantSearchMessage\": \"MERCHANT_NOT_BOOKABLE\",\n \"recommendedMerchants\": {\n \"limit\": 10,\n \"merchants\": [...],\n \"offset\": 0,\n \"size\": 0\n }\n}\n```"
},
"response": [
{
"id": "0086ca8f-2b34-48ed-a117-a436ec9f300b",
"name": "OK",
"originalRequest": {
"method": "GET",
"header": [
{
"description": "Locale.
Format:
<language code>[_<country code>]",
"key": "Accept-Language",
"value": "en_GB"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/similar?sort=CLOSEST&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"similar"
],
"query": [
{
"description": "Sort order. Default sorting will be by proximity.",
"key": "sort",
"value": "CLOSEST"
},
{
"description": "Max number of merchant recommendations to return.",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"merchant\": {\n \"bookable\": \"\",\n \"ccvEnabled\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"GET_RESERVATION\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"AVAILABILITIES\"\n }\n ],\n \"location\": {\n \"coordinates\": {\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"number\": \"\",\n \"zipcode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"district\": \"\"\n }\n },\n \"name\": \"\",\n \"openingTimes\": {\n \"standardOpeningTimes\": {}\n },\n \"phoneNumber\": \"\",\n \"reviewScore\": \"\",\n \"timezone\": \"\",\n \"currency\": \"\",\n \"locale\": \"\",\n \"tagGroups\": [\n {\n \"type\": \"ESTABLISHMENT_TYPE\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n },\n {\n \"type\": \"EXTRAS\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n }\n ],\n \"images\": [\n {\n \"url\": \"\"\n },\n {\n \"url\": \"\"\n }\n ],\n \"documents\": [\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n },\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n }\n ],\n \"chain\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"ivrRedirectNumber\": \"\",\n \"shortDescription\": \"\",\n \"longDescription\": \"\"\n },\n \"merchantSearchMessage\": \"MERCHANT_NOT_BOOKABLE\",\n \"recommendedMerchants\": {\n \"merchants\": [\n {\n \"bookable\": \"\",\n \"ccvEnabled\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"GET_REVIEW\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"SETTINGS\"\n }\n ],\n \"location\": {\n \"coordinates\": {\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"number\": \"\",\n \"zipcode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"district\": \"\"\n }\n },\n \"name\": \"\",\n \"openingTimes\": {\n \"standardOpeningTimes\": {}\n },\n \"phoneNumber\": \"\",\n \"reviewScore\": \"\",\n \"timezone\": \"\",\n \"currency\": \"\",\n \"locale\": \"\",\n \"tagGroups\": [\n {\n \"type\": \"ESTABLISHMENT_TYPE\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n },\n {\n \"type\": \"ACCESSIBILITY\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n }\n ],\n \"images\": [\n {\n \"url\": \"\"\n },\n {\n \"url\": \"\"\n }\n ],\n \"documents\": [\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n },\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n }\n ],\n \"chain\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"ivrRedirectNumber\": \"\",\n \"shortDescription\": \"\",\n \"longDescription\": \"\"\n },\n {\n \"bookable\": \"\",\n \"ccvEnabled\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"WIDGET_DETAILS\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"CREDIT_CARD_DETAILS_PAGE\"\n }\n ],\n \"location\": {\n \"coordinates\": {\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"number\": \"\",\n \"zipcode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"district\": \"\"\n }\n },\n \"name\": \"\",\n \"openingTimes\": {\n \"standardOpeningTimes\": {}\n },\n \"phoneNumber\": \"\",\n \"reviewScore\": \"\",\n \"timezone\": \"\",\n \"currency\": \"\",\n \"locale\": \"\",\n \"tagGroups\": [\n {\n \"type\": \"INTERNET\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n },\n {\n \"type\": \"MEAL_TYPE\",\n \"tags\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n }\n ],\n \"images\": [\n {\n \"url\": \"\"\n },\n {\n \"url\": \"\"\n }\n ],\n \"documents\": [\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n },\n {\n \"name\": \"\",\n \"url\": \"\",\n \"format\": \"\",\n \"description\": \"\"\n }\n ],\n \"chain\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"ivrRedirectNumber\": \"\",\n \"shortDescription\": \"\",\n \"longDescription\": \"\"\n }\n ],\n \"size\": \"\",\n \"offset\": \"\",\n \"limit\": \"\"\n }\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-0086ca8f-2b34-48ed-a117-a436ec9f300b"
},
{
"id": "c45cd689-02fa-4cd0-9618-e09a82b5a320",
"name": "Merchant not found error",
"originalRequest": {
"method": "GET",
"header": [
{
"description": "Locale.
Format:
<language code>[_<country code>]",
"key": "Accept-Language",
"value": "en_GB"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/similar?sort=CLOSEST&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"similar"
],
"query": [
{
"description": "Sort order. Default sorting will be by proximity.",
"key": "sort",
"value": "CLOSEST"
},
{
"description": "Max number of merchant recommendations to return.",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Not Found",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-c45cd689-02fa-4cd0-9618-e09a82b5a320"
}
],
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-c0831906-d02f-49a9-93e7-e81f354f71df"
}
],
"id": "8252dbd4-d080-41c4-9e14-1541ab6ac071",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-8252dbd4-d080-41c4-9e14-1541ab6ac071"
},
{
"name": "reservations",
"item": [
{
"name": "Quandoo Get Merchant Reservations",
"id": "f5851fd0-b3fe-4a7e-a4ee-614991e71409",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"id": "315cd73a-de11-4f68-8f85-0a89262f73f4",
"key": "merchantId",
"value": "",
"description": "(Required) Id of the merchant"
}
]
},
"description": "This endpoint allows an agent to get reservations of a merchant. The results will be filtered by agent id. \nReservation IDs in response are agent-specific. The agent needs to be authenticated.\n\nThe endpoint will return `HTTP 404 - Not Found` if the merchant with the specified id could not be found.\nIt will return `HTTP 403 - Forbidden` if the agent is not authenticated or the agent doesn't have permissions.\n\n####Request:\n* **merchantId**: ID of the merchant\n* **offset**: sets the starting element to be returned. Defaults to 0 when unset or malformed.\n* **limit**: maximum number of results to be returned. Value must be between 1 and 100. Defaults to 100 when unset, malformed or outside bounds.\n* **earliest**: earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss\n* **latest**: latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss\n\n\n####Response:\nThe response will be a _list_ of reservations. Each reservation has the fields explained below:\n* **id**: The public id of the reservation\n* **number**: Quandoo internal identifier of the reservation.\n* **quandooId**: The public id of this reservation on quandoo system.\n* **status**: The status of the reservation eg. CREATED, CONFIRMED, CUSTOMER CANCELED etc.\n* **startTime**: The start time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ`\n* **endTime**: The end time of the reservation. Format: `yyyy-MM-ddTHH:mm:ssZ`\n* **capacity**: The capacity (people count) of the reservation\n* **merchantId**: The ID of the merchant at which this reservation was made.\n* **customerId**: The public ID of the customer to which this reservation belongs\n* **promoCode**: The promotion code associated with this reservation. Optional.\n* **extraInfo**: extra information that the customer provided for the reservation. Optional.\n* **links**: Related links that can be followed based on this response.\n* **createdAt**: The date the reservation was created. Format: `yyyy-MM-ddTHH:mm:ssZ`\n* **updatedAt**: The date the reservation was last updated. Format: `yyyy-MM-ddTHH:mm:ssZ`\n\nExample curl:\n```\ncurl https://{host}/v{X}/merchants/32489/reservations\n```\n\nExample response: \n```\n{\n \"reservations\": [\n {\n \"id\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",\n \"number\": 8734957,\n \"quandooId\": \"07f53b36-3f48-11e5-a151-feff819cdc9f\",\n \"status\": \"CREATED\",\n \"startTime\": \"2015-06-22T12:00:00+00:00\",\n \"endTime\": \"2015-06-22T13:00:00+00:00\",\n \"capacity\": 4,\n \"merchantId\": 1384,\n \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",\n \"promocode\": \"SOME_CAMPAIGN_CODE\",\n \"extraInfo\": \"request for baby chair\",\n \"links\": [\n {\n \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",\n \"method\": \"GET\",\n \"rel\": \"self\"\n },\n {\n \"href\": \"https://{host}/v{X}/reservations/07f53b36-3f48-11e5-a151-feff819cdc9f\",\n \"method\": \"PATCH\",\n \"rel\": \"update\"\n }\n ],\n \"createdAt\": \"2015-06-01T15:21:54Z\",\n \"updatedAt\": \"2015-06-01T18:45:30Z\"\n },\n {\n \"id\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",\n \"number\": 8734958,\n \"quandooId\": \"d8f53b36-3f48-11e5-a151-feff819cdc7a\",\n \"status\": \"CONFIRMED\",\n \"startTime\": \"2015-06-22T12:00:00+00:00\",\n \"endTime\": \"2015-06-22T13:00:00+00:00\",\n \"capacity\": 3,\n \"merchantId\": 1384,\n \"customerId\": \"ce0706ff-a95d-4229-a220-d21dcd175342\",\n \"promocode\": \"SOME_CAMPAIGN_CODE\",\n \"links\": [\n {\n \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",\n \"method\": \"GET\",\n \"rel\": \"self\"\n },\n {\n \"href\": \"https://{host}/v{X}/reservations/d8f53b36-3f48-11e5-a151-feff819cdc7a\",\n \"method\": \"PATCH\",\n \"rel\": \"update\"\n }\n ],\n \"createdAt\": \"2015-06-01T15:21:54Z\",\n \"updatedAt\": \"2015-06-01T18:45:30Z\"\n }\n ],\n offset:0,\n limit:100\n}\n```\n"
},
"response": [
{
"id": "3d584969-4774-4738-a057-3da1b4ffa9a5",
"name": "OK",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"reservations\": [\n {\n \"capacity\": \"\",\n \"customerId\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"CUSTOMER_EDIT_RESERVATION\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"PARENT\"\n }\n ],\n \"merchantId\": \"\",\n \"quandooId\": \"\",\n \"status\": \"\",\n \"number\": \"\",\n \"reservationNumber\": \"\",\n \"updatedAt\": \"\",\n \"promocode\": \"\",\n \"extraInfo\": \"\",\n \"reservationTags\": [\n \"\",\n \"\"\n ]\n },\n {\n \"capacity\": \"\",\n \"customerId\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"CUSTOMER_EDIT_RESERVATION\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"WIDGET_DETAILS\"\n }\n ],\n \"merchantId\": \"\",\n \"quandooId\": \"\",\n \"status\": \"\",\n \"number\": \"\",\n \"reservationNumber\": \"\",\n \"updatedAt\": \"\",\n \"promocode\": \"\",\n \"extraInfo\": \"\",\n \"reservationTags\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"offset\": \"\",\n \"limit\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-3d584969-4774-4738-a057-3da1b4ffa9a5"
},
{
"id": "a5cce5fd-9fb9-4189-ab01-79a53de2d973",
"name": "Bad request",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-a5cce5fd-9fb9-4189-ab01-79a53de2d973"
},
{
"id": "a6ba5bcf-5c11-4656-ba5b-7789fab673fc",
"name": "Access denied",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-a6ba5bcf-5c11-4656-ba5b-7789fab673fc"
},
{
"id": "4b694bd8-dd4c-4d2c-b8ad-58fdbbf5c314",
"name": "Merchant not found error",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Not Found",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-4b694bd8-dd4c-4d2c-b8ad-58fdbbf5c314"
},
{
"id": "cc9129ff-7234-4ff8-af8c-b749606533a6",
"name": "Internal server error",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reservations?offset=0&limit=100&earliest=&latest=",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reservations"
],
"query": [
{
"description": "Skip first n reservations",
"key": "offset",
"value": "0"
},
{
"description": "limit",
"key": "limit",
"value": "100"
},
{
"description": "earliest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "earliest",
"value": ""
},
{
"description": "latest date time of time window in UTC. Format: yyyy-MM-dd HH:mm:ss",
"key": "latest",
"value": ""
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Internal Server Error",
"code": 500,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-cc9129ff-7234-4ff8-af8c-b749606533a6"
}
],
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-f5851fd0-b3fe-4a7e-a4ee-614991e71409"
}
],
"id": "66b59aa3-ca60-46a4-bbd7-95145331731d",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-66b59aa3-ca60-46a4-bbd7-95145331731d"
},
{
"name": "reviews",
"item": [
{
"name": "Quandoo Retrieves Customer Reviews for a Merchant, Specified by ReviewId",
"id": "06d90a4c-106a-4973-a56c-338665734289",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reviews?offset=0&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reviews"
],
"query": [
{
"description": "Skip first n reviews",
"key": "offset",
"value": "0"
},
{
"description": "Max number of reviews to be retrieved",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"id": "c077f00a-0376-4ec5-97de-c19eba438c27",
"key": "merchantId",
"value": "",
"description": "(Required) "
}
]
},
"description": "This endpoint retrieves customer reviews for a particular merchant with rating, description, locale, date & the customer's information.This merchant should be specified by their identifier **merchantId**, which is mandatory.\n\nSupports pagination via offset & limit parameters in the request.\n\n`offset` allows skipping the first n reviews.\n`limit` makes sure the response contains a maximum of n reviews.\n\nIf not supplied, offset will be 0 and limit will be 10\n\n####Response:\n\n* **customer**: block contains link to customer's profile image, customer's first name & first letter of customer's last name.\n* **rating**: a value between 1 and 6, where 1 represents the worst rating and 6 represents the best.\n* **description**: the review description entered by the customer.\n* **locale**: represents the language settings of the customer, in the format: _\n* **date**: represents the date of the review, with the format: yyyy-MM-dd\n\nExample curl:\n```\ncurl https://{host}/v{X}/merchants/15/reviews?offset=10&limit=5\n```\n\nExample response:\n```\n{\n reviews: [\n {\n customer: {\n firstName: \"Hans\",\n lastName: \"W\",\n profileImage: {\n url: \"https://www...\"\n },\n },\n rating: 1,\n description: \"Foo bar\", \n locale: \"de_DE\",\n date: \"2017-07-21\"\n }\n ],\n offset: 10,\n limit: 5,\n size: 1\n}\n```"
},
"response": [
{
"id": "10dae174-d0d9-489b-b956-6e0bba5dca63",
"name": "Review response",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reviews?offset=0&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reviews"
],
"query": [
{
"description": "Skip first n reviews",
"key": "offset",
"value": "0"
},
{
"description": "Max number of reviews to be retrieved",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"reviews\": [\n {\n \"customer\": {\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"profileImage\": {\n \"url\": \"\"\n }\n },\n \"date\": \"\",\n \"rating\": \"\",\n \"description\": \"\",\n \"locale\": \"\"\n },\n {\n \"customer\": {\n \"firstName\": \"\",\n \"lastName\": \"\",\n \"profileImage\": {\n \"url\": \"\"\n }\n },\n \"date\": \"\",\n \"rating\": \"\",\n \"description\": \"\",\n \"locale\": \"\"\n }\n ],\n \"size\": \"\",\n \"offset\": \"\",\n \"limit\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-10dae174-d0d9-489b-b956-6e0bba5dca63"
},
{
"id": "5a7ffa31-ebf6-499a-abda-7d69a984046c",
"name": "Bad request",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reviews?offset=0&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reviews"
],
"query": [
{
"description": "Skip first n reviews",
"key": "offset",
"value": "0"
},
{
"description": "Max number of reviews to be retrieved",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-5a7ffa31-ebf6-499a-abda-7d69a984046c"
},
{
"id": "cfa2911f-cc47-4832-9fd8-f136dbeb8bf6",
"name": "Merchant not found error",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reviews?offset=0&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reviews"
],
"query": [
{
"description": "Skip first n reviews",
"key": "offset",
"value": "0"
},
{
"description": "Max number of reviews to be retrieved",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Not Found",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-cfa2911f-cc47-4832-9fd8-f136dbeb8bf6"
},
{
"id": "b4b03aa2-e31b-422c-8b6b-caa1fab55672",
"name": "Internal server error",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId/reviews?offset=0&limit=10",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId",
"reviews"
],
"query": [
{
"description": "Skip first n reviews",
"key": "offset",
"value": "0"
},
{
"description": "Max number of reviews to be retrieved",
"key": "limit",
"value": "10"
}
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "Internal Server Error",
"code": 500,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"errorType\": \"MERCHANT_ID_INVALID\",\n \"errorMessage\": \"\"\n}",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-b4b03aa2-e31b-422c-8b6b-caa1fab55672"
}
],
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-06d90a4c-106a-4973-a56c-338665734289"
}
],
"id": "c540fb1a-6e91-4650-aa53-d0161345bf28",
"createdAt": "2026-07-28T02:42:33.000Z",
"updatedAt": "2026-07-28T02:42:33.000Z",
"uid": "35240-c540fb1a-6e91-4650-aa53-d0161345bf28"
},
{
"name": "Quandoo Allows to Get a Merchant by Id",
"id": "f60a1116-be0a-4d75-8c1a-338384659104",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"description": "Locale.
Format:
<language code>[_<country code>]",
"key": "Accept-Language",
"value": "en_GB"
},
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId"
],
"variable": [
{
"id": "3037329c-6706-48aa-802c-722d7af0a7b1",
"key": "merchantId",
"value": "",
"description": "(Required) merchantId"
}
]
},
"description": "This endpoint allows to receive detailed information on a particular merchant in the system. This merchant should be specified by their identifier **merchantId**, which is mandatory. The endpoint can take optional request header **Accept-Language**. This header is used to determine correct locale and has an effect on translation of merchant's entity fields, that may be omitted.\n\nThe expected value of the header **Accept-Language** should contain language and can contain country, e.g. \"de_DE\" or \"de\". Locale by default is \"en_GB\".\n\nThe endpoint returns status `HTTP 200` if the request is successful.\nThe endpoint will return status `HTTP 404` if the merchant, specified by identifier, was not found or has no products, allowed for a web search. \n\nExample curl:\n```\ncurl -H 'X-Quandoo-AuthToken: {INSERT_KEY_HERE}' -H 'Accept-Language: de_DE' 'https://{host}/v{X}/merchants/11'\n```\n\nExample response:\n```\n{\n \"id\":11,\n \"name\":\"Test merchant\",\n \"phoneNumber\":\"+27113901837\",\n \"currency\":\"ZAR\",\n \"locale\":\"en_ZA\",\n \"timezone\":\"Africa/Johannesburg\",\n \"location\":{\n \"coordinates\":{\n \"latitude\":33.9,\n \"longitude\":18.4\n },\n \"address\":{\n \"street\":\"Tamerlan street\",\n \"number\":\"6A\",\n \"zipcode\":\"10787\",\n \"city\":\"Cape Town\",\n \"country\":\"ZAF\"\n }\n },\n \"reviewScore\": \"5.3\",\n \"tagGroups\":[\n {\n \"type\":\"CUISINE\",\n \"tags\":[\n {\n \"id\":25,\n \"name\":\"Testk\u00fcche Hauptkategorie\"\n },\n {\n \"id\":28,\n \"name\":\"Test cuisine\"\n }\n ]\n }\n ],\n \"images\":[\n {\n \"url\":\"https://dci5ez2ey8tr9.cloudfront.net/8e4d1063-9171-40b1-94b7-5e9337591a90/7_sld.jpg\"\n }\n ],\n \"documents\":[],\n \"links\":[\n {\n \"href\":\"https://{host}/{path}?aid=16\",\n \"method\":\"GET\",\n \"rel\":\"DETAILS\"\n },\n {\n \"href\":\"https://{host}/{path}?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET\"\n },\n {\n \"href\":\"https://{host}/{path}/details?aid=16&countryId=NLD\",\n \"method\":\"GET\",\n \"rel\":\"WIDGET_DETAILS\"\n }\n ],\n \"bookable\": true,\n \"openingTimes\": {\n \"standardOpeningTimes\": {\n \"SATURDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"20:00:00\"\n }\n ],\n \"SUNDAY\": [\n {\n \"start\": \"09:00:00\",\n \"end\": \"18:00:00\"\n }\n ]\n }\n },\n \"ccvEnabled\": true,\n \"chain\": {\n \"id\": 1,\n \"name\": \"Test chain\"\n }\n}\n```"
},
"response": [
{
"id": "587b726a-78ea-4b9d-943b-96fc304d15a8",
"name": "OK",
"originalRequest": {
"method": "GET",
"header": [
{
"description": "Locale.
Format:
<language code>[_<country code>]",
"key": "Accept-Language",
"value": "en_GB"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "X-Quandoo-AuthToken",
"value": ""
}
],
"url": {
"raw": "{{baseUrl}}/v1/merchants/:merchantId",
"host": [
"{{baseUrl}}"
],
"path": [
"v1",
"merchants",
":merchantId"
],
"variable": [
{
"key": "merchantId"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"bookable\": \"\",\n \"ccvEnabled\": \"\",\n \"id\": \"\",\n \"links\": [\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"GET_REVIEW\"\n },\n {\n \"href\": \"\",\n \"method\": \"\",\n \"rel\": \"RESERVATION_CHECKOUT_PAGE\"\n }\n ],\n \"location\": {\n \"coordinates\": {\n \"latitude\": \"\",\n \"longitude\": \"\"\n },\n \"address\": {\n \"street\": \"\",\n \"number\": \"\",\n \"zipcode\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"district\": \"\"\n }\n },\n \"name\": \"