labels

Purchase label with shipping rule

Changed on
<aside class="access" aria-label="Endpoint access"> <table class="access__table"> <thead> <tr> <th class="access__table-header">Products</th> <th class="access__table-header">Plans</th> </tr> </thead> <tbody> <tr> <td class="access__table-cell access__product"> <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/> <div class="access__sub">Formerly ShipEngine</div> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a> </td> </tr> <tr> <td class="access__table-cell"> <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan access__plan--off">Standard</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan access__plan--off">Premium</a> </td> </tr> </tbody> </table> <footer class="access__footer"> <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md"> Learn about products and plans <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/> </a> </footer> </aside>

Purchase and print a shipping label using a Shipping Rule. The Shipping Rule automatically selects the optimal carrier and service based on the rule's configuration.

Dynamic Ordering: Service Group Rules can now use dynamic ordering (Cheapest or Fastest) to automatically rank eligible services in real time based on live rate or transit data. This feature is currently available for US sellers with USA domestic carrier services only. For more details, see the Configuring "Order Services By" guide.

The request body must NOT include carrier_id, service_code, or shipping_rule_id in the shipment object. If any of these fields are provided, the API will return a 400 Bad Request error.

Important: While calls to this endpoint from ShipStation native accounts will not fail with a 401 Unauthorized or 402 Payment Required error, Shipping Rules are not available to ShipStation accounts, preventing successful use of this endpoint. This endpoint may only be used by ShipStation API (formerly ShipEngine) accounts.

post/v2/labels/shipping_rules/{shipping_rule_id}

Request

  • Base URL
    https://api.shipstation.com
  • URL
    https://api.shipstation.com/v2/labels/shipping_rules/{shipping_rule_id}
  • Auth
    API key in header api-key

Request body

label_format'pdf' | 'png' | 'zpl'

The possible file formats in which shipping labels can be downloaded. We recommend pdf format because it is supported by all carriers, whereas some carriers do not support the png or zpl formats.

Label FormatSupported Carriers
pdfAll carriers
pngfedex <br> stamps_com <br> ups <br> usps
zplaccess_worldwide <br> apc <br> asendia <br> dhl_global_mail <br> dhl_express <br> dhl_express_australia <br> dhl_express_canada <br> dhl_express_worldwide <br> dhl_express_uk <br> dpd <br> endicia <br> fedex <br> fedex_uk <br> firstmile <br> imex <br> newgistics <br> ontrac <br> stamps_com <br> ups <br> usps
label_layout'4x6' | 'letter'

The available layouts (sizes) in which shipping labels can be downloaded. The label format determines which sizes are supported. 4x6 is supported for all label formats, whereas letter (8.5" x 11") is only supported for pdf format.

display_scheme'label' | 'paperless' | 'label_and_paperless'

The display format that the label should be shown in.

label_download_type'url' | 'inline'

Specifies how the label should be downloaded.

  • url: Returns URLs to download the label
  • inline: Returns the label data inline in the response

Example request

{
  "shipment": {
    "requested_shipment_service": "usps_priority_mail",
    "external_order_id": "1232434",
    "hold_until_date": "2025-01-15T00:00:00.000Z",
    "ship_by_date": "2025-01-15T00:00:00.000Z",
    "deliver_by_date": "2025-01-20T00:00:00.000Z",
    "retail_rate": {
      "amount": 12
    },
    "store_id": "se-28529731",
    "items": [
      {
        "name": "box",
        "sales_order_id": "8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c",
        "sales_order_item_id": "2e7b9c4d-6a1f-4c3e-8b5d-9f0a1b2c3d4e",
        "quantity": 1,
        "sku": "sku-1234",
        "bundle_sku": "bundle-123",
        "external_order_id": "123445",
        "external_order_item_id": "12",
        "asin": "B00005N5PF",
        "item_id": "1402291169813",
        "allocation_status": "allocated",
        "image_url": "https://example.com/image.jpg",
        "weight": {
          "value": 23
        },
        "unit_price": 88,
        "tax_amount": 5.5,
        "shipping_amount": 10,
        "inventory_location": "warehouse-a",
        "options": [
          {
            "name": "Color",
            "value": "Red"
          }
        ],
        "product_id": "10408926",
        "fullfilment_sku": "fulfill-123",
        "upc": "123456789012"
      }
    ],
    "notes_from_buyer": "Please handle with care",
    "notes_to_buyer": "Thank you for your order!",
    "notes_for_gift": "Happy Birthday!",
    "internal_notes": "Check packaging before shipping",
    "is_gift": true,
    "assigned_user": "user@example.com",
    "amount_paid": {
      "amount": 12
    },
    "shipping_paid": {
      "amount": 12
    },
    "tax_paid": {
      "amount": 12
    },
    "zone": 1,
    "display_scheme": "label",
    "tax_identifiers": [
      {
        "issuing_authority": "US",
        "value": "value"
      }
    ],
    "external_shipment_id": "1234556",
    "shipment_number": "10001",
    "ship_date": "2018-09-23T00:00:00Z",
    "ship_to": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instruction",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "ship_from": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instructions",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "warehouse_id": "se-28529731",
    "return_to": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instructions",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "is_return": true,
    "customs": {
      "terms_of_trade_code": "ddp",
      "contents": "gift",
      "non_delivery": "return_to_sender"
    },
    "advanced_options": {
      "bill_to_account": "123456789",
      "bill_to_country_code": "CA",
      "bill_to_postal_code": "28005",
      "contains_alcohol": true,
      "delivered_duty_paid": true,
      "dry_ice": true,
      "dry_ice_weight": {
        "value": 23
      },
      "non_machinable": true,
      "saturday_delivery": true,
      "fedex_freight": {
        "shipper_load_and_count": "shipper_load_and_count",
        "booking_confirmation": "today"
      },
      "use_ups_ground_freight_pricing": true,
      "freight_class": "77.5",
      "custom_field1": "custom field 1",
      "custom_field2": "custom field 2",
      "custom_field3": "custom field 3",
      "additional_handling": true,
      "shipper_release": true,
      "collect_on_delivery": {
        "payment_amount": {
          "amount": 12
        }
      },
      "third_party_consignee": true,
      "dangerous_goods": true,
      "dangerous_goods_contact": {
        "name": "Michael Robinson",
        "phone": "123456578789"
      },
      "movement_indicator": "b2b",
      "windsor_framework_details": {
        "movement_indicator": "b2b",
        "not_at_risk": true
      },
      "ancillary_endorsements_option": "forward",
      "return_pickup_attempts": 3,
      "netstamps_options": {
        "row": 1,
        "column": 1
      },
      "suppress_carrier_generated_documents": [
        "commercial_invoice"
      ],
      "transparency_codes": [
        {
          "order_item_id": "12345678901234",
          "codes": [
            "AZ:XXXXXXXXXXXX"
          ]
        }
      ]
    },
    "tags": [
      {
        "name": "Fragile"
      }
    ],
    "packages": [
      {
        "shipment_package_id": "se-28529731",
        "package_id": "se-28529731",
        "package_code": "small_flat_rate_box",
        "package_name": "Flat Rate Envelope",
        "weight": {
          "value": 23
        },
        "dimensions": {
          "length": 2,
          "width": 2,
          "height": 1
        },
        "insured_value": {
          "amount": 12
        },
        "label_messages": {
          "reference1": "Reference",
          "reference2": "Reference 2",
          "reference3": "Reference 3"
        },
        "external_package_id": "se-1234545",
        "content_description": "Hand knitted wool socks",
        "products": [
          {
            "description": "a minimum description",
            "quantity": 1,
            "value": {
              "amount": 12
            },
            "weight": {
              "value": 23
            },
            "harmonized_tariff_code": "3926.10",
            "country_of_origin": "CA",
            "unit_of_measure": "pound",
            "sku": "sku-1223344",
            "sku_description": "this is a description",
            "mid_code": "GBCOM15BRI",
            "product_url": "https://myproduct.com",
            "vat_rate": 0.2,
            "dangerous_goods": [
              {
                "id_number": "1234r1",
                "shipping_name": "things with dangerous goods",
                "technical_name": "chloric acid",
                "product_class": "1987",
                "product_class_subsidiary": "1987",
                "packaging_group": "ii",
                "dangerous_amount": {
                  "amount": 12,
                  "unit": "GBP"
                },
                "quantity": 1,
                "packaging_instruction": "Packaging materials and containers that are in contact with food products must comply with the provisions established by Regulation ",
                "packaging_instruction_section": "section_1",
                "packaging_type": "X",
                "transport_mean": "ground",
                "transport_category": "6.1",
                "regulation_authority": "AEAT",
                "regulation_level": "excepted_quantity",
                "tunnel_code": "all",
                "additional_description": "any description"
              }
            ],
            "manufacturer_product_id": "012345678905",
            "manufacturer_ns_product_id": "MY-SKU-12345",
            "cpsc_certificates": [
              {
                "certifier_id": "CERT-12345",
                "certificate_version_id": "v1.0"
              }
            ],
            "cpsc_disclaim": {
              "disclaim_code": "B",
              "intended_use_code": "130.006"
            }
          }
        ]
      }
    ],
    "comparison_rate_type": "retail"
  },
  "label_download_type": "url"
}

Response

The requested object creation was a success.

label_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

status'processing' | 'completed' | 'error' | 'voided'

The possible statuses that a [shipping label] can be in.

StatusDescription
processingWhen labels are created in a [batch], it may take a few minutes for all of the labels in the batch to be created. During this period, they will be in processing status.
completedThe label was successfully created
errorThe label could not be created due to an error, such as an invalid delivery address
voidedThe label has been [voided]
shipment_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

external_shipment_idstring nullable

A unique user-defined key to identify a shipment. This can be used to retrieve the shipment.

Warning: The external_shipment_id is limited to 50 characters. Any additional characters will be truncated.

external_order_idstring nullable

ID that the Order Source assigned

ship_datestring date-time

An ISO 8601 string that represents a date, but not a specific time. The value may contain a time component, but it will be set to 00:00:00 UTC by ShipStation .

created_atstring date-time

An ISO 8601 string that represents a date and time.

tracking_numberstring

The tracking number for the package. Tracking number formats vary across carriers.

is_return_labelboolean

Indicates whether this is a return label. You may also want to set the rma_number so you know what is being returned.

rma_numberstring nullable

An optional Return Merchandise Authorization number. This field is useful for return labels. You can set it to any string value.

is_internationalboolean

Indicates whether this is an international shipment. That is, the originating country and destination country are different.

batch_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

carrier_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

charge_event'carrier_default' | 'on_creation' | 'on_carrier_acceptance'

Determines when the user's account will be charged for the label.

outbound_label_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

service_codestring

A [carrier service], such as fedex_ground, usps_first_class_mail, flat_rate_envelope, etc.

test_labelboolean

Indicate if this label is being used only for testing purposes. If true, then no charge will be added to your account.

package_codestring

A [package type] , such as thick_envelope, small_flat_rate_box, large_package, etc. Use the code package for custom or unknown package types.

validate_address'no_validation' | 'validate_only' | 'validate_and_clean'

The possible validate address values

voidedboolean

Indicates whether the label has been [voided]

voided_atstring date-time

An ISO 8601 string that represents a date and time.

void_type'refund_assist' | 'manual'

Indicates how a label was voided. refund_assist means the label was voided through the Refund Assist program, while manual means it was voided manually by the user.

label_download_type'url' | 'inline'

There are two different ways to [download a label]:

Label Download TypeDescription
urlYou will receive a URL, which you can use to download the label in a separate request. The URL will remain valid for 90 days.<br><br>This is the default if label_download_type is unspecified.
inlineYou will receive the Base64-encoded label as part of the response. No need for a second request to download the label.
label_format'pdf' | 'png' | 'zpl'

The possible file formats in which shipping labels can be downloaded. We recommend pdf format because it is supported by all carriers, whereas some carriers do not support the png or zpl formats.

Label FormatSupported Carriers
pdfAll carriers
pngfedex <br> stamps_com <br> ups <br> usps
zplaccess_worldwide <br> apc <br> asendia <br> dhl_global_mail <br> dhl_express <br> dhl_express_australia <br> dhl_express_canada <br> dhl_express_worldwide <br> dhl_express_uk <br> dpd <br> endicia <br> fedex <br> fedex_uk <br> firstmile <br> imex <br> newgistics <br> ontrac <br> stamps_com <br> ups <br> usps
display_scheme'label' | 'paperless' | 'label_and_paperless'

The display format that the label should be shown in.

label_layout'4x6' | 'letter'

The available layouts (sizes) in which shipping labels can be downloaded. The label format determines which sizes are supported. 4x6 is supported for all label formats, whereas letter (8.5" x 11") is only supported for pdf format.

trackableboolean

Indicates whether the shipment is trackable, in which case the tracking_status field will reflect the current status and each package will have a tracking_number.

label_image_idstring

Used to identify an image resource.

carrier_codestring

A [shipping carrier] , such as fedex, dhl_express, stamps_com, etc.

confirmation'none' | 'delivery' | 'signature' | 'adult_signature' | 'adult_signature_restricted_delivery' | 'direct_signature' | 'delivery_mailed' | 'verbal_confirmation' | 'delivery_code' | 'age_verification_16_plus'

The possible delivery confirmation values

tracking_status'unknown' | 'in_transit' | 'error' | 'delivered'

The different statuses that can apply to a shipment.

tracking_urlstring nullable

The URL to track the package. This URL is provided by the carrier and is unique to the tracking number.

Example response

{
  "label_id": "se-28529731",
  "shipment_id": "se-28529731",
  "external_shipment_id": "externalId-1234556",
  "external_order_id": "externalOrderId-1232434",
  "shipment": {
    "shipment_id": "se-28529731",
    "carrier_id": "se-28529731",
    "service_code": "usps_first_class_mail",
    "requested_shipment_service": "usps_priority_mail",
    "external_order_id": "1232434",
    "hold_until_date": "2025-01-15T00:00:00.000Z",
    "ship_by_date": "2025-01-15T00:00:00.000Z",
    "deliver_by_date": "2025-01-20T00:00:00.000Z",
    "retail_rate": {
      "amount": 12
    },
    "store_id": "se-28529731",
    "items": [
      {
        "name": "box",
        "sales_order_id": "8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c",
        "sales_order_item_id": "2e7b9c4d-6a1f-4c3e-8b5d-9f0a1b2c3d4e",
        "quantity": 1,
        "sku": "sku-1234",
        "bundle_sku": "bundle-123",
        "external_order_id": "123445",
        "external_order_item_id": "12",
        "asin": "B00005N5PF",
        "item_id": "1402291169813",
        "allocation_status": "allocated",
        "image_url": "https://example.com/image.jpg",
        "weight": {
          "value": 23
        },
        "unit_price": 88,
        "tax_amount": 5.5,
        "shipping_amount": 10,
        "inventory_location": "warehouse-a",
        "options": [
          {
            "name": "Color",
            "value": "Red"
          }
        ],
        "product_id": "10408926",
        "fullfilment_sku": "fulfill-123",
        "upc": "123456789012"
      }
    ],
    "notes_from_buyer": "Please handle with care",
    "notes_to_buyer": "Thank you for your order!",
    "notes_for_gift": "Happy Birthday!",
    "internal_notes": "Check packaging before shipping",
    "is_gift": true,
    "assigned_user": "user@example.com",
    "amount_paid": {
      "amount": 12
    },
    "shipping_paid": {
      "amount": 12
    },
    "tax_paid": {
      "amount": 12
    },
    "zone": 1,
    "display_scheme": "label",
    "tax_identifiers": [
      {
        "issuing_authority": "US",
        "value": "value"
      }
    ],
    "external_shipment_id": "1234556",
    "shipment_number": "10001",
    "ship_date": "2018-09-23T00:00:00Z",
    "created_at": "2018-09-23T15:00:00.000Z",
    "modified_at": "2018-09-23T15:00:00.000Z",
    "ship_to": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instruction",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "ship_from": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instructions",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "warehouse_id": "se-28529731",
    "return_to": {
      "name": "John Doe",
      "phone": "+1 204-253-9411 ext. 123",
      "email": "example@example.com",
      "company_name": "The Home Depot",
      "address_line1": "1999 Bishop Grandin Blvd.",
      "address_line2": "Unit 408",
      "address_line3": "Building #7",
      "city_locality": "Winnipeg",
      "state_province": "Manitoba",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "instructions": "any instructions",
      "geolocation": [
        {
          "type": "what3words",
          "value": "cats.with.thumbs"
        }
      ]
    },
    "is_return": true,
    "customs": {
      "terms_of_trade_code": "ddp",
      "contents": "gift",
      "non_delivery": "return_to_sender"
    },
    "advanced_options": {
      "bill_to_account": "123456789",
      "bill_to_country_code": "CA",
      "bill_to_postal_code": "28005",
      "contains_alcohol": true,
      "delivered_duty_paid": true,
      "dry_ice": true,
      "dry_ice_weight": {
        "value": 23
      },
      "non_machinable": true,
      "saturday_delivery": true,
      "fedex_freight": {
        "shipper_load_and_count": "shipper_load_and_count",
        "booking_confirmation": "today"
      },
      "use_ups_ground_freight_pricing": true,
      "freight_class": "77.5",
      "custom_field1": "custom field 1",
      "custom_field2": "custom field 2",
      "custom_field3": "custom field 3",
      "additional_handling": true,
      "shipper_release": true,
      "collect_on_delivery": {
        "payment_amount": {
          "amount": 12
        }
      },
      "third_party_consignee": true,
      "dangerous_goods": true,
      "dangerous_goods_contact": {
        "name": "Michael Robinson",
        "phone": "123456578789"
      },
      "movement_indicator": "b2b",
      "windsor_framework_details": {
        "movement_indicator": "b2b",
        "not_at_risk": true
      },
      "ancillary_endorsements_option": "forward",
      "return_pickup_attempts": 3,
      "netstamps_options": {
        "row": 1,
        "column": 1
      },
      "suppress_carrier_generated_documents": [
        "commercial_invoice"
      ],
      "transparency_codes": [
        {
          "order_item_id": "12345678901234",
          "codes": [
            "AZ:XXXXXXXXXXXX"
          ]
        }
      ]
    },
    "tags": [
      {
        "name": "Fragile"
      }
    ],
    "packages": [
      {
        "shipment_package_id": "se-28529731",
        "package_id": "se-28529731",
        "package_code": "small_flat_rate_box",
        "package_name": "Flat Rate Envelope",
        "weight": {
          "value": 23
        },
        "dimensions": {
          "length": 2,
          "width": 2,
          "height": 1
        },
        "insured_value": {
          "amount": 12
        },
        "label_messages": {
          "reference1": "Reference",
          "reference2": "Reference 2",
          "reference3": "Reference 3"
        },
        "external_package_id": "se-1234545",
        "content_description": "Hand knitted wool socks",
        "products": [
          {
            "description": "a minimum description",
            "quantity": 1,
            "value": {
              "amount": 12
            },
            "weight": {
              "value": 23
            },
            "harmonized_tariff_code": "3926.10",
            "country_of_origin": "CA",
            "unit_of_measure": "pound",
            "sku": "sku-1223344",
            "sku_description": "this is a description",
            "mid_code": "GBCOM15BRI",
            "product_url": "https://myproduct.com",
            "vat_rate": 0.2,
            "dangerous_goods": [
              {
                "id_number": "1234r1",
                "shipping_name": "things with dangerous goods",
                "technical_name": "chloric acid",
                "product_class": "1987",
                "product_class_subsidiary": "1987",
                "packaging_group": "ii",
                "dangerous_amount": {
                  "amount": 12,
                  "unit": "GBP"
                },
                "quantity": 1,
                "packaging_instruction": "Packaging materials and containers that are in contact with food products must comply with the provisions established by Regulation ",
                "packaging_instruction_section": "section_1",
                "packaging_type": "X",
                "transport_mean": "ground",
                "transport_category": "6.1",
                "regulation_authority": "AEAT",
                "regulation_level": "excepted_quantity",
                "tunnel_code": "all",
                "additional_description": "any description"
              }
            ],
            "manufacturer_product_id": "012345678905",
            "manufacturer_ns_product_id": "MY-SKU-12345",
            "cpsc_certificates": [
              {
                "certifier_id": "CERT-12345",
                "certificate_version_id": "v1.0"
              }
            ],
            "cpsc_disclaim": {
              "disclaim_code": "B",
              "intended_use_code": "130.006"
            }
          }
        ]
      }
    ],
    "total_weight": {
      "value": 3
    },
    "batch_ids": [
      "se-9581628",
      "se-1935182"
    ],
    "comparison_rate_type": "retail",
    "sales_order_ids": [
      "8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c"
    ]
  },
  "ship_date": "2018-09-23T00:00:00Z",
  "delivery_prediction": {
    "delivery_date": "2026-07-04",
    "confidence_level": "high"
  },
  "created_at": "2018-09-23T15:00:00.000Z",
  "shipment_cost": {
    "amount": 12
  },
  "insurance_cost": {
    "amount": 12
  },
  "requested_comparison_amount": {
    "amount": 12
  },
  "tracking_number": "782758401696",
  "is_return_label": true,
  "rma_number": "asd12323",
  "is_international": true,
  "batch_id": "se-28529731",
  "carrier_id": "se-28529731",
  "outbound_label_id": "se-28529731",
  "service_code": "usps_first_class_mail",
  "test_label": true,
  "package_code": "small_flat_rate_box",
  "voided": true,
  "voided_at": "2018-09-23T15:00:00.000Z",
  "refund_details": {
    "refund_status": "request_scheduled",
    "request_date": "2018-09-23T15:00:00.000Z",
    "amount_paid": {
      "amount": 12
    },
    "amount_requested": {
      "amount": 12
    },
    "amount_approved": {
      "amount": 12
    },
    "amount_credited": {
      "amount": 12
    }
  },
  "trackable": true,
  "label_image_id": "img_DtBXupDBxREpHnwEXhTfgK",
  "carrier_code": "dhl_express",
  "label_download": {
    "href": "https://example.com/resource",
    "pdf": "https://example.com/resource",
    "png": "https://example.com/resource",
    "zpl": "https://example.com/resource"
  },
  "form_download": {
    "href": "https://example.com/resource",
    "type": "child"
  },
  "qr_code_download": {
    "href": "https://example.com/resource",
    "type": "child"
  },
  "paperless_download": {
    "href": "https://example.com/resource",
    "instructions": "any instructions",
    "handoff_code": "122334"
  },
  "insurance_claim": {
    "href": "https://example.com/resource",
    "type": "child"
  },
  "packages": [
    {
      "package_id": 1234545,
      "package_code": "small_flat_rate_box",
      "weight": {
        "value": 23
      },
      "dimensions": {
        "length": 2,
        "width": 2,
        "height": 1
      },
      "insured_value": {
        "amount": 12
      },
      "tracking_number": "1Z932R800392060079",
      "label_download": {
        "href": "https://example.com/resource",
        "pdf": "https://example.com/resource",
        "png": "https://example.com/resource",
        "zpl": "https://example.com/resource"
      },
      "form_download": {
        "href": "https://example.com/resource",
        "type": "child"
      },
      "qr_code_download": {
        "href": "https://example.com/resource",
        "type": "child"
      },
      "paperless_download": {
        "href": "https://example.com/resource",
        "instructions": "any instructions",
        "handoff_code": "122334"
      },
      "label_messages": {
        "reference1": "Reference",
        "reference2": "Reference 2",
        "reference3": "Reference 3"
      },
      "external_package_id": "se-1234567",
      "content_description": "Hand knitted wool socks",
      "sequence": 34,
      "has_label_documents": true,
      "has_form_documents": true,
      "has_qr_code_documents": true,
      "has_paperless_label_documents": true,
      "alternative_identifiers": [
        {
          "type": "last_mile_tracking_number",
          "value": "12345678912345678912"
        }
      ]
    }
  ],
  "alternative_identifiers": [
    {
      "type": "last_mile_tracking_number",
      "value": "12345678912345678912"
    }
  ],
  "rate_details": [
    {
      "rate_detail_type": "shipping",
      "carrier_description": "Shipping",
      "carrier_billing_code": "BaseServiceCharge",
      "amount": {
        "amount": 12
      },
      "billing_source": "carrier"
    }
  ],
  "tracking_url": "https://www.fedex.com/fedextrack/?action=track&trackingnumber=1234",
  "ship_to": {
    "name": "John Doe",
    "phone": "+1 204-253-9411 ext. 123",
    "email": "example@example.com",
    "company_name": "The Home Depot",
    "address_line1": "1999 Bishop Grandin Blvd.",
    "address_line2": "Unit 408",
    "address_line3": "Building #7",
    "city_locality": "Winnipeg",
    "state_province": "Manitoba",
    "postal_code": "78756-3717",
    "country_code": "CA",
    "instructions": "any instruction",
    "geolocation": [
      {
        "type": "what3words",
        "value": "cats.with.thumbs"
      }
    ]
  }
}

Changes

  • 4e29670aa28dRevision changes
    • warning

      added the new bring_your_own_label_not_supported enum value to the // response property for the response status

    • warning

      added the new bring_your_own_label_not_supported enum value to the // response property for the response status

    • warning

      added the new multiple_sales_orders enum value to the // response property for the response status

    • warning

      added the new multiple_sales_orders enum value to the // response property for the response status

    • warning

      added the new sales_order_link_required enum value to the // response property for the response status

    • warning

      added the new sales_order_link_required enum value to the // response property for the response status

    • info

      added subschema #2: shipment_sales_order_fields to the // response property allOf list for the response status

  • bf3618aaf7e1Revision changes
    • breaking

      the ////// request property type changed from string to no type

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property ///////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property //////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property ////////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property //////// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      added subschema #2 to the ////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the ////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the //////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the ////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the ////// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      added subschema #2 to the ////// response property oneOf list for the response status

    • breaking

      the //////// response's property type changed from string to no type for status

    • warning

      removed from the //// request property allOf list

    • warning

      removed from the //// request property allOf list

    • warning

      removed from the ////// request property allOf list

    • warning

      removed from the // request property allOf list

    • warning

      removed from the // request property allOf list

    • warning

      removed from the ////// request property allOf list

    • warning

      removed from the // request property allOf list

    • warning

      removed from the //// request property allOf list

    • warning

      removed from the //// request property allOf list

    • warning

      removed from the // request property allOf list

    • warning

      removed from the //// request property allOf list

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property //// became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property //// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property /////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property ////////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property //////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property // became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property // became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ////// became nullable

    • info

      the request property ///// became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      added subschema #2 to the //// request property oneOf list

    • info

      added subschema #2 to the //// request property oneOf list

    • info

      added subschema #2 to the ////// request property oneOf list

    • info

      added subschema #2 to the // request property oneOf list

    • info

      added subschema #2 to the // request property oneOf list

    • info

      added subschema #2 to the ////// request property oneOf list

    • info

      added subschema #2 to the // request property oneOf list

    • info

      added subschema #2 to the //// request property oneOf list

    • info

      added subschema #2 to the //// request property oneOf list

    • info

      added subschema #2 to the // request property oneOf list

    • info

      added subschema #2 to the //// request property oneOf list

    • info

      removed from the ////// response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status

    • info

      removed from the //////// response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the //////// response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the //// response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status