> ## Documentation Index
> Fetch the complete documentation index at: https://docs.itshandled.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Return Packages

> Retrieve all return packages with filtering and pagination

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN',
      'Content-Type': 'application/json'
    }
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://y5owe.hatchboxapp.com/v1/accounts/123/return_packages',
      headers={
          'Authorization': 'Bearer YOUR_API_TOKEN',
          'Content-Type': 'application/json'
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": 789,
        "return_id": 456,
        "tracking_number": "1Z999AA10123456784",
        "status": "in_transit",
        "estimated_arrival": "2024-01-20T00:00:00Z",
        "weight": 2.5,
        "weight_unit": "lb",
        "dimensions": {
          "length": 12,
          "width": 10,
          "height": 8,
          "dimension_unit": "in"
        },
        "carrier": {
          "id": 1,
          "name": "UPS",
          "service": "Ground"
        },
        "location_id": 1,
        "fulfillment_center_id": 1,
        "line_items_count": 3,
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-01-18T14:30:00Z"
      }
    ],
    "meta": {
      "current_page": 1,
      "total_pages": 5,
      "total_count": 100,
      "per_page": 20
    }
  }
  ```
</ResponseExample>