---
title: "List HTML Mode checkout shipping options"
method: POST
path: "/v3/pages/{page_unique_id}/checkout/shipping-options"
tags: ["HTML Mode Pages"]
---

# List HTML Mode checkout shipping options

`POST /v3/pages/{page_unique_id}/checkout/shipping-options`

Page-scoped public endpoint used by `Scalev.checkout.shippingOptions(payload)`. It accepts HTML Mode `items`, `destination`, and `payment_method`, then resolves the store from the authenticated page.

## Request body

- PagePublicCheckoutShippingOptionsRequest — HTML Mode checkout payload used by `Scalev.checkout.shippingOptions(payload)`. Use one combined `items` list for item selection; the path page and page API key determine the store context.
  - `items` PagePublicCheckoutItem[]
    - `type` 'product' | 'bundle', required
    - `variant_unique_id` string — Required when `type` is `product`.
    - `bundle_price_option_unique_id` string — Required when `type` is `bundle`.
    - `quantity` integer, required
  - `destination` PagePublicCheckoutDestination — Buyer destination submitted by an HTML Mode page.
    - `address` string, nullable
    - `subdistrict_id` union — Destination subdistrict ID.
      - integer
      - string
    - `postal_code` string, nullable
  - `payment_method` string

## Response `200`

HTML Mode checkout shipping options

- StorefrontCheckoutShippingOptionsResponse
  - `data` StorefrontShippingOption[], required
    - `courier_service_id` integer, required
    - `courier_code` string, required
    - `service_code` string, required
    - `name` string, required
    - `cost` union, required
      - string, nullable
      - number
    - `etd` string, nullable, required — Estimated delivery time returned by the courier integration.
    - `is_cod` boolean, required
    - `warehouse_unique_id` string, required
    - `courier_aggregator_code` string, nullable, required
    - `logo_url` string, uri, nullable
  - `is_paginated` false, required

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/4354959d76dc/schema)