---
title: "Get merchant reservation settings"
method: GET
path: "/v1/merchants/{merchantId}/reservation-settings"
tags: ["reservation-settings"]
---

# Get merchant reservation settings

`GET /v1/merchants/{merchantId}/reservation-settings`

## Request

- Base URL: `https://public-api.prod.quandoo.com`
- URL: `https://public-api.prod.quandoo.com/v1/merchants/{merchantId}/reservation-settings`
- Auth: API key in header `X-Quandoo-AuthToken`
- TypeScript: <https://skmtc.dev/quandoo/apis/quandooapidocumentation/docs/v1/merchants/:merchantId/reservation-settings/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint provides all data that is required to initiate the reservation flow and is not part of the search endpoint.

Example curl:
```
curl https://{host}/v{X}/merchants/15/reservation-settings
```

Example response: 
```
{
  "areaIds": [
    {
      "id": 2,
      "name": "Garden",
      "priority": 10
    }
  ],
  "areaSelectionRequired": true,
  "capacities": [
    1,
    2,
    3,
    4,
    5,
    6
  ],
  "links": [
    {
      "href": "https://{host}/v{X}/merchants/15",
      "method": "GET",
      "rel": "parent"
    },
    {
      "href": "https://{host}/v{X}/merchants/15/availabilities",
      "method": "GET",
      "rel": "availability_days"
    },
    {
      "href": "https://{host}/v{X}/merchants/15/availabilities/2017-01-01/times",
      "method": "GET",
      "rel": "availability"
    }
  ],
  "merchantNewsletterSelectionRequired": true,
  "minimumCapacityForEnquiries": 10,
  "onlineReservationInterval": 60,
  "reservationEnquiryEnabled": true,
  "specialTerms": "This is any custom string for special terms",
  "automaticConfirmation": true,
  "ccvEnabled": true
}
```

## Path parameters

- `merchantId` integer, required

## Response `200`

Reservation settings response

- MerchantReservationSettingsDto
  - `areaIds` AreaDto[]: List of all the areas defined for the merchant. Each area will contain:
    - `id` integer: Id of the area
    - `name` string: Name of the area
    - `priority` integer: Priority set for this area
  - `capacities` integer[]: Number of guests allowed in a reservation
  - `merchantNewsletterSelectionRequired` boolean: If true, a separate checkbox is displayed in the checkout for newsletter received from the restaurant
  - `areaSelectionRequired` boolean: If true, we display available areas in a dropdown when a guest is making an online reservation
  - `reservationEnquiryEnabled` boolean: If true, the restaurants allows enquiries
  - `minimumCapacityForEnquiries` integer: Minimum number of guests for an enquiry
  - `onlineReservationInterval` integer: Time slots displayed for making a reservation
  - `specialTerms` string: If true, special terms and conditions of the restaurant need to be confirmed upon making an online reservation
  - `links` LinkRelationDto[]: Related links that can be followed based on this response
    - `href` string, url
    - `method` string
    - `rel` 'DETAILS' | 'WIDGET' | 'WIDGET_DETAILS' | 'GET_MERCHANT' | 'PARENT' | 'SELF' | 'SETTINGS' | 'AVAILABILITY_DAYS' | 'AVAILABILITIES' | 'CREATE_RESERVATION' | 'GET_RESERVATION' | 'UPDATE_RESERVATION' | 'GET_CUSTOMER_RESERVATION' | 'GET_REVIEW' | 'PORTAL_PREORDER_FORM' | 'RESERVATION_CHECKOUT_PAGE' | 'CREDIT_CARD_DETAILS_PAGE' | 'CUSTOMER_EDIT_RESERVATION'
  - `automaticConfirmation` boolean: If true, the customer will receive an automatic email confirmation after he makes a reservation
  - `ccvEnabled` boolean: If true, credit card information is required when creating a reservation

## Other responses

- `400`: Bad request
- `404`: Merchant not found error
- `500`: Internal server error

---

[API](https://skmtc.dev/quandoo/apis/quandooapidocumentation.md) - [All operations](https://skmtc.dev/quandoo/apis/quandooapidocumentation/llms.txt) - [OpenAPI document](https://skmtc.dev/quandoo/apis/quandooapidocumentation/revisions/b33054d03af3?raw)