Tourwell Open APIs
  1. v1
Tourwell Open APIs
  • Tổng quan
  • Hướng dẫn xác thực
  • API Beta 1.0
  • API Zalo Mini App (Beta)
  • Khách hàng
    • v1
      • Get by id
        GET
      • Get all customer
        GET
      • Create customer
        POST
      • Update customer
        PUT
      • Get order history
        GET
  • Đơn hàng
    • v1
      • Get by id
      • Get all order
      • Create order tour
      • Create order product
      • Create order hotel
      • Confirm payment order
  • Sản phẩm
    • v1
      • Create product
      • Get by id
      • Calendar pricing
  • Lịch khởi hành
  • Lead (Cơ hội)
    • v1
      • Get all lead
      • Get by id
      • Create lead
      • Update lead
  • Khách sạn
    • v1
      • Get all hotel
      • Get by id
  • Kế toán
    • Phiếu thu
      • v1
        • Get all receipt
    • Phiếu chi
      • v1
        • Get all payment
        • Confirm Payment
    • Hóa đơn
      • Update invoice
      • Issue Invoice
      • Get by id
      • Cancel invoice
  • 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
    • Loại dịch vụ
  1. v1

Get all customer

GET
/api/v1/customers

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
name
string 
optional
Tìm theo tên
Example:
Cẩm Lệ
code
string 
optional
Tìm theo mã
Example:
KH75
email
string 
optional
Tìm theo email
Example:
example@email.com
sale_email
string 
optional
Tìm theo email nhân viên phụ trách
Example:
kd2@upwell.vn
sub_group
string 
optional
Tìm theo nhóm khách
Hệ thống quy định nhóm tìm kiếm
personal: Cá nhân
enterprise: Doanh nghiệp
collaborator: Cộng tác viên
agency: Đại lý/Đối tác
organization: Cơ quan tổ chức
Example:
personal
has_account
string 
optional
Tình trạng tạo tài khoản đại lý
already: Đã tạo tài khoản
no: Chưa tạo tài khoản
Example:
already
agent_level_id
integer 
optional
ID phân cấp đại lý tại cấu hình CRM
Example:
1

Request 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 --request GET 'https://demo.tourwell.net/api/v1/customers?name=Cẩm Lệ&code=KH75&email=example@email.com&sale_email=kd2@upwell.vn	&sub_group=personal&has_account=already&agent_level_id=1'

Responses

🟢200OK
application/json
Body
data
array [object {28}] 
required
id
integer 
required
code
string 
required
link_erp
string 
required
omi_id
string  | null 
required
pronoun
string 
required
gender
string 
required
name
string 
required
phone
object 
required
email
object 
required
company
array[string]
required
creator
array[string]
required
sales_person
array [object {3}] 
required
sub_group
string 
required
medal
string 
required
type
string 
required
source
object 
required
birthday
string 
required
identification
string  | null 
required
passport
string  | null 
required
address
object 
required
agent_level
array[string]
required
facebook
object 
required
status
string 
required
total_care
integer 
required
latest_care_timestamp
string 
required
order_history
object 
required
created_at
string 
required
created_at_timestamp
integer 
required
links
object 
required
first
string 
required
last
string 
required
prev
null 
required
next
null 
required
meta
object 
required
current_page
integer 
required
from
integer 
required
last_page
integer 
required
links
array [object {3}] 
required
path
string 
required
per_page
integer 
required
to
integer 
required
total
integer 
required
Example
{"data":[{"id":2150,"code":"KH2150","link_erp":"http://tour.upwell.local/admin/customer/2150/show","omi_id":"","pronoun":"Chị","gender":"Khác","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"0888899000","code":"+84"},"secondary":{"number":"0912345678","code":"+84"}},"email":{"primary":"","secondary":""},"company":[],"creator":[],"sales_person":[],"sub_group":"Cá nhân","medal":"Kim cương","type":"Khách lẻ","source":{"id":1,"name":"Nguồn 1"},"birthday":"01/01/1990","identification":"123456789","passport":"B12345678","address":{"line":"123 Lý Thường Kiệt, Quận 10, TP.HCM","city":"","country":"","country_code":""},"agent_level":{"id":2,"name":"Cấp 2"},"facebook":{"link":"","name":null},"status":"Khách lẻ","total_care":0,"latest_care_timestamp":"","order_history":{"count":32,"total_revenue":"198,860,000","current_debt":"168,760,000","link":""},"created_at":"30/05/2025 12:09:37","created_at_timestamp":1748581777000},{"id":2149,"code":"KH2149","link_erp":"http://tour.upwell.local/admin/customer/2149/show","omi_id":"","pronoun":"chi","gender":"Khác","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"0988899000","code":"+84"},"secondary":{"number":"0912345678","code":"+84"}},"email":{"primary":"email@gmail.com","secondary":"email2@gmail.com"},"company":[],"creator":[],"sales_person":[],"sub_group":"Cá nhân","medal":"","type":"Khách lẻ","source":{"id":1,"name":"Nguồn 1"},"birthday":"01/01/1990","identification":"123456789","passport":"B12345678","address":{"line":"123 Lý Thường Kiệt, Quận 10, TP.HCM","city":"","country":"","country_code":""},"agent_level":{"id":2,"name":"Cấp 2"},"facebook":{"link":"","name":null},"status":"Khách lẻ","total_care":0,"latest_care_timestamp":"","order_history":{"count":0,"total_revenue":"0","current_debt":"0","link":""},"created_at":"30/05/2025 11:13:31","created_at_timestamp":1748578411000},{"id":2147,"code":"KH2147","link_erp":"http://tour.upwell.local/admin/customer/2147/show","omi_id":null,"pronoun":"Chị","gender":"Nam","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"0888899000","code":"+84"},"secondary":{"number":"0912345678","code":"+84"}},"email":{"primary":null,"secondary":null},"company":[],"creator":{"id":1,"name":"Admin","email":"admin@admin.com"},"sales_person":[{"id":1,"name":"Admin","email":"admin@admin.com"}],"sub_group":"Cá nhân","medal":"Kim cương","type":"Khách lẻ","source":{"id":1,"name":"Nguồn 1"},"birthday":"01/01/1990","identification":"123456789","passport":"B12345678","address":{"line":"123 Lý Thường Kiệt, Quận 10, TP.HCM","city":"","country":"Việt Nam","country_code":"vn"},"agent_level":{"id":2,"name":"Cấp 2"},"facebook":{"link":null,"name":null},"status":"Khách lẻ","total_care":0,"latest_care_timestamp":"","order_history":{"count":57,"total_revenue":"279,720,000","current_debt":"273,720,000","link":""},"created_at":"05/05/2025 11:22:28","created_at_timestamp":1746418948000},{"id":107,"code":"KH107","link_erp":"http://tour.upwell.local/admin/customer/107/show","omi_id":"66f0f4e7da8b7a57f5c5446d","pronoun":"Chị","gender":"Nữ","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"0988776511","code":""},"secondary":{"number":"0","code":""}},"email":{"primary":"","secondary":""},"company":[],"creator":[],"sales_person":[],"sub_group":"Cá nhân","medal":"Tiêu chuẩn","type":"","source":{"id":1,"name":"Nguồn 1"},"birthday":"","identification":"","passport":"","address":{"line":"","city":"","country":"","country_code":""},"agent_level":[],"facebook":{"link":"","name":null},"status":"","total_care":0,"latest_care_timestamp":"","order_history":{"count":0,"total_revenue":"0","current_debt":"0","link":""},"created_at":"03/10/2024 14:20:04","created_at_timestamp":1727940004000},{"id":106,"code":"KH106","link_erp":"http://tour.upwell.local/admin/customer/106/show","omi_id":"","pronoun":"Chị","gender":"Nữ","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"098877123","code":null},"secondary":{"number":"0","code":null}},"email":{"primary":null,"secondary":""},"company":[],"creator":[],"sales_person":[{"id":1,"name":"Admin","email":"admin@admin.com"}],"sub_group":"Cá nhân","medal":"Tiêu chuẩn","type":"","source":{"id":1,"name":"Nguồn 1"},"birthday":"31/10/1990","identification":null,"passport":null,"address":{"line":null,"city":"","country":"","country_code":""},"agent_level":[],"facebook":{"link":null,"name":null},"status":"","total_care":0,"latest_care_timestamp":"","order_history":{"count":0,"total_revenue":"0","current_debt":"0","link":""},"created_at":"03/10/2024 13:30:42","created_at_timestamp":1727937042000},{"id":105,"code":"KH105","link_erp":"http://tour.upwell.local/admin/customer/105/show","omi_id":"","pronoun":"Chị","gender":"Nữ","name":"Thân Thị Cẩm Lệ","phone":{"primary":{"number":"","code":""},"secondary":{"number":"0","code":""}},"email":{"primary":"","secondary":""},"company":[],"creator":[],"sales_person":[],"sub_group":"Cá nhân","medal":"Tiêu chuẩn","type":"","source":{"id":1,"name":"Nguồn 1"},"birthday":"","identification":"","passport":"","address":{"line":"","city":"","country":"","country_code":""},"agent_level":[],"facebook":{"link":"","name":null},"status":"","total_care":0,"latest_care_timestamp":"","order_history":{"count":0,"total_revenue":"0","current_debt":"0","link":""},"created_at":"03/10/2024 13:26:47","created_at_timestamp":1727936807000}],"links":{"first":"http://tour.upwell.local/api/v1/customers?page=1","last":"http://tour.upwell.local/api/v1/customers?page=1","prev":null,"next":null},"meta":{"current_page":1,"from":1,"last_page":1,"links":[{"url":null,"label":"« Trước","active":false},{"url":"http://tour.upwell.local/api/v1/customers?page=1","label":"1","active":true},{"url":null,"label":"Sau »","active":false}],"path":"http://tour.upwell.local/api/v1/customers","per_page":25,"to":6,"total":6}}
Modified at 2025-06-13 08:37:03
Previous
Get by id
Next
Create customer
Built with