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

# List HAWBs

> Paginated list of house air waybills for a shipment.

List HAWBs for a shipment. Deactivated HAWBs are hidden unless `includeInactive=true`.

### Path Parameters

<ParamField path="id" type="string" required>
  Shipment Public ID (`shp_…`).
</ParamField>

### Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number (minimum `1`).
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Page size (minimum `1`, maximum `100`).
</ParamField>

<ParamField query="includeInactive" type="boolean" default="false">
  Include deactivated HAWBs when `true`.
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "hawbId": "hawb_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
        "shipmentId": "shp_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
        "houseAirWaybillNumber": "HWB-101",
        "packageCount": 4,
        "grossWeightKg": 40,
        "status": "NOT_INITIATED",
        "isActive": true,
        "reportedStock": { "packageCount": 0, "grossWeightKg": 0 },
        "remainingStock": { "packageCount": 4, "grossWeightKg": 40 },
        "createdAt": "2026-06-10T08:30:00.000Z",
        "updatedAt": "2026-06-10T08:31:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>