Skip to main content
PUT
/
2026-01
/
return
/
{id}
Edit a return.
curl --request PUT \
  --url https://gateway-dev.shipbob.dev/2026-01/return/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fulfillment_center": {
    "id": 0,
    "name": "string"
  },
  "inventory": [
    {
      "id": 0,
      "lot_date": "2019-08-24T14:15:22Z",
      "lot_number": "string",
      "quantity": 0,
      "requested_action": 0
    }
  ],
  "original_shipment_id": 0,
  "reference_id": "string",
  "tracking_number": "string"
}
'
{
  "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
        }
      ],
      "id": 0,
      "name": "string",
      "quantity": 0
    }
  ],
  "invoice_amount": 0.1,
  "original_shipment_id": 0,
  "reference_id": "string",
  "return_type": "string",
  "status": "string",
  "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

Path Parameters

id
string<int32>
required

Body

application/json
fulfillmentCenter
object
inventory
object[] | null
originalShipmentId
integer<int32> | null
referenceId
string | null
trackingNumber
string | null

Response

Success

channel
object
completedDate
string<date-time> | null
customerName
string | null
fulfillmentCenter
object
id
integer<int32>
insertDate
string<date-time>
inventory
object[] | null
invoiceAmount
number<double> | null
originalShipmentId
integer<int32> | null
referenceId
string | null
returnType
string | null
status
string | null
storeOrderId
string | null
trackingNumber
string | null
transactions
object[] | null