Add Passengers Order

POST

/orders/{id}/passengers

Thêm một hoặc nhiều hành khách vào đơn hàng.

Tối đa 100 hành khách mỗi request.

Request được xử lý trọn vẹn: một hành khách sai dữ liệu thì không hành khách nào được thêm.

Hành khách đã có trong đơn được giữ nguyên (API chỉ thêm, không ghi đè danh sách).

Định dạng ngày: dd/mm/yyyy. Riêng birthday nhận thêm dạng chỉ năm sinh yyyy.

Xem danh sách hiện có: Get Passengers Order (GET /api/v1/orders/{id}/passengers).

Trong response, identity_issue_at và passport_exp_at trả dạng yyyy-mm-dd hh:mm:ss.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Example

{
    "passengers": [
        {
            "name": "Nguyễn Văn A",
            "phone": "0901234567",
            "gender": "male",
            "birthday": "15/08/1985",
            "passport": "C1234567",
            "passport_exp_at": "31/12/2030",
            "nationality": "Việt Nam",
            "is_leader": 1,
            "relationship_to_customer": "self",
            "room_number": "101"
        },
        {
            "name": "Trần Thị B",
            "gender": "female",
            "birthday": "1990",
            "relationship_to_customer": "spouse",
            "room_number": "101"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://demo.tourwell.net/orders/1728/passengers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "passengers": [
        {
            "name": "Nguyễn Văn A",
            "phone": "0901234567",
            "gender": "male",
            "birthday": "15/08/1985",
            "passport": "C1234567",
            "passport_exp_at": "31/12/2030",
            "nationality": "Việt Nam",
            "is_leader": 1,
            "relationship_to_customer": "self",
            "room_number": "101"
        },
        {
            "name": "Trần Thị B",
            "gender": "female",
            "birthday": "1990",
            "relationship_to_customer": "spouse",
            "room_number": "101"
        }
    ]
}'

Responses

🟢201Thành công

application/json

Bodyapplication/json

Example

{
    "success": true,
    "message": "Thêm hành khách thành công",
    "data": [
        {
            "id": 1385,
            "name": "Nguyễn Văn A",
            "email": null,
            "phone": "0901234567",
            "identity_card": null,
            "identity_issue_at": null,
            "birthday": "15/08/1985",
            "gender": "male",
            "gender_name": "Nam",
            "country_id": 0,
            "seat_number": null,
            "room_number": "101",
            "pickup_location": null,
            "note": null,
            "passport": "C1234567",
            "passport_exp_at": "2030-12-31 00:00:00",
            "nationality": "Việt Nam",
            "has_visa": 0,
            "visa_status_name": "Chưa có visa",
            "is_leader": 1,
            "role_name": "Trưởng đoàn",
            "relationship_to_customer": "self",
            "relationship_name": "Bản thân",
            "order_id": 1728
        }
    ]
}

🟠404Không tìm thấy

🟠422Sai dữ liệu

Modified at 2026-11-02 07:15:02

Change order status

Update Passenger Order