# ShipStation

> Manage ShipStation v2 shipments, labels, carrier services, warehouses, rates and tags.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/shipstation

## Actions

### Create label

Purchase a label for an existing shipment. Select a shipment created by an earlier step; carrier charges may apply.

**Inputs**

- Shipment (`shipment_id`, text, required): An existing ShipStation shipment. Creating this label can charge your carrier account.
- Validate address (`validate_address`, text): The possible validate address values. One of: `no_validation`, `validate_only`, `validate_and_clean`.
- Label layout (`label_layout`, text): 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. One of: `4x6`, `letter`.
- Label format (`label_format`, text): 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 Format | Supported Carriers |--------------|----------------------------------- |`pdf` | All carriers |`png` | `fedex` <br> `stamps_com` <br> `ups` <br> `usps` |`zpl` | `access_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`. One of: `pdf`, `png`, `zpl`.
- Label download type (`label_download_type`, text): There are two different ways to [download a label]: |Label Download Type | Description |--------------------|------------------------------ |`url` |You 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. |`inline` |You will receive the Base64-encoded label as part of the response. No need for a second request to download the label. One of: `url`, `inline`.
- Display scheme (`display_scheme`, text): The display format that the label should be shown in. One of: `label`, `paperless`, `label_and_paperless`.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "alternative_identifiers": [],
    "batch_id": "",
    "carrier_code": "",
    "carrier_id": "",
    "charge_event": "carrier_default",
    "confirmation": "none",
    "created_at": "",
    "delivery_prediction": {
      "confidence_level": "high",
      "delivery_date": ""
    },
    "display_scheme": "label",
    "external_order_id": "",
    "external_shipment_id": "",
    "form_download": {
      "href": "",
      "type": ""
    },
    "insurance_claim": {
      "href": "",
      "type": ""
    },
    "insurance_cost": {
      "amount": 0,
      "currency": ""
    },
    "is_international": false,
    "is_return_label": false,
    "label_download": {
      "href": "",
      "pdf": "",
      "png": "",
      "zpl": ""
    },
    "label_download_type": "url",
    "label_format": "pdf",
    "label_id": "",
    "label_image_id": "",
    "label_layout": "4x6",
    "outbound_label_id": "",
    "package_code": "",
    "packages": [],
    "paperless_download": {
      "handoff_code": "",
      "href": "",
      "instructions": ""
    },
    "qr_code_download": {
      "href": "",
      "type": ""
    },
    "rate_details": [],
    "refund_details": {
      "amount_approved": {},
      "amount_credited": {},
      "amount_paid": {},
      "amount_requested": {},
      "refund_status": "request_scheduled",
      "request_date": ""
    },
    "requested_comparison_amount": {
      "amount": 0,
      "currency": ""
    },
    "rma_number": "",
    "service_code": "",
    "ship_date": "",
    "ship_to": {
      "geolocation": [],
      "instructions": ""
    },
    "shipment": {
      "advanced_options": {},
      "amount_paid": {},
      "assigned_user": "",
      "batch_ids": [],
      "carrier_id": "",
      "comparison_rate_type": "",
      "confirmation": "none",
      "created_at": "",
      "customs": {},
      "deliver_by_date": "",
      "display_scheme": "",
      "external_order_id": "",
      "external_shipment_id": "",
      "hold_until_date": "",
      "insurance_provider": "none",
      "internal_notes": "",
      "is_gift": false,
      "is_return": false,
      "items": [],
      "modified_at": "",
      "notes_for_gift": "",
      "notes_from_buyer": "",
      "notes_to_buyer": "",
      "order_source_code": "amazon_ca",
      "packages": [],
      "requested_shipment_service": "",
      "retail_rate": {},
      "return_to": {},
      "sales_order_ids": [],
      "service_code": "",
      "ship_by_date": "",
      "ship_date": "",
      "ship_from": {},
      "ship_to": {},
      "shipment_id": "",
      "shipment_number": "",
      "shipment_status": "pending",
      "shipping_paid": {},
      "store_id": "",
      "tags": [],
      "tax_identifiers": [],
      "tax_paid": {},
      "total_weight": {},
      "warehouse_id": "",
      "zone": 0
    },
    "shipment_cost": {
      "amount": 0,
      "currency": ""
    },
    "shipment_id": "",
    "status": "processing",
    "test_label": false,
    "trackable": false,
    "tracking_number": "",
    "tracking_status": "unknown",
    "tracking_url": "",
    "validate_address": "no_validation",
    "void_type": "refund_assist",
    "voided": false,
    "voided_at": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create shipments

Create shipments.

**Inputs**

- Shipments (`shipments`, list, required): Array of shipments to create

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "has_errors": false,
    "shipments": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create tag

Create tag.

**Inputs**

- Name (`name`, text, required): The tag name.
- Color (`color`, text): A hex-coded string identifying the color of the tag.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "name": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create warehouse

Create warehouse.

**Inputs**

- Is default (`is_default`, true/false): Designates which single warehouse is the default on the account
- Name (`name`, text, required): Name of the warehouse
- Origin address (`origin_address`, object, required): A complete or partial mailing address.
- Return address (`return_address`, object): A complete or partial mailing address.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "created_at": "",
    "is_default": false,
    "name": "",
    "origin_address": {
      "address_line1": "",
      "address_line2": "",
      "address_line3": "",
      "address_residential_indicator": "unknown",
      "city_locality": "",
      "company_name": "",
      "country_code": "",
      "email": "",
      "name": "",
      "phone": "",
      "postal_code": "",
      "state_province": ""
    },
    "return_address": {
      "address_line1": "",
      "address_line2": "",
      "address_line3": "",
      "address_residential_indicator": "unknown",
      "city_locality": "",
      "company_name": "",
      "country_code": "",
      "email": "",
      "name": "",
      "phone": "",
      "postal_code": "",
      "state_province": ""
    },
    "warehouse_id": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Delete tag

Delete tag.

**Inputs**

- Tag name (`tag_name`, text, required): tag_name.

**Outputs**: Result.

- `data` (text): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": "",
  "has_more": false,
  "next_cursor": null
}
```

### Delete warehouse

Delete warehouse.

**Inputs**

- Warehouse (`warehouse_id`, text, required): Warehouse ID

**Outputs**: Result.

- `data` (null): Data.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Estimate rates

Estimate rates.

**Inputs**

- From country code (`from_country_code`, text, required): A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1). One of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- From postal code (`from_postal_code`, text, required): postal code
- From city locality (`from_city_locality`, text, required): from postal code
- From state province (`from_state_province`, text, required): From state province
- To country code (`to_country_code`, text, required): A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1). One of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- To postal code (`to_postal_code`, text, required): postal code
- To city locality (`to_city_locality`, text, required): The city locality the package is being shipped to
- To state province (`to_state_province`, text, required): To state province
- Weight (`weight`, object, required): The weight of a package
- Dimensions (`dimensions`, object): The dimensions of a package
- Confirmation (`confirmation`, text): The possible delivery confirmation values. One of: `none`, `delivery`, `signature`, `adult_signature`, `adult_signature_restricted_delivery`, `direct_signature`, `delivery_mailed`, `verbal_confirmation`, `delivery_code`, `age_verification_16_plus`.
- Address residential indicator (`address_residential_indicator`, text): Indicates whether an address is residential. One of: `unknown`, `yes`, `no`.
- Ship date (`ship_date`, date and time, required): An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
- Carrier ids (`carrier_ids`, list, required): Array of Carrier IDs

**Outputs**: Result.

- `data` (list): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": [],
  "has_more": false,
  "next_cursor": null
}
```

### Get label

Get one shipping label by its ID: its tracking number, tracking link, whether the package was delivered (tracking_status), the carrier, and the customer's name and email (ship_to).

**Inputs**

- Label id (`label_id`, text, required): The label's ID, such as se-28529731, from 'List labels'.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "alternative_identifiers": [],
    "batch_id": "",
    "carrier_code": "ups",
    "carrier_id": "se-28529731",
    "charge_event": "carrier_default",
    "confirmation": "none",
    "created_at": "2026-11-04T15:02:11.000Z",
    "delivery_prediction": {
      "confidence_level": "high",
      "delivery_date": ""
    },
    "display_scheme": "label",
    "external_order_id": "5123456789",
    "external_shipment_id": "10001",
    "form_download": {
      "href": "",
      "type": ""
    },
    "insurance_claim": {
      "href": "",
      "type": ""
    },
    "insurance_cost": {
      "amount": 0,
      "currency": ""
    },
    "is_international": false,
    "is_return_label": false,
    "label_download": {
      "href": "",
      "pdf": "",
      "png": "",
      "zpl": ""
    },
    "label_download_type": "url",
    "label_format": "pdf",
    "label_id": "se-402157839",
    "label_image_id": "",
    "label_layout": "4x6",
    "outbound_label_id": "",
    "package_code": "",
    "packages": [],
    "paperless_download": {
      "handoff_code": "",
      "href": "",
      "instructions": ""
    },
    "qr_code_download": {
      "href": "",
      "type": ""
    },
    "rate_details": [],
    "refund_details": {
      "amount_approved": {},
      "amount_credited": {},
      "amount_paid": {},
      "amount_requested": {},
      "refund_status": "request_scheduled",
      "request_date": ""
    },
    "requested_comparison_amount": {
      "amount": 0,
      "currency": ""
    },
    "rma_number": "",
    "service_code": "ups_ground",
    "ship_date": "2026-11-04T00:00:00Z",
    "ship_to": {
      "address_line1": "2408 Elm Street",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "yes",
      "city_locality": "Austin",
      "company_name": null,
      "country_code": "US",
      "email": "maria.lopez@example.com",
      "instructions": null,
      "name": "Maria Lopez",
      "phone": "+1 512-555-0142",
      "postal_code": "78703",
      "state_province": "TX"
    },
    "shipment_cost": {
      "amount": 8.45,
      "currency": "usd"
    },
    "shipment_id": "se-791204417",
    "status": "completed",
    "test_label": false,
    "trackable": true,
    "tracking_number": "1Z932R800392060079",
    "tracking_status": "in_transit",
    "tracking_url": "https://www.ups.com/track?tracknum=1Z932R800392060079",
    "validate_address": "no_validation",
    "void_type": "refund_assist",
    "voided": false,
    "voided_at": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get shipment

Get one shipment by its ID: the customer's name, email and address (ship_to), its order number, status, items and notes. A shipment has no tracking number, link or delivery status: those are on its label ('List labels'), and 'List shipments not delivered yet' finds the late ones.

**Inputs**

- Shipment id (`shipment_id`, text, required): The shipment's ID, such as se-28529731. A label carries it as shipment_id.

**Outputs**: Result.

- `data` (object): One order. ShipStation's API calls an order a shipment: shipment_number is the order number, ship_to.name the customer, created_at when it arrived, and shipment_status where it stands.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "advanced_options": {
      "additional_handling": false,
      "ancillary_endorsements_option": "",
      "bill_to_account": "",
      "bill_to_country_code": "",
      "bill_to_party": "recipient",
      "bill_to_postal_code": "",
      "collect_on_delivery": {},
      "contains_alcohol": false,
      "custom_field1": "",
      "custom_field2": "",
      "custom_field3": "",
      "dangerous_goods": false,
      "dangerous_goods_contact": {},
      "delivered_duty_paid": false,
      "delivery_as_addressed": false,
      "dry_ice": false,
      "dry_ice_weight": {},
      "event_notification": false,
      "fedex_freight": {},
      "fragile": false,
      "freight_class": "",
      "limited_quantity": false,
      "movement_indicator": "c2c",
      "netstamps_options": {},
      "non_machinable": false,
      "origin_type": "pickup",
      "own_document_upload": false,
      "regulated_content_type": "day_old_poultry",
      "return_after_first_attempt": false,
      "return_pickup_attempts": 0,
      "saturday_delivery": false,
      "shipper_release": false,
      "suppress_carrier_generated_documents": [],
      "third_party_consignee": false,
      "transparency_codes": [],
      "use_ups_ground_freight_pricing": false,
      "windsor_framework_details": {}
    },
    "amount_paid": {
      "amount": 48.47,
      "currency": "usd"
    },
    "assigned_user": null,
    "batch_ids": [],
    "carrier_id": null,
    "comparison_rate_type": null,
    "confirmation": "none",
    "created_at": "2026-11-07T15:04:00.000Z",
    "customs": {
      "contents": "merchandise",
      "contents_explanation": "",
      "customs_items": [],
      "declaration": "",
      "importer_of_record": {},
      "invoice_additional_details": {},
      "non_delivery": "return_to_sender",
      "pending_documents": false,
      "terms_of_trade_code": "exw"
    },
    "deliver_by_date": null,
    "display_scheme": null,
    "external_order_id": "5521048",
    "external_shipment_id": "5521048",
    "hold_until_date": null,
    "insurance_provider": "none",
    "internal_notes": null,
    "is_gift": false,
    "is_return": false,
    "items": [
      {
        "allocation_status": null,
        "asin": null,
        "bundle_sku": null,
        "external_order_id": "5521048",
        "external_order_item_id": "1",
        "fullfilment_sku": null,
        "image_url": null,
        "inventory_location": null,
        "item_id": "1402291169813",
        "name": "Ceramic mug",
        "options": [
          {
            "name": "Color",
            "value": "Blue"
          }
        ],
        "order_source_code": "shopify",
        "product_id": "10408926",
        "quantity": 2,
        "sales_order_id": null,
        "sales_order_item_id": null,
        "shipping_amount": 9.5,
        "sku": "MUG-01",
        "tax_amount": 2.97,
        "unit_price": 18.0,
        "upc": null,
        "weight": {
          "unit": "ounce",
          "value": 12
        }
      }
    ],
    "modified_at": "2026-11-07T15:04:00.000Z",
    "notes_for_gift": null,
    "notes_from_buyer": "Please leave at the side door",
    "notes_to_buyer": null,
    "order_source_code": "shopify",
    "packages": [
      {
        "content_description": null,
        "dimensions": {
          "height": 4,
          "length": 8,
          "unit": "inch",
          "width": 6
        },
        "external_package_id": null,
        "insured_value": {
          "amount": 0,
          "currency": "usd"
        },
        "label_messages": {
          "reference1": null,
          "reference2": null,
          "reference3": null
        },
        "package_code": "package",
        "package_id": null,
        "package_name": null,
        "products": [],
        "shipment_package_id": "se-123456",
        "weight": {
          "unit": "ounce",
          "value": 24
        }
      }
    ],
    "requested_shipment_service": "Expedited Shipping",
    "retail_rate": null,
    "return_to": {
      "address_line1": "4009 Marathon Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "no",
      "city_locality": "Austin",
      "company_name": "Acme Goods",
      "country_code": "US",
      "email": null,
      "geolocation": [],
      "instructions": null,
      "name": "Acme Shipping",
      "phone": "+1 512-555-0100",
      "postal_code": "78756",
      "state_province": "TX"
    },
    "sales_order_ids": [],
    "service_code": null,
    "ship_by_date": "2026-11-10T00:00:00.000Z",
    "ship_date": "2026-11-12T00:00:00Z",
    "ship_from": {
      "address_line1": "4009 Marathon Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "no",
      "city_locality": "Austin",
      "company_name": "Acme Goods",
      "country_code": "US",
      "email": null,
      "geolocation": [],
      "instructions": null,
      "name": "Acme Shipping",
      "phone": "+1 512-555-0100",
      "postal_code": "78756",
      "state_province": "TX"
    },
    "ship_to": {
      "address_line1": "525 S Winchester Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "yes",
      "city_locality": "San Jose",
      "company_name": null,
      "country_code": "US",
      "email": "jane@example.com",
      "geolocation": [],
      "instructions": null,
      "name": "Jane Doe",
      "phone": "+1 512-555-0142",
      "postal_code": "95128",
      "state_province": "CA"
    },
    "shipment_id": "se-28529731",
    "shipment_number": "10001",
    "shipment_status": "pending",
    "shipping_paid": {
      "amount": 9.5,
      "currency": "usd"
    },
    "store_id": "se-12345",
    "tags": [
      {
        "name": "Rush"
      }
    ],
    "tax_identifiers": null,
    "tax_paid": {
      "amount": 2.97,
      "currency": "usd"
    },
    "total_weight": {
      "unit": "ounce",
      "value": 24
    },
    "warehouse_id": "se-28529799",
    "zone": null
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get warehouse

Get warehouse.

**Inputs**

- Warehouse (`warehouse_id`, text, required): Warehouse ID

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "created_at": "",
    "is_default": false,
    "name": "",
    "origin_address": {
      "address_line1": "",
      "address_line2": "",
      "address_line3": "",
      "address_residential_indicator": "unknown",
      "city_locality": "",
      "company_name": "",
      "country_code": "",
      "email": "",
      "name": "",
      "phone": "",
      "postal_code": "",
      "state_province": ""
    },
    "return_address": {
      "address_line1": "",
      "address_line2": "",
      "address_line3": "",
      "address_residential_indicator": "unknown",
      "city_locality": "",
      "company_name": "",
      "country_code": "",
      "email": "",
      "name": "",
      "phone": "",
      "postal_code": "",
      "state_province": ""
    },
    "warehouse_id": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### List carrier packages

List carrier packages.

**Inputs**

- Carrier (`carrier_id`, text, required): Carrier ID

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "packages": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List carrier services

List carrier services.

**Inputs**

- Carrier (`carrier_id`, text, required): Carrier ID

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "services": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List carriers

List carriers.

**Inputs**

- Page (`page`, number): Return a specific page of results. Defaults to the first page. If set to a number that's greater than the number of pages of results, an empty page is returned. At least 1.
- Page size (`page_size`, number): The number of results to return per response. At least 1.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "carriers": [],
    "errors": [],
    "links": {
      "first": {},
      "last": {},
      "next": {},
      "prev": {}
    },
    "page": 0,
    "pages": 0,
    "request_id": "",
    "total": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### List labels

List the shipping labels bought in ShipStation, newest first, 100 at a time. A label is one package on its way: it holds the tracking number, the tracking link, whether it was delivered (tracking_status) and the customer's name and email (ship_to). This is one page. While has_more is true, run the step again with Page set to next_cursor (the next page's number) to read on. For packages that shipped a while ago and still are not delivered, use 'List shipments not delivered yet' instead: it reads every page and does the filtering.

**Inputs**

- Label status (`label_status`, text): Only list labels in this state: Completed (bought and usable), Processing, Error or Voided (cancelled). This is the label's own state, not whether the package was delivered. Leave blank for all of them. One of: `processing`, `completed`, `error`, `voided`.
- Created at start (`created_at_start`, date and time): Only list labels bought at or after this time.
- Created at end (`created_at_end`, date and time): Only list labels bought at or before this time.
- Page (`page`, number): Which page to read, starting at 1. Leave blank for the first page; for the next one, give the next_cursor the page before returned. At least 1.
- Page size (`page_size`, number): How many labels one page holds. 100 when left blank. At least 1.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): True when there is another page to read.
- `next_cursor` (text): The number of the next page, as text, such as 2. Put it in Page to read the next page. Blank on the last page.

**Example output**

```json
{
  "data": {
    "labels": [
      {
        "carrier_code": "ups",
        "carrier_id": "se-28529731",
        "created_at": "2026-11-04T15:02:11.000Z",
        "external_order_id": "5123456789",
        "external_shipment_id": "10001",
        "is_international": false,
        "is_return_label": false,
        "label_id": "se-402157839",
        "service_code": "ups_ground",
        "ship_date": "2026-11-04T00:00:00Z",
        "ship_to": {
          "address_line1": "2408 Elm Street",
          "address_line2": null,
          "address_line3": null,
          "address_residential_indicator": "yes",
          "city_locality": "Austin",
          "company_name": null,
          "country_code": "US",
          "email": "maria.lopez@example.com",
          "instructions": null,
          "name": "Maria Lopez",
          "phone": "+1 512-555-0142",
          "postal_code": "78703",
          "state_province": "TX"
        },
        "shipment_cost": {
          "amount": 8.45,
          "currency": "usd"
        },
        "shipment_id": "se-791204417",
        "status": "completed",
        "trackable": true,
        "tracking_number": "1Z932R800392060079",
        "tracking_status": "in_transit",
        "tracking_url": "https://www.ups.com/track?tracknum=1Z932R800392060079",
        "voided": false
      }
    ],
    "links": {
      "first": {},
      "last": {},
      "next": {},
      "prev": {}
    },
    "page": 1,
    "pages": 1,
    "total": 1
  },
  "has_more": false,
  "next_cursor": null
}
```

### List orders waiting to ship

Beta. List the orders that haven't shipped yet, expedited orders first and then the longest-waiting, optionally only those that have waited a number of days. It reads every page itself and returns one ready-to-read record per order (order number, customer, days waiting, ship-by date, requested shipping service) plus the same list as text ready to post in a message. ShipStation doesn't mark an order as expedited, so an order counts as expedited when its requested service, carrier service or a tag contains one of the Expedited words. Orders on hold are left out unless asked for. ShipStation doesn't say which unshipped orders are still waiting for payment, so those are included.

**Inputs**

- Waiting more than (days) (`waiting_days`, number): Only orders that arrived in ShipStation more than this many days ago: 2 lists every order that has waited longer than 2 full days (48 hours). Leave empty for every unshipped order. From 0 to 3650.
- Expedited words (`expedited_words`, text): The words that mark an order as expedited, separated by commas. An order is expedited when its requested shipping service, its carrier service or one of its tags contains one of them; capitals don't matter. Stores name their shipping options themselves, so change this to match yours. When left empty: expedited, express, overnight, next day, 2 day, 2day, 2nd day, second day, two day, rush.
- Include orders on hold (`include_on_hold`, true/false): Turn on to also list orders that are on hold. They are left out otherwise, since they aren't meant to ship yet.

**Outputs**: The orders waiting to ship.

- `count` (number): How many orders are listed.
- `expedited_count` (number): How many of them are expedited.
- `has_more` (true/false): True only when more than 5,000 orders matched: the 5,000 longest-waiting are listed and the rest left out.
- `orders` (list): One record per order, expedited orders first and then the longest-waiting.
- `text` (text): The same orders as text, one line each in the same order, ready to put in a Slack message or an email. When there are none it says so in a sentence.

**Example output**

```json
{
  "count": 2,
  "expedited_count": 1,
  "has_more": false,
  "orders": [
    {
      "carrier_service": "",
      "created_at": "2026-11-07T15:04:00.000Z",
      "created_at_display": "Nov 7, 2026",
      "customer_email": "jane@example.com",
      "customer_name": "Jane Doe",
      "days_waiting": 5,
      "hold_until_date": null,
      "is_expedited": true,
      "is_past_ship_by": true,
      "item_count": 2,
      "items_summary": "2 x Ceramic mug",
      "on_hold": false,
      "order_number": "10001",
      "requested_service": "Expedited Shipping",
      "ship_by_date": "2026-11-10T00:00:00.000Z",
      "ship_by_display": "Nov 10, 2026",
      "shipment_id": "se-28529731",
      "tags": [
        "Rush"
      ]
    },
    {
      "carrier_service": "usps_ground_advantage",
      "created_at": "2026-11-03T09:30:00.000Z",
      "created_at_display": "Nov 3, 2026",
      "customer_email": "",
      "customer_name": "Sam Lee",
      "days_waiting": 9,
      "hold_until_date": null,
      "is_expedited": false,
      "is_past_ship_by": false,
      "item_count": 3,
      "items_summary": "1 x Desk lamp, 2 x Bulb",
      "on_hold": false,
      "order_number": "9987",
      "requested_service": "Standard",
      "ship_by_date": null,
      "ship_by_display": "",
      "shipment_id": "se-28529604",
      "tags": []
    }
  ],
  "text": "\u2022 EXPEDITED \u00b7 Order 10001 \u00b7 Jane Doe \u00b7 waiting 5 days (since Nov 7, 2026) \u00b7 Expedited Shipping \u00b7 ship by Nov 10, 2026 (overdue) \u00b7 2 items\n\u2022 Order 9987 \u00b7 Sam Lee \u00b7 waiting 9 days (since Nov 3, 2026) \u00b7 Standard \u00b7 3 items"
}
```

### List package types

List package types.

**Inputs**: None.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "packages": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List shipments

List the shipments in ShipStation, 100 at a time, each with the customer's name, email and address (ship_to), its order number and status. Narrow it by status, tag or when it was created or changed. This is one page. While has_more is true, run the step again with Page set to next_cursor (the next page's number) to read on. A shipment has no tracking number, link or delivery status: those are on its label ('List labels'), and 'List shipments not delivered yet' finds the late ones.

**Inputs**

- Status (`shipment_status`, text): Only list shipments in this state: Pending (no label yet), Processing, Label purchased (shipped or about to) or Cancelled. Leave blank for all of them. There is no 'delivered' here: see 'List shipments not delivered yet'. One of: `pending`, `processing`, `label_purchased` (Label purchased), `cancelled`.
- Tag (`tag`, text): Only list shipments that carry this tag, by the tag's name, such as Priority. One tag at a time.
- Created after (`created_at_start`, date and time): Only list shipments created at or after this time.
- Created before (`created_at_end`, date and time): Only list shipments created at or before this time.
- Changed after (`modified_at_start`, date and time): Only list shipments changed at or after this time.
- Changed before (`modified_at_end`, date and time): Only list shipments changed at or before this time.
- Sort by (`sort_by`, text): Beta. The date to put the orders in order by: when each arrived (created_at) or was last changed (modified_at). One of: `created_at` (When it arrived (created_at)), `modified_at` (When it last changed (modified_at)).
- Order (`sort_dir`, text): Beta. asc puts the oldest first; desc puts the newest first, which is what ShipStation does when this is left empty. One of: `asc` (Oldest first (asc)), `desc` (Newest first (desc)).
- All pages (`all_pages`, true/false): Beta. Turn on to get every matching order in this one step, however many pages that takes, instead of one page. It stops after 50 pages, which is 5,000 orders unless Page size is set lower; has_more then says there are more and next_cursor is the page to carry on from.
- Page (`page`, number): Which page to read, starting at 1. Leave blank for the first page; for the next one, give the next_cursor the page before returned. At least 1.
- Page size (`page_size`, number): How many shipments one page holds. 100 when left blank. At least 1.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether there are more orders after the ones returned.
- `next_cursor` (text): The number of the next page, as text. Give it to this step's Page to read on. Empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "links": {
      "first": {},
      "last": {},
      "next": {},
      "prev": {}
    },
    "page": 1,
    "pages": 1,
    "shipments": [
      {
        "advanced_options": {
          "additional_handling": false,
          "ancillary_endorsements_option": "",
          "bill_to_account": "",
          "bill_to_country_code": "",
          "bill_to_party": "recipient",
          "bill_to_postal_code": "",
          "collect_on_delivery": {},
          "contains_alcohol": false,
          "custom_field1": "",
          "custom_field2": "",
          "custom_field3": "",
          "dangerous_goods": false,
          "dangerous_goods_contact": {},
          "delivered_duty_paid": false,
          "delivery_as_addressed": false,
          "dry_ice": false,
          "dry_ice_weight": {},
          "event_notification": false,
          "fedex_freight": {},
          "fragile": false,
          "freight_class": "",
          "limited_quantity": false,
          "movement_indicator": "c2c",
          "netstamps_options": {},
          "non_machinable": false,
          "origin_type": "pickup",
          "own_document_upload": false,
          "regulated_content_type": "day_old_poultry",
          "return_after_first_attempt": false,
          "return_pickup_attempts": 0,
          "saturday_delivery": false,
          "shipper_release": false,
          "suppress_carrier_generated_documents": [],
          "third_party_consignee": false,
          "transparency_codes": [],
          "use_ups_ground_freight_pricing": false,
          "windsor_framework_details": {}
        },
        "amount_paid": {
          "amount": 48.47,
          "currency": "usd"
        },
        "assigned_user": null,
        "batch_ids": [],
        "carrier_id": null,
        "comparison_rate_type": null,
        "confirmation": "none",
        "created_at": "2026-11-07T15:04:00.000Z",
        "customs": {
          "contents": "merchandise",
          "contents_explanation": "",
          "customs_items": [],
          "declaration": "",
          "importer_of_record": {},
          "invoice_additional_details": {},
          "non_delivery": "return_to_sender",
          "pending_documents": false,
          "terms_of_trade_code": "exw"
        },
        "deliver_by_date": null,
        "display_scheme": null,
        "external_order_id": "5521048",
        "external_shipment_id": "5521048",
        "hold_until_date": null,
        "insurance_provider": "none",
        "internal_notes": null,
        "is_gift": false,
        "is_return": false,
        "items": [
          {
            "allocation_status": null,
            "asin": null,
            "bundle_sku": null,
            "external_order_id": "5521048",
            "external_order_item_id": "1",
            "fullfilment_sku": null,
            "image_url": null,
            "inventory_location": null,
            "item_id": "1402291169813",
            "name": "Ceramic mug",
            "options": [
              {
                "name": "Color",
                "value": "Blue"
              }
            ],
            "order_source_code": "shopify",
            "product_id": "10408926",
            "quantity": 2,
            "sales_order_id": null,
            "sales_order_item_id": null,
            "shipping_amount": 9.5,
            "sku": "MUG-01",
            "tax_amount": 2.97,
            "unit_price": 18.0,
            "upc": null,
            "weight": {
              "unit": "ounce",
              "value": 12
            }
          }
        ],
        "modified_at": "2026-11-07T15:04:00.000Z",
        "notes_for_gift": null,
        "notes_from_buyer": "Please leave at the side door",
        "notes_to_buyer": null,
        "order_source_code": "shopify",
        "packages": [
          {
            "content_description": null,
            "dimensions": {
              "height": 4,
              "length": 8,
              "unit": "inch",
              "width": 6
            },
            "external_package_id": null,
            "insured_value": {
              "amount": 0,
              "currency": "usd"
            },
            "label_messages": {
              "reference1": null,
              "reference2": null,
              "reference3": null
            },
            "package_code": "package",
            "package_id": null,
            "package_name": null,
            "products": [],
            "shipment_package_id": "se-123456",
            "weight": {
              "unit": "ounce",
              "value": 24
            }
          }
        ],
        "requested_shipment_service": "Expedited Shipping",
        "retail_rate": null,
        "return_to": {
          "address_line1": "4009 Marathon Blvd",
          "address_line2": null,
          "address_line3": null,
          "address_residential_indicator": "no",
          "city_locality": "Austin",
          "company_name": "Acme Goods",
          "country_code": "US",
          "email": null,
          "geolocation": [],
          "instructions": null,
          "name": "Acme Shipping",
          "phone": "+1 512-555-0100",
          "postal_code": "78756",
          "state_province": "TX"
        },
        "sales_order_ids": [],
        "service_code": null,
        "ship_by_date": "2026-11-10T00:00:00.000Z",
        "ship_date": "2026-11-12T00:00:00Z",
        "ship_from": {
          "address_line1": "4009 Marathon Blvd",
          "address_line2": null,
          "address_line3": null,
          "address_residential_indicator": "no",
          "city_locality": "Austin",
          "company_name": "Acme Goods",
          "country_code": "US",
          "email": null,
          "geolocation": [],
          "instructions": null,
          "name": "Acme Shipping",
          "phone": "+1 512-555-0100",
          "postal_code": "78756",
          "state_province": "TX"
        },
        "ship_to": {
          "address_line1": "525 S Winchester Blvd",
          "address_line2": null,
          "address_line3": null,
          "address_residential_indicator": "yes",
          "city_locality": "San Jose",
          "company_name": null,
          "country_code": "US",
          "email": "jane@example.com",
          "geolocation": [],
          "instructions": null,
          "name": "Jane Doe",
          "phone": "+1 512-555-0142",
          "postal_code": "95128",
          "state_province": "CA"
        },
        "shipment_id": "se-28529731",
        "shipment_number": "10001",
        "shipment_status": "pending",
        "shipping_paid": {
          "amount": 9.5,
          "currency": "usd"
        },
        "store_id": "se-12345",
        "tags": [
          {
            "name": "Rush"
          }
        ],
        "tax_identifiers": null,
        "tax_paid": {
          "amount": 2.97,
          "currency": "usd"
        },
        "total_weight": {
          "unit": "ounce",
          "value": 24
        },
        "warehouse_id": "se-28529799",
        "zone": null
      }
    ],
    "total": 1
  },
  "has_more": false,
  "next_cursor": null
}
```

### List shipments not delivered yet

Beta. Find the packages that shipped more than a number of days ago and still are not delivered, to apologise to each customer or post the list. Each comes with the customer's name and email, the tracking number and link, the carrier, when it shipped and how many days ago, and the result has a count and the whole list as text ready to post. It reads every page of labels itself, so no paging loop, date calculation or filter step is needed. Delivered packages, cancelled labels, return labels and labels the carrier does not track are left out; packages whose tracking is unknown or failed are kept, and say so. In a daily workflow that emails customers, one step serves both jobs: post 'text' for the full list, and email only the shipments whose 'newly_late' is true, so each customer is emailed once.

**Inputs**

- Shipped more than this many days ago (`shipped_more_than_days`, number): How many days a package may be on the road before it counts as late: 5 lists packages that shipped 6 or more days ago. Days are whole calendar days (UTC). 5 when left blank. From 0 to 364. Default: `5`.
- Look back this many days (`look_back_days`, number): How far back to look: labels bought longer ago than this are not checked, so a package lost for months stops being listed. It must be more than the number of days above. 30 when left blank. From 1 to 365. Default: `30`.
- Which shipments to return (`include`, text): 'All that are late now' lists every late shipment, each marked with whether it became late since yesterday (newly_late). 'Only those that became late since yesterday' lists just the shipments that crossed the number of days above in the last day, so a workflow that runs every day lists each shipment once. A day the workflow does not run is not caught up later. One of: `all_late` (All that are late now), `newly_late` (Only those that became late since yesterday). Default: `all_late`.

**Outputs**

- `count` (number): How many shipments are listed. 0 when there are none, so 'post nothing when the list is empty' is one check.
- `has_more` (true/false): True when there were more labels in the look-back period than one step reads, so older late shipments may be missing. Shorten the look-back if this is true.
- `newly_late_count` (number): How many of them became late since yesterday.
- `shipments` (list): The shipments not delivered yet, the longest on the road first. Empty when there are none.
- `text` (text): The whole list as text, one line per shipment with the customer, order number, carrier, tracking number, status, ship date, days since and tracking link, ready to post in a message. Blank when there are none.

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "newly_late_count": 1,
  "shipments": [
    {
      "carrier": "UPS",
      "customer_email": "maria.lopez@example.com",
      "customer_first_name": "Maria",
      "customer_name": "Maria Lopez",
      "days_since_shipped": 8,
      "label_id": "se-402157839",
      "newly_late": false,
      "order_number": "10001",
      "shipment_id": "se-791204417",
      "shipped_display": "November 4, 2026",
      "shipped_on": "2026-11-04",
      "tracking_number": "1Z932R800392060079",
      "tracking_status": "In transit",
      "tracking_url": "https://www.ups.com/track?tracknum=1Z932R800392060079"
    },
    {
      "carrier": "USPS",
      "customer_email": "",
      "customer_first_name": "Daniel",
      "customer_name": "Daniel Okafor",
      "days_since_shipped": 6,
      "label_id": "se-402198114",
      "newly_late": true,
      "order_number": "10014",
      "shipment_id": "se-791260932",
      "shipped_display": "November 6, 2026",
      "shipped_on": "2026-11-06",
      "tracking_number": "9400111899223344556677",
      "tracking_status": "Unknown",
      "tracking_url": ""
    }
  ],
  "text": "\u2022 Maria Lopez, order 10001: UPS 1Z932R800392060079, In transit, shipped November 4, 2026 (8 days ago) https://www.ups.com/track?tracknum=1Z932R800392060079\n\u2022 Daniel Okafor, order 10014: USPS 9400111899223344556677, Unknown, shipped November 6, 2026 (6 days ago)"
}
```

### List tags

List tags.

**Inputs**: None.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "tags": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List warehouses

List warehouses.

**Inputs**: None.

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "warehouses": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update shipment

Update shipment.

**Inputs**

- Shipment id (`shipment_id`, text, required): Shipment ID
- Carrier (`carrier_id`, text): A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.
- Service code (`service_code`, text): A [carrier service], such as `fedex_ground`, `usps_first_class_mail`, `flat_rate_envelope`, etc.
- Requested shipment service (`requested_shipment_service`, text): The requested shipment service
- External order id (`external_order_id`, text): ID that the Order Source assigned
- Hold until date (`hold_until_date`, date and time): Date to hold the shipment until
- Ship by date (`ship_by_date`, date and time): Date by which the shipment should be shipped
- Deliver by date (`deliver_by_date`, date and time): Date by which the shipment should be delivered
- Retail rate (`retail_rate`, object): A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance.
- Store id (`store_id`, text): A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.
- Items (`items`, list): Describe the packages included in this shipment as related to potential metadata that was imported from external order sources
- Notes from buyer (`notes_from_buyer`, text): Notes from the buyer
- Notes to buyer (`notes_to_buyer`, text): Notes to the buyer
- Notes for gift (`notes_for_gift`, text): Gift notes
- Internal notes (`internal_notes`, text): Internal notes from the seller
- Is gift (`is_gift`, true/false): Indicates if the shipment is a gift
- Assigned user (`assigned_user`, text): User assigned to the shipment
- Amount paid (`amount_paid`, object): A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance.
- Shipping paid (`shipping_paid`, object): A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance.
- Tax paid (`tax_paid`, object): A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance.
- Zone (`zone`, number): Shipping zone. At least 0.
- Display scheme (`display_scheme`, text): Display scheme for the shipment
- Tax identifiers (`tax_identifiers`, list): tax_identifiers.
- External shipment id (`external_shipment_id`, text): A user-defined key that identifies the source order. Multiple shipments can share the same `external_shipment_id` (common in split-shipping scenarios where one order results in multiple shipments). Functionally identical to `orderKey` in V1 API. > **Warning:** The `external_shipment_id` is limited to 50 characters. Any additional characters will be truncated.
- Shipment number (`shipment_number`, text): A non-unique user-defined number used to identify a shipment. If undefined, this will match the external_shipment_id of the shipment. > **Warning:** The `shipment_number` is limited to 50 characters. Any additional characters will be truncated.
- Ship date (`ship_date`, date and time): An [ISO 8601](https://en.wikipedia.org/wiki/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 .
- Ship to (`ship_to`, object): A complete or partial mailing address.
- Ship from (`ship_from`, object): A complete or partial mailing address.
- Warehouse (`warehouse_id`, text): A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.
- Return to (`return_to`, object): A complete or partial mailing address.
- Is return (`is_return`, true/false): An optional indicator if the shipment is intended to be a return. Defaults to false if not provided.
- Confirmation (`confirmation`, text): The possible delivery confirmation values. One of: `none`, `delivery`, `signature`, `adult_signature`, `adult_signature_restricted_delivery`, `direct_signature`, `delivery_mailed`, `verbal_confirmation`, `delivery_code`, `age_verification_16_plus`.
- Customs (`customs`, object): Options for international shipments, such as customs declarations.
- Advanced options (`advanced_options`, object): Advanced shipment options
- Insurance provider (`insurance_provider`, text): The possible insurance provider values. Requests also accept `xcover` as an alias of `x_cover`. One of: `none`, `shipsurance`, `parcelguard`, `x_cover`, `carrier`, `third_party`.
- Tags (`tags`, list): Arbitrary tags associated with this shipment. Tags can be used to categorize shipments, and shipments can be queried by their tags. Note: Tags require object structure with name property, not simple strings.
- Order source code (`order_source_code`, text): The order sources that are supported by ShipStation. One of: `amazon_ca`, `amazon_us`, `brightpearl`, `channel_advisor`, `cratejoy`, `ebay`, `etsy`, `jane`, `groupon_goods`, `magento`, and 10 more.
- Packages (`packages`, list): The packages in the shipment. > **Note:** Some carriers only allow one package per shipment. If you attempt to create a multi-package shipment for a carrier that doesn't allow it, an error will be returned.
- Comparison rate type (`comparison_rate_type`, text): Calculate a rate for this shipment with the requested carrier using a ratecard that differs from the default. Only supported for UPS and USPS.
- Validate address (`validate_address`, text): The possible validate address values. One of: `no_validation`, `validate_only`, `validate_and_clean`.

**Outputs**: Result.

- `data` (object): One order. ShipStation's API calls an order a shipment: shipment_number is the order number, ship_to.name the customer, created_at when it arrived, and shipment_status where it stands.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "advanced_options": {
      "additional_handling": false,
      "ancillary_endorsements_option": "",
      "bill_to_account": "",
      "bill_to_country_code": "",
      "bill_to_party": "recipient",
      "bill_to_postal_code": "",
      "collect_on_delivery": {},
      "contains_alcohol": false,
      "custom_field1": "",
      "custom_field2": "",
      "custom_field3": "",
      "dangerous_goods": false,
      "dangerous_goods_contact": {},
      "delivered_duty_paid": false,
      "delivery_as_addressed": false,
      "dry_ice": false,
      "dry_ice_weight": {},
      "event_notification": false,
      "fedex_freight": {},
      "fragile": false,
      "freight_class": "",
      "limited_quantity": false,
      "movement_indicator": "c2c",
      "netstamps_options": {},
      "non_machinable": false,
      "origin_type": "pickup",
      "own_document_upload": false,
      "regulated_content_type": "day_old_poultry",
      "return_after_first_attempt": false,
      "return_pickup_attempts": 0,
      "saturday_delivery": false,
      "shipper_release": false,
      "suppress_carrier_generated_documents": [],
      "third_party_consignee": false,
      "transparency_codes": [],
      "use_ups_ground_freight_pricing": false,
      "windsor_framework_details": {}
    },
    "amount_paid": {
      "amount": 48.47,
      "currency": "usd"
    },
    "assigned_user": null,
    "batch_ids": [],
    "carrier_id": null,
    "comparison_rate_type": null,
    "confirmation": "none",
    "created_at": "2026-11-07T15:04:00.000Z",
    "customs": {
      "contents": "merchandise",
      "contents_explanation": "",
      "customs_items": [],
      "declaration": "",
      "importer_of_record": {},
      "invoice_additional_details": {},
      "non_delivery": "return_to_sender",
      "pending_documents": false,
      "terms_of_trade_code": "exw"
    },
    "deliver_by_date": null,
    "display_scheme": null,
    "external_order_id": "5521048",
    "external_shipment_id": "5521048",
    "hold_until_date": null,
    "insurance_provider": "none",
    "internal_notes": null,
    "is_gift": false,
    "is_return": false,
    "items": [
      {
        "allocation_status": null,
        "asin": null,
        "bundle_sku": null,
        "external_order_id": "5521048",
        "external_order_item_id": "1",
        "fullfilment_sku": null,
        "image_url": null,
        "inventory_location": null,
        "item_id": "1402291169813",
        "name": "Ceramic mug",
        "options": [
          {
            "name": "Color",
            "value": "Blue"
          }
        ],
        "order_source_code": "shopify",
        "product_id": "10408926",
        "quantity": 2,
        "sales_order_id": null,
        "sales_order_item_id": null,
        "shipping_amount": 9.5,
        "sku": "MUG-01",
        "tax_amount": 2.97,
        "unit_price": 18.0,
        "upc": null,
        "weight": {
          "unit": "ounce",
          "value": 12
        }
      }
    ],
    "modified_at": "2026-11-07T15:04:00.000Z",
    "notes_for_gift": null,
    "notes_from_buyer": "Please leave at the side door",
    "notes_to_buyer": null,
    "order_source_code": "shopify",
    "packages": [
      {
        "content_description": null,
        "dimensions": {
          "height": 4,
          "length": 8,
          "unit": "inch",
          "width": 6
        },
        "external_package_id": null,
        "insured_value": {
          "amount": 0,
          "currency": "usd"
        },
        "label_messages": {
          "reference1": null,
          "reference2": null,
          "reference3": null
        },
        "package_code": "package",
        "package_id": null,
        "package_name": null,
        "products": [],
        "shipment_package_id": "se-123456",
        "weight": {
          "unit": "ounce",
          "value": 24
        }
      }
    ],
    "requested_shipment_service": "Expedited Shipping",
    "retail_rate": null,
    "return_to": {
      "address_line1": "4009 Marathon Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "no",
      "city_locality": "Austin",
      "company_name": "Acme Goods",
      "country_code": "US",
      "email": null,
      "geolocation": [],
      "instructions": null,
      "name": "Acme Shipping",
      "phone": "+1 512-555-0100",
      "postal_code": "78756",
      "state_province": "TX"
    },
    "sales_order_ids": [],
    "service_code": null,
    "ship_by_date": "2026-11-10T00:00:00.000Z",
    "ship_date": "2026-11-12T00:00:00Z",
    "ship_from": {
      "address_line1": "4009 Marathon Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "no",
      "city_locality": "Austin",
      "company_name": "Acme Goods",
      "country_code": "US",
      "email": null,
      "geolocation": [],
      "instructions": null,
      "name": "Acme Shipping",
      "phone": "+1 512-555-0100",
      "postal_code": "78756",
      "state_province": "TX"
    },
    "ship_to": {
      "address_line1": "525 S Winchester Blvd",
      "address_line2": null,
      "address_line3": null,
      "address_residential_indicator": "yes",
      "city_locality": "San Jose",
      "company_name": null,
      "country_code": "US",
      "email": "jane@example.com",
      "geolocation": [],
      "instructions": null,
      "name": "Jane Doe",
      "phone": "+1 512-555-0142",
      "postal_code": "95128",
      "state_province": "CA"
    },
    "shipment_id": "se-28529731",
    "shipment_number": "10001",
    "shipment_status": "pending",
    "shipping_paid": {
      "amount": 9.5,
      "currency": "usd"
    },
    "store_id": "se-12345",
    "tags": [
      {
        "name": "Rush"
      }
    ],
    "tax_identifiers": null,
    "tax_paid": {
      "amount": 2.97,
      "currency": "usd"
    },
    "total_weight": {
      "unit": "ounce",
      "value": 24
    },
    "warehouse_id": "se-28529799",
    "zone": null
  },
  "has_more": false,
  "next_cursor": null
}
```

### Void label

Void label.

**Inputs**

- Label id (`label_id`, text, required): Label ID

**Outputs**: Result.

- `data` (object): Complete service response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {
    "approved": false,
    "message": "",
    "reason_code": "unknown",
    "voided_label_ids": []
  },
  "has_more": false,
  "next_cursor": null
}
```
