**Version: 202601**

# Get available shipping lines

**POST** `/openapi/2026-01/shipping-lines/available-lines`

Retrieves available shipping options for the specified order and address.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `order_id` string (required)

  Order ID
- `country_code` string (required)

  Country code
- `province_code` string

  Province/state code. Pass `ALL` to match all provinces (default behavior for most countries).

  **GB (United Kingdom) special handling:** Because shipping costs vary significantly across England (GB-ENG), Scotland (GB-SCT), Wales (GB-WLS), and Northern Ireland (GB-NIR), an empty value will not match any shipping zone. You must either:

  *   Pass a specific province code (e.g. `GB-ENG`), or
  *   Pass `ALL`, or
  *   Provide `zip` instead — the system will automatically derive the province from the postal code prefix
- `zip` string

  Zip/postal code. For GB addresses, the system uses the postal code prefix to automatically derive the province code when `province_code` is not provided.

```json
{
  "order_id": "string",
  "country_code": "string",
  "province_code": "string",
  "zip": "string"
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `shipping_lines` object[]

    List of available shipping lines

    *   Array \[

    - `delivery_method` int32

      Delivery method type (1: express delivery, 2: local delivery)
    - `desc` string

      Description of the shipping line
    - `id` string

      Shipping line ID
    - `location_id` string

      Location identifier
    - `name` string

      Name of the shipping line
    - `plan_code` string

      Plan code
    - `shipping_price` string

      Shipping price (as string to preserve precision)
    - `support_cod` int32

      Whether cash on delivery is supported (0 or 1)
    *   \]
  - `invalid_products` string[]

    List of invalid product identifiers
  - `message` string

    Reason for third-party billing failure
  - `state` string

    Business state code: success (successful), empty\_plan (no matching plan for country/province), empty\_shipping\_plan (matching conditions not met), invalid\_product (product removed)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "shipping_lines": [
      {
        "delivery_method": 0,
        "desc": "string",
        "id": "string",
        "location_id": "string",
        "name": "string",
        "plan_code": "string",
        "shipping_price": "string",
        "support_cod": 0
      }
    ],
    "invalid_products": [
      "string"
    ],
    "message": "string",
    "state": "string"
  }
}
```