---
title: "Get merchant availability time slots"
method: GET
path: "/v1/merchants/{merchantId}/availabilities/{date}/times"
tags: ["availabilities"]
---

# Get merchant availability time slots

`GET /v1/merchants/{merchantId}/availabilities/{date}/times`

This endpoint returns availability time slots which can be reserved for a given capacity.

####Request parameters:
* **merchantId**: Id of the merchant. Path parameter.
* **date**: Specifies date of the desired reservation. Format: `yyyy-MM-dd`. Path parameter.
* **fromTime**: Beginning of the desired reservation time frame. Format: `HH:mm`. Optional.
* **toTime**: End of the desired reservation time frame. Format: `HH:mm`. Optional.
* **agentId**: Id of the agent making the request
* **capacity**: Specifies the number of people in reservation. Availabilities will be returned based on this capacity. If not provided, the default value is 2.
* **areaId**: Restricts availabilities to a certain area. Optional.
    
####Response:
The response returns availability time slots that could be reserved, along with the areas it is associated with and contains information on how much should be paid if the reservation is cancelled by a client. 

* **timeSlots**: List of available time slots.
  * **areaIds**: List of areas for which this time slot can be reserved.
  * **dateTime**: Date and time of the available slot. Format: `yyyy-MM-dd'T'HH:mm:ssZ`
  * **occupancy**: Occupancy of the available time slot. This is an integer between `0` and `100`.
  * **vaultSettingsId**: ID of the vault setting, if there is any. See: `vaultSettings`
* **vaultSettings**: Credit card vault settings representing the fees to be paid in case of cancellation.
  * **id**: ID of the setting as shown in `timeSlots`.
  * **fee**: Fee to be paid in case of cancellation. Currency is defined by merchant. See reservation-settings.
  * **feeType**: Type of fee to be paid. Can be `PER_PERSON` or `PER_RESERVATION`.
  * **feePercentageForTime**: Fee percentage depending of the time of cancellation. Format: `"{hoursStart}-{hoursEnd}": {percentage}` , where hours are the number of hours before the visit.
* **links**: Related links that can be followed based on this response.

####Example curl:
```
curl https://{host}/v{X}/merchants/15/availabilities/2017-11-09/times?capacity=2&areaId=24&agentId=3&fromTime=10:45&toTime=12:45
```


####Example response:
```
{ 
    "timeSlots": [ 
        { 
            "areaIds": [33532, 33533], 
            "dateTime": "2017-09-27T10:45:00+01:00", 
            "occupancy": 0, 
            "vaultSettingId": "284d701f-f79a-4efa-9859-fd09851dfdce"
        }, 
        ... 
    ], 
    "vaultSettings": [ 
         { 
            "id": "284d701f-f79a-4efa-9859-fd09851dfdce", 
             "fee": "10.00", 
             "feeType": "PER_PERSON", 
             "feePercentageForTime": 
                { 
                  "0-12":100, 
                  "12-24":50, 
                  "24-48":20 
                } 
         } 
     ], 
    "links": [
      {
        "href": "https://{host}/v{X}/merchants/15",
        "method": "GET",
        "rel": "parent"
      },
      {
        "href": "https://{host}/v{X}/merchants/15/reservation-settings",
        "method": "GET",
        "rel": "reservation-settings"
      },
      {
        "href": "https://{host}/v{X}/merchants/reservations",
        "method": "PUT",
        "rel": "create-reservation"
      }
    ]
} 
```

## Path parameters

- `merchantId` integer, required
- `date` string, date, required

## Query parameters

- `agentId` integer, required
- `capacity` integer, required
- `fromTime` string
- `toTime` string
- `areaId` integer

## Response `200`

Merchant availabilities response

## Other responses

- `400` — Bad request
- `404` — Agent type not found error
- `500` — Internal server error

---

[API](https://skmtc.net/quandoo/apis/quandooapidocumentation.md) · [All operations](https://skmtc.net/quandoo/apis/quandooapidocumentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quandoo/quandooapidocumentation/revisions/6863a5956792/schema)