shipping_containers

Fetch shipping containers matching the supplied arguments.

Arguments

Argument	Type	Required	Description
`warehouse_id`	`String`	No	Filter by public API warehouse ID. Use this ID field when selecting a warehouse; warehouse fields are display values or nested objects.
`carrier`	`String`	No	Filter by carrier.
`shipping_method`	`String`	No	Filter by shipping method.
`created_from`	ISODateTime	No	Inclusive start of the created range, in ISO-8601 datetime format.
`created_to`	ISODateTime	No	Inclusive end of the created range, in ISO-8601 datetime format.
`updated_from`	ISODateTime	No	Inclusive start of the updated range, in ISO-8601 datetime format.
`updated_to`	ISODateTime	No	Inclusive end of the updated range, in ISO-8601 datetime format.
`shipped_date_from`	ISODateTime	No	Inclusive start of the shipped date range, in ISO-8601 datetime format.
`shipped_date_to`	ISODateTime	No	Inclusive end of the shipped date range, in ISO-8601 datetime format.
`analyze`	`Boolean`	No	If true, the query will only be analyzed (cost estimated) without executing it.

Return Type

ShippingContainersQueryResult

Query

query shipping_containers(
  $warehouse_id: String,
  $carrier: String,
  $shipping_method: String,
  $created_from: ISODateTime,
  $created_to: ISODateTime,
  $updated_from: ISODateTime,
  $updated_to: ISODateTime,
  $shipped_date_from: ISODateTime,
  $shipped_date_to: ISODateTime,
  $analyze: Boolean
) {
  shipping_containers(
    warehouse_id: $warehouse_id,
    carrier: $carrier,
    shipping_method: $shipping_method,
    created_from: $created_from,
    created_to: $created_to,
    updated_from: $updated_from,
    updated_to: $updated_to,
    shipped_date_from: $shipped_date_from,
    shipped_date_to: $shipped_date_to,
    analyze: $analyze
  ) {
    request_id
    complexity
    data {
      ...ShippingContainerConnectionFragment
    
      pageInfo {
        ...PageInfoFragment
      
        hasNextPage
        hasPreviousPage
        startCursor
        endCursor
      }
      edges {
        ...ShippingContainerEdgeFragment
      
        node {
          ...ShippingContainerFragment
        
          id
          legacy_id
          account_id
          warehouse_id
          container_id
          carrier
          shipping_methods
          shipping_labels {
            ...ShippingLabelConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...ShippingLabelEdgeFragment
            
              node {
                ...ShippingLabelFragment
              
                id
                legacy_id
                account_id
                shipment_id
                order_id
                box_id
                box_name
                status
                tracking_number
                alternate_tracking_id
                order_number
                order_account_id
                carrier
                shipping_name
                shipping_method
                cost
                box_code
                device_id
                delivered
                picked_up
                refunded
                needs_refund
                profile
                partner_fulfillment_id
                full_size_to_print
                packing_slip
                warehouse
                warehouse_id
                insurance_amount
                carrier_account_id
                source
                created_date
                tracking_url
                dimensions {
                  ...DimensionsFragment
                
                  weight
                  height
                  width
                  length
                }
                label {
                  ...LabelResourceFragment
                
                  pdf_location
                  paper_pdf_location
                  thermal_pdf_location
                  image_location
                }
                address {
                  ...AddressFragment
                
                  name
                  address1
                  address2
                  city
                  state
                  country
                  zip
                  phone
                }
                order {
                  ...OrderFragment
                
                  id
                  legacy_id
                  order_number
                  partner_order_id
                  shop_name
                  fulfillment_status
                  order_date
                  total_tax
                  subtotal
                  total_discounts
                  total_price
                  box_name
                  ready_to_ship
                  auto_print_return_label
                  custom_invoice_url
                  account_id
                  updated_at
                  created_at
                  email
                  profile
                  gift_note
                  packing_note
                  required_ship_date
                  shipping_lines {
                    ...ShippingLinesFragment
                  
                    title
                    carrier
                    method
                    price
                  }
                  shipping_address {
                    ...OrderAddressFragment
                  
                    first_name
                    last_name
                    company
                    address1
                    address2
                    city
                    state
                    state_code
                    zip
                    country
                    country_code
                    email
                    phone
                  }
                  billing_address {
                    ...OrderAddressFragment
                  
                    first_name
                    last_name
                    company
                    address1
                    address2
                    city
                    state
                    state_code
                    zip
                    country
                    country_code
                    email
                    phone
                  }
                  tags
                  line_items {
                    ...LineItemQuerySpecConnectionFragment
                  
                    pageInfo {
                      ...PageInfoFragment
                    }
                    edges {
                      ...LineItemQuerySpecEdgeFragment
                    }
                    total_count
                  }
                  authorizations {
                    ...AuthorizationFragment
                  
                    transaction_id
                    authorized_amount
                    postauthed_amount
                    refunded_amount
                    card_type
                    date
                  }
                  holds {
                    ...OrderHoldsFragment
                  
                    fraud_hold
                    address_hold
                    shipping_method_hold
                    operator_hold
                    payment_hold
                    client_hold
                  }
                  shipments {
                    ...ShipmentFragment
                  
                    id
                    legacy_id
                    order_id
                    user_id
                    warehouse_id
                    pending_shipment_id
                    address {
                      ...AddressFragment
                    }
                    profile
                    picked_up
                    needs_refund
                    refunded
                    delivered
                    shipped_off_shiphero
                    dropshipment
                    completed
                    created_date
                    line_items {
                      ...ShipmentLineItemConnectionFragment
                    }
                    shipping_labels {
                      ...ShippingLabelFragment
                    }
                    warehouse {
                      ...WarehouseFragment
                    }
                    order {
                      ...OrderFragment
                    }
                    total_packages
                    ready_to_ship
                  }
                  returns {
                    ...ReturnFragment
                  
                    id
                    legacy_id
                    account_id
                    order_id
                    partner_id
                    reason
                    status
                    label_type
                    label_cost
                    labels {
                      ...RMALabelTypeFragment
                    }
                    cost_to_customer
                    shipping_carrier
                    shipping_method
                    dimensions {
                      ...DimensionsFragment
                    }
                    address {
                      ...AddressFragment
                    }
                    line_items {
                      ...ReturnLineItemFragment
                    }
                    total_items_expected
                    total_items_received
                    total_items_restocked
                    created_at
                    display_issue_refund
                    order {
                      ...OrderFragment
                    }
                    exchanges {
                      ...ReturnExchangeFragment
                    }
                    return_history {
                      ...ReturnHistoryFragment
                    }
                    attachments {
                      ...ReturnAttachmentFragment
                    }
                  }
                  rma_labels {
                    ...RMALabelFragment
                  
                    id
                    legacy_id
                    account_id
                    order_id
                    rma_id
                    shipment_id
                    shipping_name
                    tracking_number
                    status
                    carrier
                    shipping_method
                    cost
                    box_code
                    dimensions {
                      ...DimensionsFragment
                    }
                    address {
                      ...AddressFragment
                    }
                    paper_pdf_location
                    thermal_pdf_location
                    pdf_location
                    image_location
                    delivered
                    picked_up
                    refunded
                    needs_refund
                    profile
                    full_size_to_print
                    partner_fulfillment_id
                    created_at
                    updated_at
                  }
                  flagged
                  saturday_delivery
                  ignore_address_validation_errors
                  skip_address_validation
                  priority_flag
                  allocation_priority
                  allocations {
                    ...OrderWarehouseAllocationFragment
                  
                    order_id
                    warehouse_id
                    allocated_at
                    allocation_reference
                    ready_to_ship
                    line_items {
                      ...OrderLineItemAllocationFragment
                    }
                    is_locked
                  }
                  source
                  third_party_shipper {
                    ...OrderThirdPartyShipperFragment
                  
                    account_number
                    zip
                    country
                  }
                  gift_invoice
                  allow_partial
                  require_signature
                  adult_signature_required
                  alcohol
                  expected_weight_in_oz
                  insurance
                  insurance_amount
                  currency
                  has_dry_ice
                  allow_split
                  hold_until_date
                  incoterms
                  tax_id
                  tax_type
                  dry_ice_weight_in_lbs
                  ftr_exemption
                  ftr_exemption_value
                  address_is_business
                  tote_qa
                  do_not_print_invoice
                  ignore_payment_capture_errors
                  service_point_id
                  partner_source_name
                  order_history {
                    ...OrderHistoryFragment
                  
                    id
                    legacy_id
                    order_id
                    user_id
                    account_id
                    username
                    order_number
                    information
                    created_at
                    order {
                      ...OrderFragment
                    }
                  }
                  merged_orders {
                    ...MergedOrderFragment
                  
                    order_id
                    is_master
                  }
                  attachments {
                    ...OrderAttachmentQuerySpecConnectionFragment
                  
                    pageInfo {
                      ...PageInfoFragment
                    }
                    edges {
                      ...OrderAttachmentQuerySpecEdgeFragment
                    }
                    total_count
                  }
                  wholesale_order {
                    ...WholesaleOrderFragment
                  
                    id
                    legacy_id
                    version
                    fulfillment_flow
                    shipping_option
                    staging_location_id
                    picking_flow
                    outbound_progress
                    pickup_date
                    status
                    status_message
                    preparation_date
                    is_packed_externally
                    packing_layout
                    order_type
                    gs1_labels_required
                    trading_partner_id
                    trading_partner_name
                    store_location_number
                    store_address1
                    store_city
                    store_country
                    store_state
                    store_zip
                    distribution_center
                    distribution_center_number
                    purchase_order_type
                    vendor
                    vendor_id
                    requested_delivery_date
                    ship_not_before_date
                    ship_no_later_than_date
                    depositor_order_number
                    department
                    department_number
                    division
                    service_level
                    internal_supplier_number
                    terms_of_sale
                    retailer_notes
                    quote_number
                    sales_requirement_code
                    reference_fields
                    order_id
                    order {
                      ...OrderFragment
                    }
                    wholesale_shipping_details {
                      ...WholesaleShippingDetailsFragment
                    }
                    wholesale_line_items {
                      ...WholesaleLineItemsQuerySpecConnectionFragment
                    }
                  }
                }
                shipment_line_items {
                  ...ShipmentLineItemConnectionFragment
                
                  pageInfo {
                    ...PageInfoFragment
                  
                    hasNextPage
                    hasPreviousPage
                    startCursor
                    endCursor
                  }
                  edges {
                    ...ShipmentLineItemEdgeFragment
                  
                    node {
                      ...ShipmentLineItemFragment
                    }
                    cursor
                  }
                }
                package_number
                parcelview_url
                tracking_status
                in_shipping_container
                shipping_container_id
                last_mile_labels {
                  ...LastMileLabelFragment
                
                  id
                  legacy_id
                  shipping_carrier
                  shipping_method
                  tracking_number
                  tracking_url
                }
                serial_numbers {
                  ...LineItemSerialNumberFragment
                
                  id
                  legacy_id
                  sku
                  line_item_id
                  serial_number
                  scanned
                  created_at
                  updated_at
                }
              }
              cursor
            }
          }
          note
          needs_manifest
          created_at
          updated_at
          shipped_at
        }
        cursor
      }
      total_count
    }
  }
}

Variables

{
  "warehouse_id": "V2FyZWhvdXNlOjEyMzQ=",
  "carrier": "ups",
  "shipping_method": "ups_ground",
  "created_from": "2026-07-09T15:30:00Z",
  "created_to": "2026-07-09T15:30:00Z",
  "updated_from": "2026-07-09T15:30:00Z",
  "updated_to": "2026-07-09T15:30:00Z",
  "shipped_date_from": "2026-07-09T15:30:00Z",
  "shipped_date_to": "2026-07-09T15:30:00Z",
  "analyze": true
}

Response

{
  "data": {
    "shipping_containers": {
      "request_id": "UmVjb3JkOjEyMzQ=",
      "complexity": 100,
      "data": [{id: "U2hpcHBpbmdDb250YWluZXJDb25uZWN0aW9uOjEyMzQ="}]
    }
  }
}