title: Shipping Method
description: >-
  Shipping Methods represent a way in which an Order or Return can be shipped.
  Shipping Methods are built from a Shipping Option, but may contain additional
  details, that can be necessary for the Fulfillment Provider to handle the
  shipment.
type: object
required:
  - shipping_option_id
  - price
properties:
  id:
    type: string
    description: The shipping method's ID
    example: sm_01F0YET7DR2E7CYVSDHM593QG2
  shipping_option_id:
    description: The id of the Shipping Option that the Shipping Method is built from.
    type: string
    example: so_01G1G5V27GYX4QXNARRQCW1N8T
  shipping_option:
    description: Available if the relation `shipping_option` is expanded.
    $ref: ./ShippingOption.yaml
  order_id:
    description: The id of the Order that the Shipping Method is used on.
    type: string
    example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
  order:
    description: An order object. Available if the relation `order` is expanded.
    type: object
  return_id:
    description: The id of the Return that the Shipping Method is used on.
    type: string
    example: null
  return_order:
    description: A return object. Available if the relation `return_order` is expanded.
    type: object
  swap_id:
    description: The id of the Swap that the Shipping Method is used on.
    type: string
    example: null
  swap:
    description: A swap object. Available if the relation `swap` is expanded.
    type: object
  cart_id:
    description: The id of the Cart that the Shipping Method is used on.
    type: string
    example: cart_01G8ZH853Y6TFXWPG5EYE81X63
  cart:
    description: A cart object. Available if the relation `cart` is expanded.
    type: object
  claim_order_id:
    description: The id of the Claim that the Shipping Method is used on.
    type: string
    example: null
  claim_order:
    description: A claim order object. Available if the relation `claim_order` is expanded.
    type: object
  tax_lines:
    type: array
    description: Available if the relation `tax_lines` is expanded.
    items:
      $ref: ./ShippingMethodTaxLine.yaml
  price:
    description: >-
      The amount to charge for the Shipping Method. The currency of the price is
      defined by the Region that the Order that the Shipping Method belongs to
      is a part of.
    type: integer
    example: 200
  data:
    description: >-
      Additional data that the Fulfillment Provider needs to fulfill the
      shipment. This is used in combination with the Shipping Options data, and
      may contain information such as a drop point id.
    type: object
    example: {}
  includes_tax:
    description: '[EXPERIMENTAL] Indicates if the shipping method price include tax'
    type: boolean