> ## Documentation Index > Fetch the complete documentation index at: https://docs.scalev.com/llms.txt > Use this file to discover all available pages before exploring further. # List guest checkout shipping options > Public storefront endpoint. Direct `items` use the same typed checkout item union as final public checkout. When direct `items` are omitted, the guest cart referenced by `X-Scalev-Guest-Token` is used as the item source. Digital-only carts return an empty non-paginated collection. ## OpenAPI ````yaml https://api-openapi.scalev.com/specs/v3/openapi.json post /v3/stores/{store_id}/public/checkout/shipping-options openapi: 3.0.3 info: title: Nexus Commerce API version: 3.0.0 description: > Public v3 commerce contract for storefront, customer, and authenticated business commerce flows. This specification intentionally documents only the `/v3` namespace. Store-derived public storefront routes under `/v3/stores/{store_id}/public/*` require `X-Scalev-Storefront-Api-Key`. HTML Mode public page runtime routes under `/v3/pages/{page_unique_id}/*` require `X-Scalev-Page-Api-Key` and do not accept storefront public API keys. Storefront API requests made with `X-Scalev-Storefront-Api-Key`, page runtime requests made with `X-Scalev-Page-Api-Key`, and guest-cart requests made with `X-Scalev-Guest-Token` are browser client requests and use the direct client/IP rate limiter. Machine-authenticated business requests are rate-limited per API key or OAuth installation. Rate-limit metadata is returned in `X-Ratelimit-*` headers, and `429` responses may be plain text. license: name: Proprietary servers: - url: https://api.scalev.com description: Production security: [] tags: - name: Orders description: Authenticated business order management endpoints. - name: Storefront description: >- Public storefront catalog, guest cart, and guest checkout flows. All store-derived public storefront routes require `X-Scalev-Storefront-Api-Key`. - name: HTML Mode Pages description: >- Public HTML Mode runtime endpoints. These routes require `X-Scalev-Page-Api-Key` for the path page and reject storefront public API keys. - name: OAuth description: >- Public and machine OAuth token-management endpoints. The authorization code flow accepts the standard `scope` parameter; public OAuth clients may use PKCE with `token_endpoint_auth_method=none`, and metadata document clients may use `private_key_jwt`. - name: Identity description: Authenticated business identity context. - name: Business Users description: Authenticated business-user membership self-service endpoints. - name: Landing Pages description: >- Authenticated business landing page endpoints. The documented payloads focus on HTML Mode pages. externalDocs: description: >- Read the Landing Pages API guide before creating or publishing HTML Mode pages. url: https://docs.scalev.com/en/landing-pages-api - name: Analytics Setup description: >- Authenticated business analytics provider catalogs and pixel/container endpoints used when configuring landing page displays. - name: OAuth Billing description: OAuth billing runtime, refund, and developer finance endpoints. - name: Customer Auth description: Public customer authentication and password-reset endpoints. - name: Customer Account description: Authenticated customer profile endpoints. - name: Customer Cart description: Authenticated customer cart management endpoints. - name: Customer Checkout description: Authenticated customer checkout preparation and confirmation endpoints. - name: Customer Orders description: Authenticated customer order read endpoints. - name: Customer Subscriptions description: Authenticated customer subscription and subscription-item endpoints. - name: Customer Courses description: Authenticated customer digital course access and progress endpoints. - name: Discounts description: Discount-code validation and authenticated management endpoints. - name: Locations description: Authenticated business location lookup endpoints. - name: Business Stores description: >- Authenticated business store lookup endpoints. These routes use direct numeric Scalev store database IDs. - name: Storefront Setup description: >- Authenticated business setup endpoints for public storefront keys and CORS origins. - name: Shipping description: Authenticated business shipping lookup endpoints. - name: Business Products description: >- Authenticated business product, variant, taxonomy, and course management endpoints. - name: Business Bundles description: >- Authenticated business bundle, bundle-price-option, and related bundle-management endpoints. - name: Business Customers description: Authenticated business customer and customer-address management endpoints. - name: WABA description: >- Authenticated WhatsApp Business Account operations and related WABA resources. - name: WhatsApp Integrations description: Authenticated WhatsApp integration management endpoints. paths: /v3/stores/{store_id}/public/checkout/shipping-options: parameters: - $ref: '#/components/parameters/StoreId' - $ref: '#/components/parameters/StorefrontPublicApiKey' - $ref: '#/components/parameters/StorefrontScalevGuestToken' post: tags: - Storefront summary: List guest checkout shipping options description: > Public storefront endpoint. Direct `items` use the same typed checkout item union as final public checkout. When direct `items` are omitted, the guest cart referenced by `X-Scalev-Guest-Token` is used as the item source. Digital-only carts return an empty non-paginated collection. operationId: listPublicCheckoutShippingOptions requestBody: $ref: >- #/components/requestBodies/StorefrontCheckoutShippingOptionsRequestBody responses: '200': description: Guest checkout shipping options content: application/json: schema: $ref: '#/components/schemas/StorefrontCheckoutShippingOptionsResponse' '400': $ref: '#/components/responses/BadRequestResponse' '404': $ref: '#/components/responses/NotFoundResponse' components: parameters: StoreId: name: store_id in: path required: true schema: type: string description: Store `unique_id`. StorefrontPublicApiKey: name: X-Scalev-Storefront-Api-Key in: header required: true schema: type: string description: >- Publishable storefront public API key for the target store. Page public API keys are not accepted on Storefront public routes. StorefrontScalevGuestToken: name: X-Scalev-Guest-Token in: header required: false schema: type: string format: uuid description: >- Browser-safe guest cart token returned by the first guest-cart response when no token is sent. Send it on later guest-cart and public checkout calls to keep the same cart after reloads. requestBodies: StorefrontCheckoutShippingOptionsRequestBody: required: false content: application/json: schema: $ref: '#/components/schemas/StorefrontCheckoutShippingOptionsRequest' schemas: StorefrontCheckoutShippingOptionsResponse: type: object required: - data - is_paginated properties: data: type: array items: $ref: '#/components/schemas/StorefrontShippingOption' is_paginated: type: boolean enum: - false additionalProperties: false StorefrontCheckoutShippingOptionsRequest: type: object properties: items: type: array description: > Optional direct item source. If supplied, these items are used for the shipping-options calculation. Otherwise the guest cart referenced by `X-Scalev-Guest-Token` is used. minItems: 1 maxItems: 50 items: $ref: '#/components/schemas/StorefrontCheckoutItem' destination: $ref: '#/components/schemas/StorefrontCheckoutDestination' payment_method: type: string example: bank_transfer additionalProperties: true StorefrontShippingOption: type: object required: - courier_service_id - courier_code - service_code - name - cost - etd - is_cod - warehouse_unique_id - courier_aggregator_code properties: courier_service_id: type: integer courier_code: type: string example: jne service_code: type: string example: REG name: type: string example: Regular cost: $ref: '#/components/schemas/StorefrontMoneyValue' etd: type: string nullable: true description: Estimated delivery time returned by the courier integration. is_cod: type: boolean warehouse_unique_id: type: string courier_aggregator_code: type: string nullable: true logo_url: type: string format: uri nullable: true additionalProperties: false ApiErrorResponse: type: object properties: error: $ref: '#/components/schemas/FlexibleValue' error_code: type: string message: type: string description: Error-only human-readable detail. errors: $ref: '#/components/schemas/FlexibleValue' additionalProperties: false StorefrontCheckoutItem: oneOf: - $ref: '#/components/schemas/StorefrontCheckoutVariantItem' - $ref: '#/components/schemas/StorefrontCheckoutBundlePriceOptionItem' discriminator: propertyName: type mapping: variant: $ref: '#/components/schemas/StorefrontCheckoutVariantItem' bundle_price_option: $ref: '#/components/schemas/StorefrontCheckoutBundlePriceOptionItem' StorefrontCheckoutDestination: type: object required: - location_id - postal_code properties: location_id: oneOf: - type: integer - type: string postal_code: type: string additionalProperties: false StorefrontMoneyValue: oneOf: - type: string nullable: true - type: number FlexibleValue: oneOf: - $ref: '#/components/schemas/FlexibleObject' - type: array items: {} - type: string - type: number - type: boolean StorefrontCheckoutVariantItem: type: object required: - type - variant_id - quantity properties: type: type: string enum: - variant variant_id: type: integer minimum: 1 quantity: type: integer minimum: 1 maximum: 100 additionalProperties: false StorefrontCheckoutBundlePriceOptionItem: type: object required: - type - bundle_price_option_id - quantity properties: type: type: string enum: - bundle_price_option bundle_price_option_id: type: integer minimum: 1 description: Bundle price option ID from the storefront catalog. quantity: type: integer minimum: 1 maximum: 100 additionalProperties: false FlexibleObject: type: object additionalProperties: true responses: BadRequestResponse: description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' NotFoundResponse: description: Not Found content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' ````