Skip to main content
GET
/
2026-01
/
return
/
{id}
Get Return Order 
curl --request GET \
  --url https://sandbox-api.shipbob.com/2026-01/return/{id} \
  --header 'Authorization: Bearer <token>'
{
  "arrived_date": "2019-08-24T14:15:22Z",
  "awaiting_arrival_date": "2019-08-24T14:15:22Z",
  "cancelled_date": "2019-08-24T14:15:22Z",
  "channel": {
    "id": 0,
    "name": "string"
  },
  "completed_date": "2019-08-24T14:15:22Z",
  "customer_name": "string",
  "fulfillment_center": {
    "id": 0,
    "name": "string"
  },
  "id": 0,
  "insert_date": "2019-08-24T14:15:22Z",
  "inventory": [
    {
      "action_requested": {
        "action": "string",
        "action_type": "string",
        "instructions": "string"
      },
      "action_taken": [
        {
          "action": "string",
          "action_reason": "string",
          "image_url": "http://example.com",
          "quantity_processed": 0
        }
      ],
      "barcodes": [
        "string"
      ],
      "id": 0,
      "lot_information": {
        "expiration": "2019-08-24T14:15:22Z",
        "minimumShelfLife": 0,
        "number": "string"
      },
      "name": "string",
      "quantity": 0,
      "sku": "string"
    }
  ],
  "invoice": {
    "amount": 0.1,
    "currency_code": "string"
  },
  "original_shipment_id": 0,
  "processing_date": "2019-08-24T14:15:22Z",
  "reference_id": "string",
  "return_type": "string",
  "shipment_tracking_number": "string",
  "status": "string",
  "status_history": [
    {
      "status": "string",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ],
  "store_order_id": "string",
  "tracking_number": "string",
  "transactions": [
    {
      "amount": 0.1,
      "transaction_type": "string"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authentication using Personal Access Token (PAT) token

Headers

​
shipbob_channel_id
string<int32>

Channel Id for Operation

Path Parameters

​
id
string<int32>
required

The Id of the Return

Response

OK

The details of a public return order, including the transactions and inventory items

​
arrived_date
string<date-time> | null

The date and time when the return arrived at the fulfillment center

​
awaiting_arrival_date
string<date-time> | null

The date and time when the return entered Awaiting Arrival status

​
cancelled_date
string<date-time> | null

The date and time when the return was cancelled, if applicable

​
channel
object

The details of a Channel

​
completed_date
string<date-time> | null

The date and time for when the return order was completely processed

​
customer_name
string | null

Name of merchant that return belongs to

​
fulfillment_center
object

The details of a Fulfillment Center

​
id
integer<int32>

Unique id of the return order

​
insert_date
string<date-time>

The date and time for when the return order was created

​
inventory
object[] | null

List of inventory items in return order

​
invoice
object

The invoice amount and curency

​
original_shipment_id
integer<int32> | null

ShipmentId for which return was created

​
processing_date
string<date-time> | null

The date and time when the return started processing

​
reference_id
string | null

Unique reference id of the return order. Created by merchant if a regular return.

​
return_type
string | null

Type of the return, i.e. Regular, RTS

​
shipment_tracking_number
string | null

The tracking number of the original shipment

​
status
string | null

Status of the return order, i.e. Awaiting Arrival, Arrived, Processing, Completed Cancelled

​
status_history
object[] | null

List of status history in return order

​
store_order_id
string | null

Reference to external order id

​
tracking_number
string | null

The tracking number of the return shipping label

​
transactions
object[] | null

List of transactions that make up the billable amount to invoice a merchant