Creates a new reservation for a locker

Creates a reservation for a locker in the specified locker bank.

SecuritybearerAuth
Request
path Parameters
lockerBankId
required
string

This is the unique identifier of the locker bank.

Request Body schema: application/json

Create a reservation

userId
required
string

Identifier of the user performing the locker reservation action.

size
required
string

Requested locker size for the reservation (e.g., small, medium). The available sizes will be retrieved.

Enum: "small" "medium" "large" "mlarge"
accessible
boolean

Requests a locker that would be deemed handicapped accesible to recipients.

contactId
required
string

Identifier of the recipient of the package for whom the locker reservation is created.

contactType
required
string

Source type of the recipient identifier.

Enum: "recipient" "department"
trackingNumber
required
string

The primary identifier of a package, usually a carrier's tracking number.

secondaryTrackingNumber
string

A secondary identifier for a package, can be generated internally.

Responses
200

Successful operation

400

Invalid request.

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.

post/api/v1/lockerBanks/{lockerBankId}/lockers/reserve
Request samples
application/json
{
  • "userId": "thirdpartyuser@gmail.com",
  • "size": "small",
  • "accessible": true,
  • "contactId": "684a6b7bbc85e1bce7392b9e",
  • "contactType": "recipient",
  • "trackingNumber": "TrackigID137",
  • "secondaryTrackingNumber": "Piece1_PBIL"
}
Response samples
application/json
{
  • "lockerBankId": "Axxx",
  • "lockerUnitId": "2",
  • "size": "small",
  • "contactId": "684a6b7bbc85e1bce7392b9e",
  • "contactType": "recipient",
  • "trackingNumber": "TrackigID137",
  • "secondaryTrackingNumber": "Piece1_PBIL"
}