Skip to main content
GET
/
accounts
/
{account_id}
/
return_packages
/
{id}
curl -X GET https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages/789 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "id": 789,
  "return_id": 456,
  "tracking_number": "1Z999AA10123456784",
  "status": "received",
  "carrier_id": 1,
  "carrier": {
    "id": 1,
    "name": "UPS",
    "code": "ups"
  },
  "location_id": 1,
  "fulfillment_center_id": 1,
  "estimated_arrival": "2024-01-20T00:00:00Z",
  "actual_arrival": "2024-01-19T14:30: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",
  "line_items": [
    {
      "id": 1234,
      "return_line_item_id": 5678,
      "quantity": 2,
      "merchant_sku": "SKU-123",
      "name": "Product Name",
      "condition": "good",
      "defective": false,
      "notes": "Minor scratches on surface",
      "barcode": "123456789012",
      "tags": ["inspected", "resellable"]
    }
  ],
  "media_files": [
    {
      "id": 9876,
      "url": "https://cdn.itshandled.ai/packages/789/image1.jpg",
      "type": "image",
      "created_at": "2024-01-19T14:35:00Z"
    }
  ],
  "processed_at": "2024-01-19T15:00:00Z",
  "processor_id": 321,
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-19T15:00:00Z"
}

curl -X GET https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages/789 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "id": 789,
  "return_id": 456,
  "tracking_number": "1Z999AA10123456784",
  "status": "received",
  "carrier_id": 1,
  "carrier": {
    "id": 1,
    "name": "UPS",
    "code": "ups"
  },
  "location_id": 1,
  "fulfillment_center_id": 1,
  "estimated_arrival": "2024-01-20T00:00:00Z",
  "actual_arrival": "2024-01-19T14:30: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",
  "line_items": [
    {
      "id": 1234,
      "return_line_item_id": 5678,
      "quantity": 2,
      "merchant_sku": "SKU-123",
      "name": "Product Name",
      "condition": "good",
      "defective": false,
      "notes": "Minor scratches on surface",
      "barcode": "123456789012",
      "tags": ["inspected", "resellable"]
    }
  ],
  "media_files": [
    {
      "id": 9876,
      "url": "https://cdn.itshandled.ai/packages/789/image1.jpg",
      "type": "image",
      "created_at": "2024-01-19T14:35:00Z"
    }
  ],
  "processed_at": "2024-01-19T15:00:00Z",
  "processor_id": 321,
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-19T15:00:00Z"
}