Get Reservations

The following is the method to get the reservations.

Request URL

GET https://api.zerva.app/api/v1/reservation

Request Headers

Name	Type	Required	Description
Authorization	String	✅	The access token received from Issue Access Token.
Accept-Language	String	✅	The language to be used in the response.

Request Query Parameters

Name	Type	Required	Description
page_id	String	❌	Filter reservations by page ID.
payment_status	String	❌	Filter reservations by payment status.
booking_status	String	❌	Filter reservations by booking status.
start_date	String	❌	Filter reservations from this start date (inclusive).
end_date	String	❌	Filter reservations to this end date (inclusive).
offset	String	❌	Number of reservations to skip before returning results.
limit	String	❌	Maximum number of reservations to return.

Request Example

curl -X GET 'https://api.zerva.app/api/v1/reservation?offset=0&limit=10' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept-Language: th,en'

Response

Name	Type	Description
total	Number	The total number of reservations
reservations	Array	The reservations

Reservation

Name	Type	Description
id	String	The reservation ID
seq_booking_no	String	The sequence booking number
first_name	String	The first name of the customer
last_name	String	The last name of the customer
telephone_no	String	The telephone number of the customer
email	String	The email of the customer
note	String	The note of the reservation
reserve_details	Array	The reservation details
payment_status	String	The payment status
user_ref	String	The user reference
customer_lang	String	The customer language
created_at	String	The date and time when the reservation was created
last_updated_at	String	The date and time when the reservation was last updated
details	Array	The details

Details

Name	Type	Description
quantity	Number	The quantity
start_at	String	The start time of the reservation
end_at	String	The end time of the reservation
booking_status	String	The booking status
reserve_details	Array	The reservation details
service	Object	The service
sub_service	Object	The sub service

Service

Name	Type	Description
id	String	The service ID
name	String	The service name
description	String	The service description
note	String	The service note

Sub Service

Name	Type	Description
id	String	The sub service ID
name	String	The sub service name
is_display_start_time	Boolean	Whether the start time should be shown to the customer during reservation.
is_display_end_time	Boolean	Whether the end time should be shown to the customer during reservation.
service_details	String	The sub service details
reservation_notes	String	The sub service reservation notes

Example

{
    "total": 1000,
    "reservations": [
        {
            "id": "f78b290b-a9d8-41cc-8c83-b169aa0a64ad",
            "seq_booking_no": "1",
            "first_name": "John",
            "last_name": "Doe",
            "telephone_no": "+66123456789",
            "email": "john.doe@example.com",
            "note": "อาจไปสายหน่อยนะครับ",
            "reserve_details": [
                {
                    "key": "Hello",
                    "value": "World"
                }
            ],
            "payment_status": "PAID",
            "user_ref": "88badaeb-2170-4ce9-9a88-86c8c489f1b0",
            "customer_lang": "th",
            "created_at": "2025-05-27T07:39:31.856Z",
            "last_updated_at": "2025-05-27T07:55:00.316Z",
            "details": [
                {
                    "quantity": 1,
                    "start_at": "2025-05-28T04:00:00.000Z",
                    "end_at": "2025-05-28T05:00:00.000Z",
                    "booking_status": "ACCEPTED",
                    "reserve_details": [
                        {
                            "key": "Hello",
                            "value": "World"
                        }
                    ],
                    "service": {
                        "id": "da93acea-a2ba-4cbc-acfb-c2ec845e2ed3",
                        "name": "Backend Development Course",
                        "description": "คอร์สเรียนพัฒนา Backend",
                        "note": "สำหรับผู้เริ่มต้นเท่านั้น"
                    },
                    "sub_service": {
                        "id": "084b3ce4-da7d-44ba-ad6b-e0d0125dc933",
                        "name": "NodeJS Zero to Hero",
                        "is_display_start_time": true,
                        "is_display_end_time": true,
                        "service_details": "คอร์สเรียนพัฒนา Backend สำหรับมือใหม่",
                        "reservation_notes": "1. ต้องมาก่อน 10 นาที\n2. หากไม่มาตามวัน-เวลาที่จองไว้ทางร้านขออนุญาติยกเลิกคิวและยึดค่ามัดจำ\n3. ทางร้านไม่อนุญาติให้ยกเลิกคิวได้ก่อนหน้า 2 วัน"
                    }
                }
            ]
        }
    ]
}