API ReferenceService tiersList service tiers the account can use

List service tiers the account can use

GET/api/v1/service_tiers

Entitlement-scoped (2026-06-10): returns only the Service Codes the calling account can book — resolved from BOTH entitlement tracks (Product Code entitlements and assigned rate cards) — and that have a carrier assignment (fulfillable), the same rule the quote engine applies. No entitlements yet → 200 with an empty list (ask your account manager to assign a Product Code). Each tier carries the pricing-model v2 fields: product_code (the Merdi product container / entitlement unit, e.g. HKASTD — null on legacy tiers, and NOT the same thing as carrier.product_code, which is the upstream carrier's own reference), is_standard_service, and service_options (the cargo / air / last-mile dimensions).

Parameters

dispatch_mode

stringquery

Filter by carrier dispatch mode.

Responses

Success body

{
  "status": 200,
  "message": "OK",
  "data": [
    {
      "id": "HKASTDGGSTCM",
      "name": {
        "en": "香港發貨公開價標準服務",
        "zh_hk": "香港發貨公開價標準服務"
      },
      "product_code": "HKASTD",
      "is_standard_service": true,
      "service_options": [
        {
          "layer_key": "cargo_type",
          "option_code": "GG",
          "label_zh": "普貨（帶電）",
          "is_vas": false
        },
        {
          "layer_key": "air_service",
          "option_code": "ST",
          "label_zh": "標準",
          "is_vas": false
        },
        {
          "layer_key": "tail_service",
          "option_code": "CM",
          "label_zh": "綜合",
          "is_vas": false
        }
      ],
      "origin_countries": [
        "HK"
      ],
      "destination_countries": [
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "IE",
        "IT",
        "NL",
        "US"
      ],
      "eta_days_min": 8,
      "eta_days_max": 12,
      "delivery_mode": "resell",
      "status": "Active",
      "carrier": {
        "code": "yunexpress",
        "product_code": "HKTHZXR",
        "dispatch_mode": "B2C"
      }
    }
  ]
}

Returned object

Field	Type	Sample
status	number	200
message	string	OK
data	array	1 item