Get Return Order | ShipBob Developer API

{
  "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
        }
      ],
      "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"
    }
  ]
}

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Path parameters

idstringRequiredformat: "int32"

The Id of the Return

Response

Success

arrived_datedatetime or nullOptional

awaiting_arrival_datedatetime or nullOptional

cancelled_datedatetime or nullOptional

channelobjectOptional

completed_datedatetime or nullOptional

customer_namestring or nullOptional

fulfillment_centerobjectOptional

idintegerOptional

insert_datedatetimeOptional

inventorylist of objects or nullOptional

invoiceobjectOptional

original_shipment_idinteger or nullOptional

processing_datedatetime or nullOptional

reference_idstring or nullOptional

return_typestring or nullOptional

shipment_tracking_numberstring or nullOptional

statusstring or nullOptional

status_historylist of objects or nullOptional

store_order_idstring or nullOptional

tracking_numberstring or nullOptional

transactionslist of objects or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl https://api.shipbob.com/2025-07/return/id \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Response

Errors