Skip to main content
POST
/
accounts
/
{account_id}
/
return_packages
curl -X POST https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "return_id": 456,
    "tracking_number": "1Z999AA10123456784",
    "estimated_arrival": "2024-01-20T00:00:00Z",
    "shipping_method": "ground",
    "weight": 2.5,
    "weight_unit": "lb",
    "width": 10,
    "height": 8,
    "length": 12,
    "dimension_unit": "in",
    "shipping_label_cost": 15.99,
    "shipping_label_cost_currency": "USD",
    "carrier_id": 1,
    "location_id": 1,
    "status": "in_transit"
  }'

{
  "id": 789,
  "return_id": 456,
  "tracking_number": "1Z999AA10123456784",
  "status": "in_transit",
  "carrier_id": 1,
  "location_id": 1,
  "estimated_arrival": "2024-01-20T00:00:00Z",
  "shipping_method": "ground",
  "weight": 2.5,
  "weight_unit": "lb",
  "dimensions": {
    "length": 12,
    "width": 10,
    "height": 8,
    "dimension_unit": "in"
  },
  "shipping_label_cost": 15.99,
  "shipping_label_cost_currency": "USD",
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-15T10:00:00Z"
}

curl -X POST https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "return_id": 456,
    "tracking_number": "1Z999AA10123456784",
    "estimated_arrival": "2024-01-20T00:00:00Z",
    "shipping_method": "ground",
    "weight": 2.5,
    "weight_unit": "lb",
    "width": 10,
    "height": 8,
    "length": 12,
    "dimension_unit": "in",
    "shipping_label_cost": 15.99,
    "shipping_label_cost_currency": "USD",
    "carrier_id": 1,
    "location_id": 1,
    "status": "in_transit"
  }'

{
  "id": 789,
  "return_id": 456,
  "tracking_number": "1Z999AA10123456784",
  "status": "in_transit",
  "carrier_id": 1,
  "location_id": 1,
  "estimated_arrival": "2024-01-20T00:00:00Z",
  "shipping_method": "ground",
  "weight": 2.5,
  "weight_unit": "lb",
  "dimensions": {
    "length": 12,
    "width": 10,
    "height": 8,
    "dimension_unit": "in"
  },
  "shipping_label_cost": 15.99,
  "shipping_label_cost_currency": "USD",
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-15T10:00:00Z"
}