---
title: "Retrieve availability for the given offer"
method: GET
path: "/api/v1/restaurants/{restaurant_id}/offers/{offer_id}/availability"
tags: ["Offer"]
---

# Retrieve availability for the given offer

`GET /api/v1/restaurants/{restaurant_id}/offers/{offer_id}/availability`

## Request

- Base URL: `https://gotable.app`
- URL: `https://gotable.app/api/v1/restaurants/{restaurant_id}/offers/{offer_id}/availability`
- Auth: HTTP bearer

Retrieve the availability for a restaurant's offer over a given date range. Every date in the range is returned; one without availability comes back closed with no timeslots. Dates in the past are omitted.

## Path parameters

- `restaurant_id` integer, required
- `offer_id` integer, required

## Query parameters

- `from` string
- `till` string

## Response `200`

With a valid API token

- Availability
  - `from` string, date: The first date that is covered by the `dates` array
  - `till` string, date: The last date that is covered by the `dates` array
  - `dates` object[]: An array of dates with information about the availability on that date
    - `date` string, date: The date with availability information
    - `closed` boolean: Whether or not the restaurant can receive reservations
    - `timeslots` object[]: An array of timeslots for which a reservation can be made
      - `time` string
      - `minimum` integer: The minimum number of guests in a party for a new realtime reservation
      - `maximum` integer: The maximum number of guests in a party for a new realtime reservation

## Other responses

- `401`: With an invalid API token
- `403`: With an unauthorized API token
- `404`: With a non-existant Offer ID

---

[API](https://skmtc.dev/gotable/apis/gotable-api-v1.md) · [All operations](https://skmtc.dev/gotable/apis/gotable-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/gotable/apis/gotable-api-v1/revisions/abe658488f5b?raw)