---
title: "Retrieve a list of accessible restaurants"
method: GET
path: "/api/v1/restaurants"
tags: ["Meta", "Restaurant"]
---

# Retrieve a list of accessible restaurants

`GET /api/v1/restaurants`

## Request

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

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

With a valid API token

- object
  - `restaurants` Restaurant[]
    - `id` integer: The unique ID of the restaurant
    - `created_at` string: The datetime the restaurant was created
    - `updated_at` string: The datetime the restaurant was last updated
    - `name` string: The name of the restaurant
    - `telephone` string, nullable: The telephone number of the restaurant
    - `email` string, nullable: The email address of the restaurant
    - `street` string, nullable: The street of the address of the restaurant
    - `zipcode` string, nullable: The zipcode of the address of the restaurant
    - `city` string, nullable: The city of the address of the restaurant
    - `time_zone` string, nullable: The timezone of the restaurant
    - `country_code` string, nullable: The two-letter country code of the restaurant
    - `currency` string: The ISO-4217 currency used for deposits
    - `links` Link[]: An array of useful links for this restaurant
      - `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

---

[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)