Lấy danh sách Journey Token

Lưu ý:

• Đối với các API sử dụng cho Shop thì API_KEY: <api_key>.Thông tin base_url của Shop

• Đối với các API sử dụng cho Partner thì API_KEY: <shop_key>.Thông tin base_url của Partner

ListJourneys

post

Body

application/json

Responses

200

A successful response

application/json

post

$BASE_URL.Zalo/ListJourneys

HTTPcURLJavaScriptPython

POST $BASE_URL.Zalo/ListJourneys HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 235

{
  "filter": {
    "date_from": "2025-12-13T19:41:43.338Z",
    "date_to": "2025-12-13T19:41:43.338Z",
    "is_charged": true,
    "journey_id": "text",
    "oa_id": "text",
    "phone": "text",
    "status": "Z"
  },
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "sort": "text"
  }
}

200

A successful response

{
  "journeys": [
    {
      "created_at": "2025-12-13T19:41:43.338Z",
      "error_code": 1,
      "error_message": "text",
      "expired_at": "2025-12-13T19:41:43.338Z",
      "id": "text",
      "is_charged": true,
      "journey_id": "text",
      "journey_token": "text",
      "phone": "text",
      "status": "Z",
      "updated_at": "2025-12-13T19:41:43.338Z"
    }
  ],
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "next": "text",
    "prev": "text",
    "sort": "text"
  }
}

Request:

curl --location '$BASE_URL.Zalo/ListJourneys' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "filter": {
    "date_from": "<dateTime>",
    "date_to": "<dateTime>",
    "journey_id": "<string>",
    "phone": "<string>"
  },
  "paging": {
    "after": "<string>",
    "before": "<string>",
    "limit": "<integer>",
    "sort": "<string>"
  }
}'

Response:

{
  "journeys": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "error_code": 0,
      "error_message": "string",
      "expired_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "is_charged": true,
      "journey_id": "string",
      "journey_token": "string",
      "phone": "string",
      "status": "Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "next": "string",
    "prev": "string",
    "sort": "string"
  }
}

Cấu trúc body của request

Tham số	Kiểu dữ liệu	Mô tả
oa_id	int64	ID của OA
journey_id	int64	ID của journey
phone	string	Số điện thoại người nhận
is_charged	bool	Tính phí hay không
status	string	Trạng thái Z: Mới tạo P: Enable N: Disable
date_from	string<date-time>	Ngày bắt đầu
date_to	string<date-time>	Ngày kết thúc

Cấu trúc thuộc tính dữ liệu trả về

Tham số	Kiểu dữ liệu	Mô tả
id	int64	ID của journey trên hệ thống eTelecom
journey_id	string	ID của journey
journey_token	string	Mã hành trình được kích hoạt
phone	string	Số điện thoại người nhận
status	string	Trạng thái Z: Mới tạo P: Enable N: Disable
is_charged	bool	Tính phí hay không
expires_at	string<date-time>	Thời gian hết hạn
updated_at	string<date-time>	Thời gian cập nhật
created_at	string<date-time>	Thời gian tạo