Mission Express V2 API Documentation

Overview

This document describes the Mission Express / Mission Rush / Mission Go V2 API surface: module switches, quoting, order creation, payments, refunds, Ship Parcel, Consolidation, Intercity Hitch, and driver workflow states.

Base URL

Except for file downloads, images, and external redirects, V2 App APIs are POST based.

Authentication

V2 app APIs identify users by user_id + token or drivers by rider_id + token. Admin-only APIs should not be published in public API documentation.

curl -X POST "https://v2-api.missionexpress.ca/index.php?s=/api/post/missionrush/myOrders" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "user_id=14&token=USER_TOKEN&page=1&list_rows=20"

Unified Response Format

code = 1 means success. code = 0 or any other value means failure. The user-facing error message is returned in msg.

{
  "code": 1,
  "msg": "ok",
  "time": 1779227065,
  "data": {}
}

Orders

The orders API powers the Mission Rush Orders page and can return unified rows for Direct, Cargo, Hitch, Consolidation, and Ship Parcel orders.

POST https://v2-api.missionexpress.ca/index.php?s=/api/post/missionrush/myOrders
user_id=14&token=USER_TOKEN&page=1&list_rows=20&tab=in_progress

Send / Cargo

Send is local courier delivery. Cargo is large-item / freight pickup and delivery. Distance fees should be based on platform route calculation, not front-end straight-line distance.

Food Pickup / Grocery Pickup

Food Pickup and Grocery Pickup share the Direct delivery fulfillment flow, but use different entry points, merchant lists, and order type metadata.

Ship Parcel

Ship Parcel is a formal V2 module supporting Canada Post rates, admin quote saving, payments, and Label / Tracking status fields.

Key request fields

Label / Tracking fields

Intercity Hitch

Hitch uses the separate /api/post/hitch controller path for city-pair routes, driver trips, matching, quoting, and paid order creation.

Consolidation

Consolidation covers customer registration, warehouse addresses, package pre-alerts, package lists, consolidation orders, final quotes, payments, and public price-list display for customers.

getConsolidationPriceList

This endpoint lets Mission Rush display consolidation route price-list information. It does not estimate package fees and does not create a payable amount.

Request fields

Important response fields

curl -X POST "https://v2-api.missionexpress.ca/index.php?s=/api/post/missionrush/getConsolidationPriceList" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "city_code=MOOSE_JAW"

{
  "code": 1,
  "msg": "ok",
  "data": {
    "list": [
      {
        "company_id": 2,
        "company_name": "广州奕宁达国际供应链有限公司",
        "transport_type": "air",
        "transport_type_name": "空运",
        "destination_city_code": "MOOSE_JAW",
        "destination_city_name": "Moose Jaw",
        "station_name": "Lillooet",
        "route_code": "AIR_YININGDA_TO_MOOSE_JAW",
        "price_rules": {
          "general": {
            "goods_type_name": "普货",
            "currency": "CNY",
            "first_weight_kg": 0.5,
            "first_fee": 34,
            "additional_unit_kg": 1,
            "additional_fee": 68,
            "customs_fee_per_ticket": 35,
            "volume_divisor": 6000
          },
          "sensitive": {
            "goods_type_name": "敏感货",
            "currency": "CNY",
            "first_weight_kg": 0.5,
            "first_fee": 37,
            "additional_unit_kg": 1,
            "additional_fee": 74,
            "customs_fee_per_ticket": 45,
            "volume_divisor": 6000
          }
        }
      }
    ],
    "billing_notice": "Prices are displayed as a price list only. No estimated fee is calculated during package pre-alert. Final fees are based on the provider's warehouse weighing, dimensional check, and final quote."
  }
}

Wallet & Payments

V2 supports Square card, saved card, Apple Pay, Google Pay, account balance, and mixed payment. iOS should show Apple Pay only; Android should show Google Pay only.

Refunds

Call refund preview first to check eligibility, amount, and rule. Then submit the refund request.

Mission Go Driver App

Driver APIs cover online state, accepting jobs, arrival confirmation, pickup photo, and delivery confirmation. Direct Pickup and Cargo should require completion of the current job before taking another; Ship Parcel Online is independent and supports continuous jobs.

Status Reference

Error Codes & Messages

V2 currently uses code=0 plus a readable msg for most business errors. Client apps should display msg and log the raw response.

Release Checklist

• Confirm every page uses https://v2-api.missionexpress.ca only.
• Upload api-docs-cn.html, api-docs-en.html, and api-docs-index.html together.
• Confirm the website navigation points API Docs to api-docs-index.html.
• Before public release, grep current server code for public functions and confirm the action names match production.