---
title: "Create reservation"
method: POST
path: "/reservation/{locale}"
tags: ["Reservations"]
---

# Create reservation

`POST /reservation/{locale}`

Creates a new reservation. The department must belong to the locale.

## Path parameters

- `locale` integer, required

## Request body

- CreateReservationRequest
  - `department_id` integer, required — Department ID (use /locale/{id}/departments to get available IDs)
  - `date` string, date, required — Reservation date (YYYY-MM-DD)
  - `time` string, required — Reservation time (HH:MM)
  - `persons` integer, required
  - `name` string
  - `email` string, email
  - `phone` string
  - `message` string
  - `language` string
  - `comment` string
  - `duration_hours` integer
  - `duration_minutes` integer
  - `preferred_hall_id` integer

## Response `200`

Reservation created

- object
  - `success` boolean
  - `data` Reservation
    - `id` integer
    - `code` string
    - `department_id` integer, nullable
    - `name` string
    - `persons` integer, nullable
    - `date` string, date
    - `time` string
    - `reservation_till` string, date-time, nullable
    - `duration_hours` integer, nullable
    - `duration_minutes` integer, nullable
    - `email` string
    - `phone` string
    - `message` string
    - `comment` string
    - `status` integer — 1=CONFIRMED, 2=WAITING_FOR_CONFIRMATION, 3=DECLINED, 4=WAITING_FOR_PAYMENT, 5=PAYMENT_FAILED
    - `status_label` 'CONFIRMED' | 'WAITING_FOR_CONFIRMATION' | 'DECLINED' | 'WAITING_FOR_PAYMENT' | 'PAYMENT_FAILED' | 'UNKNOWN'
    - `source` string, nullable
    - `arrival_status` string, nullable
    - `table_id` integer, nullable
    - `preferred_hall_id` integer, nullable
    - `created_at` string, date-time, nullable

## Other responses

- `403` — API key not authorized for this locale or missing required scope
- `404` — Department not found
- `422` — Validation error

---

[API](https://skmtc.dev/myrest/apis/myrest-public-api.md) · [All operations](https://skmtc.dev/myrest/apis/myrest-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myrest/myrest-public-api/revisions/70905e6e4284/schema)