1. v1
Tourwell Open APIs
  • Tổng quan
  • Hướng dẫn xác thực
  • API Zalo Mini App (Beta)
  • API Changelog
  • Error Response
  • Khách hàng
    • v1
      • Get by id
        GET
      • Get all customer
        GET
      • Create customer
        POST
      • Update customer
        PUT
      • Get order history
        GET
      • Get destinations
        GET
      • Get guests
        GET
      • Get by id care history
        GET
      • Create company
        POST
      • Get all care history
        GET
  • Đơn hàng
    • v1
      • Get by id
      • Get all order
      • Get Passengers Order
      • Create order tour
      • Create order product
      • Create order hotel
      • Create order flight
      • Confirm payment order
      • Cancel order
      • Import Order Flight
      • Create cost order
      • Update cost order
      • Delete cost order
  • Điều hành
    • v1
      • Overview
      • Create row cost
      • Update row cost
      • Delete row cost
  • Sản phẩm
    • v1
      • Create product
      • Get by id
      • Calendar pricing
      • Get all product
      • Get schedule by id
      • Update product
  • Chiết tinh giá
    • v1
  • Nhà cung cấp
    • v1
      • Get all suppliers
      • Get suppliers products
      • Get all tour guides
      • Create Supplier & Hotel
      • Create Prices Suppliers products
      • Append Prices Hotel
  • Lịch khởi hành
    • v1
      • Get all tour
      • Create tour
  • Lead (Cơ hội)
    • Overview
    • Update History
    • v1
      • Get all lead
      • Get by id
      • Create lead
      • Update lead
  • Báo giá
    • v1
      • Get all
      • Update schedules
      • Update policy
  • Khách sạn
    • v1
      • Get all hotel
      • Get by id
  • Kế toán
    • Phiếu thu
      • v1
        • Get all receipt
        • Create receipt
        • Update receipt
        • Confirm Receipt Success
    • Phiếu chi
      • v1
        • Get all payment
        • Confirm Payment
    • Hóa đơn bán ra
      • Update invoice
      • Issue Invoice
      • Get by id
      • Cancel invoice
    • Hóa đơn mua vào
      • Import
  • Phê duyệt
    • v1
      • Overview
      • Summary
      • Approvals
  • Cấu hình
    • Zalo ZNS
      • Danh sách Tag
      • Get token
    • Địa điểm
      • Search
    • Nhân sự nội bộ
      • Search
    • Webhook
      • Hướng dẫn cài đặt
    • Trạng thái khách hàng
      • Get All
    • Hạng thành viên
      • Get All
    • Loại dịch vụ
    • Mã sân bay
      • Get All Airport
    • Phương thức thanh toán
      • Get All
    • Nguồn bán hàng
      • Get All
    • Phễu chuyển đổi lead
      • Trạng thái lead
      • Trạng thái báo giá
  • Hướng dẫn tích hợp
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website và Tourwell
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website, Cổng thanh toán và Tourwell
  1. v1

Get order history

GET
/api/v1/customers/{id}/orders/history
Danh sách lịch sử đơn hàng theo từng khách hàng cụ thể

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://demo.tourwell.net/api/v1/customers//orders/history' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
    "data": [
        {
            "id": 1525,
            "code": "UP1525",
            "link_erp": "http://tour.upwell.test/admin/order/1525/show",
            "customer": {
                "id": 2229,
                "code": "KH2229",
                "name": "(Quý khách) NVT-TEST-IN",
                "link_erp": "http://tour.upwell.test/admin/customer/2229/show"
            },
            "company": {
                "id": 57,
                "code": "DN0057",
                "name": "CTY TNHH MK-TRAVEL",
                "link_erp": "http://tour.upwell.test/admin/company/57/show",
                "addresses": {
                    "invoice": "",
                    "headquarter": ""
                },
                "tax_code": "",
                "brand_name": ""
            },
            "creator": {
                "id": 1,
                "name": "Admin"
            },
            "source": {
                "id": 28,
                "name": "TikTok"
            },
            "sales_person": [
                {
                    "id": 1,
                    "name": "Admin"
                }
            ],
            "services": [
                {
                    "id": 2047,
                    "service_info": {
                        "id": 10,
                        "name": "Tour tự tổ chức",
                        "code": "tour"
                    },
                    "item_info": {
                        "name": "Tour Úc 5N4D",
                        "description": "Tour đoàn riêng",
                        "tour_info": {
                            "code": "TD1126",
                            "name": "Tour Úc 5N4D",
                            "departure_date": "17/05/2026",
                            "return_date": "19/05/2026"
                        }
                    },
                    "departure_date": "17/05/2026",
                    "return_date": "19/05/2026",
                    "seat_number": null,
                    "room_number": null,
                    "pickup_location": null,
                    "pickup_time": "",
                    "visa_count": null,
                    "passenger_note": null,
                    "service_code_note": null,
                    "financial_summary": {
                        "total_amount": "40,000,000",
                        "total_amount_cost": "1,450,000",
                        "total_amount_profit": "38,550,000",
                        "total_com_partner": 0,
                        "total_com_staff": 0
                    },
                    "prices": [
                        {
                            "stt": 1,
                            "object": {
                                "title": "Người lớn",
                                "description": "",
                                "note": null
                            },
                            "commission": {
                                "partner": 0,
                                "staff": 0,
                                "total_partner": 0,
                                "total_com_staff": 0
                            },
                            "unit_price": {
                                "original": "4,000,000",
                                "forex": 0
                            },
                            "quantity": 10,
                            "period": 1,
                            "unit": "Khách",
                            "vat": {
                                "value": 0,
                                "type": "percent",
                                "type_label": "Chưa gồm VAT"
                            },
                            "amount_total": {
                                "original": "40,000,000",
                                "forex": 0
                            },
                            "grand_total": {
                                "original": "40,000,000",
                                "forex": 0
                            },
                            "currency": "vnd"
                        }
                    ]
                }
            ],
            "created_at": "17/05/2026 22:37",
            "order_at": "17/05/2026 22:38",
            "cancel_at": "",
            "status": "Thành công",
            "status_code": 1,
            "currency": {
                "foreign_currency": "vnd",
                "base_currency": "vnd",
                "exchange_rate": 1
            },
            "total_payment": {
                "foreign": "40000000",
                "base": 40000000
            },
            "total_paid": {
                "foreign": "0",
                "base": 0
            },
            "total_remaining": {
                "foreign": "40000000",
                "base": 40000000
            },
            "total_discount": {
                "foreign": "0",
                "base": 0
            },
            "payment_state": "Chưa thanh toán",
            "receipt_vouchers": [
                {
                    "id": 1107,
                    "code": "PT1070",
                    "description": "TT",
                    "amount": 10000000,
                    "payment_date": "18/05/2026 15:34",
                    "status": "Chưa duyệt"
                }
            ],
            "payment_vouchers": [],
            "logistics": {
                "pickup_locations": [],
                "room_structures": []
            }
        },
        {
            "id": 1524,
            "code": "UP1524",
            "link_erp": "http://tour.upwell.test/admin/order/1524/show",
            "customer": {
                "id": 2229,
                "code": "KH2229",
                "name": "(Quý khách) NVT-TEST-IN",
                "link_erp": "http://tour.upwell.test/admin/customer/2229/show"
            },
            "company": {
                "id": 57,
                "code": "DN0057",
                "name": "CTY TNHH MK-TRAVEL",
                "link_erp": "http://tour.upwell.test/admin/company/57/show",
                "addresses": {
                    "invoice": "",
                    "headquarter": ""
                },
                "tax_code": "",
                "brand_name": ""
            },
            "creator": {
                "id": 1,
                "name": "Admin"
            },
            "source": {
                "id": 28,
                "name": "TikTok"
            },
            "sales_person": [
                {
                    "id": 1,
                    "name": "Admin"
                }
            ],
            "services": [
                {
                    "id": 2046,
                    "service_info": {
                        "id": 8,
                        "name": "Vé máy bay",
                        "code": "flight"
                    },
                    "item_info": {
                        "name": "Vé máy bay Nhiều chặng",
                        "description": "Từ Hà Nội (HAN) đến Hồ Chí Minh (SGN)"
                    },
                    "departure_date": "17/05/2026",
                    "return_date": "17/05/2026",
                    "seat_number": null,
                    "room_number": null,
                    "pickup_location": null,
                    "pickup_time": "",
                    "visa_count": null,
                    "passenger_note": null,
                    "service_code_note": null,
                    "financial_summary": {
                        "total_amount": 0,
                        "total_amount_cost": 2000000,
                        "total_amount_profit": "500,000",
                        "total_com_partner": 0,
                        "total_com_staff": 0
                    },
                    "prices": [
                        {
                            "stt": 1,
                            "object": {
                                "title": "Người lớn",
                                "description": "",
                                "note": null
                            },
                            "commission": {
                                "partner": 0,
                                "staff": 0,
                                "total_partner": 0,
                                "total_com_staff": 0
                            },
                            "unit_price": {
                                "original": "2,500,000",
                                "forex": 0
                            },
                            "quantity": 1,
                            "period": 1,
                            "unit": "Khách",
                            "vat": {
                                "value": 0,
                                "type": "percent",
                                "type_label": "Đã gồm VAT"
                            },
                            "amount_total": {
                                "original": "2,500,000",
                                "forex": 0
                            },
                            "grand_total": {
                                "original": "2,500,000",
                                "forex": 0
                            },
                            "currency": "vnd"
                        }
                    ]
                }
            ],
            "created_at": "17/05/2026 15:20",
            "order_at": "",
            "cancel_at": "",
            "status": "Đang xử lý",
            "status_code": 0,
            "currency": {
                "foreign_currency": "vnd",
                "base_currency": "vnd",
                "exchange_rate": 1
            },
            "total_payment": {
                "foreign": "2500000",
                "base": 2500000
            },
            "total_paid": {
                "foreign": "0",
                "base": 0
            },
            "total_remaining": {
                "foreign": "2500000",
                "base": 2500000
            },
            "total_discount": {
                "foreign": "0",
                "base": 0
            },
            "payment_state": "Chưa thanh toán",
            "receipt_vouchers": [],
            "payment_vouchers": [],
            "logistics": {
                "pickup_locations": [],
                "room_structures": []
            }
        },
        {
            "id": 1523,
            "code": "UP1523",
            "link_erp": "http://tour.upwell.test/admin/order/1523/show",
            "customer": {
                "id": 2229,
                "code": "KH2229",
                "name": "(Quý khách) NVT-TEST-IN",
                "link_erp": "http://tour.upwell.test/admin/customer/2229/show"
            },
            "company": {
                "id": 57,
                "code": "DN0057",
                "name": "CTY TNHH MK-TRAVEL",
                "link_erp": "http://tour.upwell.test/admin/company/57/show",
                "addresses": {
                    "invoice": "",
                    "headquarter": ""
                },
                "tax_code": "",
                "brand_name": ""
            },
            "creator": {
                "id": 1,
                "name": "Admin"
            },
            "source": [],
            "sales_person": [
                {
                    "id": 1,
                    "name": "Admin"
                }
            ],
            "services": [
                {
                    "id": 2045,
                    "service_info": {
                        "id": 2,
                        "name": "Khách sạn",
                        "code": "hotel"
                    },
                    "item_info": {
                        "name": "Khách sạn tại Việt Nam",
                        "description": "Tên khách sạn Khách sạn 1"
                    },
                    "departure_date": "15/05/2026",
                    "return_date": "16/05/2026",
                    "seat_number": "",
                    "room_number": "",
                    "pickup_location": "",
                    "pickup_time": "",
                    "visa_count": null,
                    "passenger_note": "",
                    "service_code_note": "",
                    "financial_summary": {
                        "total_amount": 0,
                        "total_amount_cost": 277777.77777778,
                        "total_amount_profit": "-92,593",
                        "total_com_partner": 0,
                        "total_com_staff": 0
                    },
                    "prices": [
                        {
                            "stt": 1,
                            "object": {
                                "title": "Phòng 2",
                                "description": "",
                                "note": null
                            },
                            "commission": {
                                "partner": 0,
                                "staff": 0,
                                "total_partner": 0,
                                "total_com_staff": 0
                            },
                            "unit_price": {
                                "original": "200,000",
                                "forex": 0
                            },
                            "quantity": 1,
                            "period": 1,
                            "unit": "Phòng",
                            "vat": {
                                "value": 8,
                                "type": "percent",
                                "type_label": "Đã gồm VAT"
                            },
                            "amount_total": {
                                "original": "185,185",
                                "forex": 0
                            },
                            "grand_total": {
                                "original": "200,000",
                                "forex": 0
                            },
                            "currency": "vnd"
                        }
                    ]
                }
            ],
            "created_at": "15/05/2026 15:38",
            "order_at": "",
            "cancel_at": "",
            "status": "Đang xử lý",
            "status_code": 0,
            "currency": {
                "foreign_currency": "vnd",
                "base_currency": "vnd",
                "exchange_rate": 1
            },
            "total_payment": {
                "foreign": "200000",
                "base": 200000
            },
            "total_paid": {
                "foreign": "0",
                "base": 0
            },
            "total_remaining": {
                "foreign": "200000",
                "base": 200000
            },
            "total_discount": {
                "foreign": "0",
                "base": 0
            },
            "payment_state": "Chưa thanh toán",
            "receipt_vouchers": [
                {
                    "id": 1101,
                    "code": "PT1069",
                    "description": "TT",
                    "amount": 100000,
                    "payment_date": "17/05/2026 14:45",
                    "status": "Chưa duyệt"
                }
            ],
            "payment_vouchers": [],
            "logistics": {
                "pickup_locations": [],
                "room_structures": []
            }
        }
    ],
    "links": {
        "first": "http://tour.upwell.test/api/v1/customers/2229/orders/history?page=1",
        "last": "http://tour.upwell.test/api/v1/customers/2229/orders/history?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Trước",
                "active": false
            },
            {
                "url": "http://tour.upwell.test/api/v1/customers/2229/orders/history?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Sau &raquo;",
                "active": false
            }
        ],
        "path": "http://tour.upwell.test/api/v1/customers/2229/orders/history",
        "per_page": 25,
        "to": 3,
        "total": 3
    }
}
Modified at 2026-05-19 23:25:19
Previous
Update customer
Next
Get destinations
Built with