# Get AWB by ID

**Method:** `GET`

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

**Category:** International Payments

**Authentication:** Required

## Description

Retrieves a single AWB record by its ID.


## Path Parameters

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

## Responses

- `200` — AWB retrieved successfully.
- `400` — Bad Request — Validation error.
- `404` — Not Found — AWB not found.
- `500` — 

### Response Schema

- `awb_id` (`string`) — Unique AWB ID generated by Pinelabs in response to AWB creation.
- `order_id` (`string`) — Order ID.
- `invoice_id` (`string`) — Associated invoice ID.
- `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. - AWB_CAPTURED — Metadata captured, file upload pending - AWB_UPLOADED — File uploaded successfully - AWB_REJECTED — Rejected by bank/payment partner 
- `created_at` (`string`) — ISO 8601 timestamp of creation.
- `updated_at` (`string`) — ISO 8601 timestamp of last update.

### Example Response

```json
{
  "awb_id": "awb-260522-001",
  "order_id": "v1-260520225359-aa-LHy288",
  "invoice_id": "inv-260520225359-ab-XyZ123",
  "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-awb-by-id