# Get a restaurant profile

Source: https://docs.fiest.io/api/reference/get-restaurant
Canonical sandbox contract: https://docs.fiest.io/openapi.yaml

## GET /v1/restaurants/{restaurantId}

Returns general restaurant information. A restaurant outside the current authorization is returned as not found. Organization-boundary tokens also require fiest.organization.read.

## Authentication

Send an OAuth access token in the `Authorization` header as
`Bearer $FIEST_ACCESS_TOKEN`.

Required scopes: `fiest.restaurant.read`, `fiest.accounting.read`

## Quick request

```bash
curl --request GET \
  --url 'https://api-sandbox.fiest.io/v1/restaurants/11111111-1111-4111-8111-111111111111' \
  --header 'Authorization: Bearer $FIEST_ACCESS_TOKEN'
```

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `restaurantId` | path | Yes | string (uuid) | A restaurant identifier returned by the authorized restaurant list. |

## Success response

### 200 — The authorized restaurant profile.

```json
{
  "data": {
    "restaurantId": "11111111-1111-4111-8111-111111111111",
    "restaurantName": "Fiest Sandbox Helsinki",
    "businessIdentity": {
      "registeredName": "Fiest Sandbox Restaurants Oy",
      "businessId": "1234567-8"
    },
    "countryCode": "FI",
    "joinedAt": "2025-01-15T09:00:00.000Z",
    "firstCompletedOrderAt": "2025-01-16T10:32:00.000Z",
    "lastCompletedOrderAt": "2026-07-30T18:42:00.000Z",
    "timeZone": "Europe/Helsinki",
    "businessDayStartHour": 4,
    "scheduleEnabled": true,
    "openingHours": [
      {
        "day": "monday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "10:30",
            "closeTime": "22:00",
            "spansNextDay": false
          }
        ]
      },
      {
        "day": "tuesday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "10:30",
            "closeTime": "22:00",
            "spansNextDay": false
          }
        ]
      },
      {
        "day": "wednesday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "10:30",
            "closeTime": "22:00",
            "spansNextDay": false
          }
        ]
      },
      {
        "day": "thursday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "10:30",
            "closeTime": "23:00",
            "spansNextDay": false
          }
        ]
      },
      {
        "day": "friday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "10:30",
            "closeTime": "01:00",
            "spansNextDay": true
          }
        ]
      },
      {
        "day": "saturday",
        "isClosed": false,
        "shifts": [
          {
            "openTime": "12:00",
            "closeTime": "01:00",
            "spansNextDay": true
          }
        ]
      },
      {
        "day": "sunday",
        "isClosed": true,
        "shifts": []
      }
    ],
    "openingHoursTruncated": false,
    "paymentProviders": [
      {
        "provider": "sumup",
        "connectedAt": "2025-01-15T10:00:00.000Z",
        "activeForPos": true,
        "preferredForOnline": false
      }
    ],
    "paymentProvidersTruncated": false
  }
}
```

## Error responses

### 400 — The request parameters are invalid.

```json
{
  "error": "invalid_request",
  "message": "The requested date range is invalid.",
  "request_id": "req_sandbox_invalid_request"
}
```

### 401 — The access token is missing, invalid, or expired.

```json
{
  "error": "invalid_token",
  "error_description": "The access token is invalid.",
  "request_id": "req_sandbox_invalid_token"
}
```

### 403 — The authorization has expired or does not include the required scope.

```json
{
  "error": "insufficient_scope",
  "error_description": "Restaurant and accounting read access are required.",
  "request_id": "req_sandbox_insufficient_scope"
}
```

### 404 — The restaurant does not exist or is outside the authorization.

```json
{
  "error": "not_found",
  "request_id": "req_sandbox_not_found"
}
```

### 429 — The partner request limit has been exceeded.

```json
{
  "error": "rate_limited",
  "request_id": "req_sandbox_rate_limited"
}
```

### 503 — The API or one of its required services is unavailable.

```json
{
  "error": "service_unavailable",
  "request_id": "req_sandbox_service_unavailable"
}
```

## Related

- [Quick start](https://docs.fiest.io/api/quickstart)
- [Stable API errors](https://docs.fiest.io/api/reference/errors)
- [Download the OpenAPI 3.1 YAML contract](https://docs.fiest.io/openapi.yaml)
- [Authorize a Partner API connection](https://docs.fiest.io/api/quickstart)