# Get All AWBs

**Method:** `GET`

**Path:** `/api/pay/v1/orders/{orderId}/awb`

**Category:** International Payments

**Authentication:** Required

## Description

Retrieves all AWB records and their statuses for a given order.
Returns an empty list (`total: 0`) if no AWB records exist for the order.


## Path Parameters

- `orderId` (`string`) **required** — Order ID returned from Create Order API.

## Responses

- `200` — AWBs retrieved successfully.
- `400` — Bad Request — Validation error.
- `500` — 

### Response Schema

- `order_id` (`string`) — Order ID.
- `invoice_id` (`string`) — Associated invoice ID.
- `invoice_number` (`string`) — Associated invoice number.
- `total` (`integer`) — Total number of AWB records for this order.
- `awb_mappings` (`AwbListItem[]`)
  - `awb_id` (`string`) — Unique AWB ID generated by Pinelabs in response to AWB creation.
  - `awb_number` (`string`) — Unique AWB number shared by the merchant in the request.
  - `awb_date` (`string`) — AWB date.
  - `status` (`AWB_CAPTURED | AWB_UPLOADED | AWB_REJECTED`) — Current AWB status.
  - `created_at` (`string`) — ISO 8601 timestamp of creation.
  - `updated_at` (`string`) — ISO 8601 timestamp of last update.


### Example Response

```json
{
  "order_id": "v1-260520225359-aa-LHy288",
  "invoice_id": "inv-260520225359-ab-XyZ123",
  "invoice_number": "v1-260520225359-aa-LHy288-IN",
  "total": 2,
  "awb_mappings": [
    {
      "awb_id": "awb-260522-001",
      "awb_number": "AWB-2026-001",
      "awb_date": "2026-05-22",
      "status": "AWB_UPLOADED",
      "created_at": "2026-05-22T10:30:00.000Z",
      "updated_at": "2026-05-22T11:00:00.000Z"
    }
  ]
}
```

---

Reference: https://localhost:3000/api/international-payments/get-all-awbs
