bookings

Confirm or decline a booking request

Records the owner's decision. QRTap does not notify the guest — the phone number on the request is how the business follows up. new is not accepted: a decided request is never reopened through the API. A request from another organization answers 404.

post/api/v1/bookings/{id}/status

Request

  • Base URL: https://app.qrtap.kg
  • URL: https://app.qrtap.kg/api/v1/bookings/{id}/status
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Booking request id (UUID) from GET /api/v1/bookings.

Request body

status'confirmed' | 'declined' required

The decision. new is not accepted — a decided request is never reopened through the API.

Response

The request in its new state.

idstring uuid required
servicestring required
preferred_atstring

Free-form desired time as the guest typed it ("завтра после 14:00"). Never parsed by the platform.

guest_namestring required
guest_phonestring required

As typed, validated to 9..15 digits.

status'new' | 'confirmed' | 'declined' required
created_atstring date-time required
updated_atstring date-time

Example response

{
  "id": "66666666-6666-4666-8666-666666666666",
  "service": "Маникюр",
  "preferred_at": "завтра после 14:00",
  "guest_name": "Айгуль",
  "guest_phone": "0555 123 456",
  "status": "new",
  "created_at": "2026-07-20T10:15:00.000Z",
  "updated_at": "2026-07-20T10:15:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.