---
title: "Retrieve a paginated list of a restaurant's offers"
method: GET
path: "/api/v1/restaurants/{restaurant_id}/offers"
tags: ["Offer"]
---

# Retrieve a paginated list of a restaurant's offers

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

## Request

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

## Path parameters

- `restaurant_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

With a valid API token

- object
  - `offers` Offer[]
    - `id` integer: The unique ID of the offer
    - `restaurant_id` integer: The unique ID of the restaurant
    - `created_at` string, datetime: The datetime the offer was created
    - `updated_at` string, datetime: The datetime the offer was last updated
    - `deposit_per_guest` integer, nullable: The deposit amount, in cents, required per guest when making a reservation
    - `visible` boolean: Wether or not the offer is currently visible
    - `visible_from` string, date: The date that this offer becomes visible
    - `available_from` string, date, nullable: The first date that you can book this offer on
    - `available_till` string, date, nullable: The last date that you can book this offer on
    - `images` object[]: An array of images that can be displayed next to the offer
      - `name` string: The name and/or variant of an image
      - `url` string, uri: An URL that can be used to download the image
    - `translations` object[]: An array of translations containing the description of the offer
      - `locale` string: The language code of the translated texts
      - `label` string: The label that can be used to refer to the offer
      - `description_short` string: A small preview that describes the offer before selection
      - `description_long` string: A description that goes into more detail when an offer is selected
    - `tags` string[]: An array of tags of the offer that are automatically given to reservations made for it
    - `links` Link[]: An array of links useful for this reservation
      - `href` string: The URL to the related resource.
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE': The HTTP method that should be used to follow the link.
      - `rel` string: The relationship of this link to the current resource.
  - `meta` Pagination
    - `current_page` integer
    - `per_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `links` Link[]: An array of pagination links
      - `href` string: The URL to the related resource.
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE': The HTTP method that should be used to follow the link.
      - `rel` string: The relationship of this link to the current resource.

## Other responses

- `401`: With an invalid API token
- `403`: With an unauthorized API token
- `404`: With a non-existant Restaurant 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)