Get Order

GET /2025-07/order/{orderId}

Get Order

cURL

curl --request GET \
  --url https://api.shipbob.com/2025-07/order/{orderId} \
  --header 'Authorization: Bearer <token>'

200

{
  "channel": {
    "id": 0,
    "name": "ShipBobs-Shopify-Store"
  },
  "created_date": "2019-08-24T14:15:22Z",
  "financials": {
    "total_price": 0.1
  },
  "gift_message": "string",
  "id": 0,
  "order_number": "string",
  "products": [
    {
      "external_line_id": 0,
      "gtin": "string",
      "id": 0,
      "quantity": 0,
      "quantity_unit_of_measure_code": "string",
      "reference_id": "TShirtBlueM",
      "sku": "TShirtBlueM",
      "unit_price": 0.1,
      "upc": "string"
    }
  ],
  "purchase_date": "2019-08-24T14:15:22Z",
  "recipient": {
    "address": {
      "address1": "100 Nowhere Blvd",
      "address2": "Suite 100",
      "city": "Gotham City",
      "company_name": "Wayne Enterprises",
      "country": "US",
      "state": "NJ",
      "zip_code": "07093"
    },
    "email": "[e-mail]",
    "name": "John Doe",
    "phone_number": "555-555-5555"
  },
  "reference_id": "string",
  "retailer_program_data": {
    "addresses": [
      {
        "address1": "100 Nowhere Blvd",
        "address2": "Suite 100",
        "city": "Gotham City",
        "company_name": "Wayne Enterprises",
        "country": "US",
        "state": "NJ",
        "type": "MarkFor",
        "zip_code": "07093"
      }
    ],
    "customer_ticket_number": "string",
    "delivery_date": "2019-08-24T14:15:22Z",
    "department": "string",
    "doNotShipBeforeDate": "2019-08-24T14:15:22Z",
    "mark_for_store": "string",
    "purchase_order_number": "string",
    "retailer_program_type": "string",
    "shipByDate": "2019-08-24T14:15:22Z"
  },
  "shipments": [
    {
      "actual_fulfillment_date": "2019-08-24T14:15:22Z",
      "created_date": "2019-08-24T14:15:22Z",
      "delivery_date": "2019-08-24T14:15:22Z",
      "estimated_fulfillment_date": "2019-08-24T14:15:22Z",
      "estimated_fulfillment_date_status": "AwaitingInventoryAllocation",
      "gift_message": "string",
      "id": 0,
      "insurance_value": 0,
      "invoice_amount": 0,
      "invoice_currency_code": "string",
      "is_tracking_uploaded": true,
      "last_tracking_update_at": "2019-08-24T14:15:22Z",
      "last_update_at": "2019-08-24T14:15:22Z",
      "location": {
        "id": 0,
        "name": "Cicero (IL)"
      },
      "measurements": {
        "depth_in": 0,
        "length_in": 0,
        "total_weight_oz": 0,
        "width_in": 0
      },
      "order_id": 0,
      "package_material_type": "Unknown",
      "parent_cartons": [
        {
          "barcode": "string",
          "cartons": [
            {
              "barcode": "string",
              "carton_details": [
                {
                  "products": [
                    {
                      "id": 0,
                      "inventory_items": [
                        {
                          "expiration_date": "2019-08-24T14:15:22Z",
                          "id": 0,
                          "is_dangerous_goods": true,
                          "lot": "22222",
                          "name": "Medium Blue T-Shirt",
                          "quantity": 0,
                          "quantity_committed": 0,
                          "serial_numbers": [
                            "string"
                          ]
                        }
                      ],
                      "name": "Medium Blue T-Shirt",
                      "reference_id": "TShirtBlueM",
                      "sku": "TShirtBlueM"
                    }
                  ]
                }
              ],
              "id": 0,
              "measurements": {
                "depth_in": 0.1,
                "length_in": 0.1,
                "total_weight_oz": 0.1,
                "width_in": 0.1
              },
              "type": "Box or pallet"
            }
          ],
          "measurements": {
            "depth_in": 0.1,
            "length_in": 0.1,
            "total_weight_oz": 0.1,
            "width_in": 0.1
          },
          "type": "Box or pallet"
        }
      ],
      "products": [
        {
          "id": 0,
          "inventory_items": [
            {
              "expiration_date": "2019-08-24T14:15:22Z",
              "id": 0,
              "is_dangerous_goods": true,
              "lot": "22222",
              "name": "Medium Blue T-Shirt",
              "quantity": 0,
              "quantity_committed": 0,
              "serial_numbers": [
                "string"
              ]
            }
          ],
          "name": "Medium Blue T-Shirt",
          "reference_id": "TShirtBlueM",
          "sku": "TShirtBlueM"
        }
      ],
      "recipient": {
        "address": {
          "address1": "100 Nowhere Blvd",
          "address2": "Suite 100",
          "city": "Gotham City",
          "company_name": "Wayne Enterprises",
          "country": "US",
          "state": "NJ",
          "zip_code": "07093"
        },
        "email": "[e-mail]",
        "full_name": "John Doe",
        "name": "John Doe",
        "phone_number": "555-555-5555"
      },
      "reference_id": "string",
      "require_signature": true,
      "ship_option": "Standard",
      "status": "None",
      "status_details": [
        {
          "description": "string",
          "exception_fulfillment_center_id": 0,
          "extra_information": {
            "validation_messages": [
              "string"
            ]
          },
          "id": 0,
          "inventory_id": 0,
          "name": "string"
        }
      ],
      "tracking": {
        "bol": "string",
        "carrier": "USPS",
        "carrier_service": "Priority",
        "pro_number": "string",
        "scac": "string",
        "shipping_date": "2019-08-24T14:15:22Z",
        "tracking_number": "860C8CDC8F0B4FC7AB69AC86C20539EC",
        "tracking_url": "https://www.example.com/tracking?id=860C8CDC8F0B4FC7AB69AC86C20539EC"
      }
    }
  ],
  "shipping_method": "Free 2-day Shipping",
  "shipping_terms": {
    "carrier_type": "Parcel",
    "payment_term": "Collect"
  },
  "status": "Processing",
  "tags": [
    {
      "name": "Handling instructions",
      "value": "Fragile"
    }
  ],
  "type": "DTC"
}

Authorizations

Authorization · string · header · required

Authentication using Personal Access Token (PAT) token

Headers

shipbob_channel_id · string<int32>

Channel Id for Operation

Path Parameters

orderId · string<int32> · required

Response

200

application/json

Success

channel · object

Created by channel metadata

Show child attributes

created_date · string<date-time>

Date this order was created

financials · object

Show child attributes

gift_message · string | null

Gift message associated with the order

id · integer<int32>

Unique id of the order

order_number · string | null

User friendly orderId or store order number that will be shown on the Orders Page. If not provided, referenceId will be used

products · object[] | null

List of products included in the order

Show child attributes

purchase_date · string<date-time> | null

Date this order was purchase by the end user

recipient · object

Information about the recipient of an order

Show child attributes

reference_id · string | null

Client-defined external unique id of the order

retailer_program_data · object

Contains properties that needs to be used for fulfilling B2B/Dropship orders.

Show child attributes

shipments · object[] | null

Shipments affiliated with the order

Information about a shipment

Option 1

Option 2

Show child attributes

shipping_method · string | null

Client-defined shipping method

Example:

"Free 2-day Shipping"

shipping_terms · object

Contains shipping properties that need to be used for fulfilling an order.

Show child attributes

status · enum<string>

Available options: Processing, Exception, PartiallyFulfilled, Fulfilled, Cancelled, ImportReview

tags · object[] | null

Client-defined order tags

Show child attributes

type · enum<string>

Available options: DTC, DropShip, B2B