Get Reservation List by Contact ID

This API operation retrieves all active reservations for the specified contact within the given locker bank. Use this API to view all locker units currently reserved for a particular recipient or department.

SecuritybearerAuth

Request

path Parameters

lockerBankId required	string The unique identifier of the locker bank from which reservation details must be retrieved.
contactId required	string The identifier of the contact (recipient or department) whose reservation details are requested.

Responses

200

All active reservations for the specified contact has been fetched successfully.

401

The request could not be authorized.

404

The requested resource was not found.

500

The request could not be completed due to an internal error.

get/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/contact/{contactId}

Request samples

Response samples

application/json

{"reservedUnits": [{"lockerBankId": "AOne",
"lockerUnitId": "2",
"size": "small",
"accessible": true,
"unitInService": true,
"unitReserved": true,
"unitOccupied": true,
"parcelsReserved": [{"trackingNumber": "26112025_6",
"secondaryTrackingNumber": "string"
}
],
"parcelsDeposited": [{"trackingNumber": "26112025_6",
"secondaryTrackingNumber": "string"
}
],
"contactId": "684a6b7bbc85e1bce7392b9e",
"contactType": "recipient",
"contactName": "User Name",
"reservationTime": "2025-11-12T16:13:06Z",
"reservationExpiryTime": "2025-12-19T09:59:00Z",
"depositTime": "2025-11-17T14:28:37Z",
"depositExpiryTime": "2025-11-30T14:28:37Z"
}
]
}