{"items":[{"type":"link","label":"Pitney Locker APIs","link":"/openapi/lockers","routeSlug":"/openapi/lockers","content":{"contentType":"overview","meta":{"name":"Pitney Locker APIs"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"lockers.json","url":"/_bundle/openapi/lockers.json?download"},{"kind":"download","label":"lockers.yaml","url":"/_bundle/openapi/lockers.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Pitney Locker APIs (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Pitney Locker APIs help manage smart locker operations for package delivery, returns, and asset drop-off workflows. These APIs allow external organizations to automate secure, contactless locker operations by integrating with Pitney Bowes smart lockers."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By integrating these APIs into your system, you can automate end-to-end locker workflows—from retrieving available locker banks and reserving locker units to remotely opening lockers, depositing packages, retrieving reservation details and releasing locker units after use ."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why Use Pitney Locker APIs"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable contactless, secure package deliveries"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automate locker assignment and release"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Support forward delivery and return/drop-off workflows"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Track which locker unit is assigned to which package"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Simplify mailroom or internal delivery operations"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve locker availability and locker status information"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How Pitney Locker APIs Work"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Pitney Locker APIs are designed to manage smart locker workflows—from retrieving available locker banks and reserving locker units to depositing packages and freeing locker units after completion."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The APIs support two primary workflows:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forward delivery workflow (transactionType: deliver)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return or asset drop-off workflow (transactionType: return)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A user (typically a mailroom operator or system) can use these APIs to:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Look up locker banks"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check available locker unit sizes"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reserve locker units"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Open locker units remotely"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deposit packages into locker units"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve reservation details"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Free locker units after use"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monitor locker unit operational status"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step-by-Step Workflow for Pitney Locker APIs"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 1: Retrieve Available Locker Banks"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-bank/getlockerbanks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Locker Banks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-bank/getlockerbankdetails"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Locker Bank by Locker Bank ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" APIs to retrieve the list of available locker banks at a facility."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"locationId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": To get lockers for a specific location"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": To retrieve a specific locker bank by ID. One location can have multiple banks."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each locker bank has a unique "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", used in subsequent API calls."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 2: Get Locker Sizes for a Locker Bank"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-bank/lockersizes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Locker Sizes API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve the available locker unit sizes in a locker bank (e.g., small, medium, large) along with their availability status."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need to pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" retrieved in Step 1 as a path parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 3: Reserve a Locker Unit"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Once you know a locker unit is available, use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/createreservation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reserve Locker Unit API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create a reservation."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This workflow is typically used for forward delivery operations and internally uses "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionType: deliver"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required fields include:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Package tracking number"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locker size preference (e.g., small)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Recipient identification (contact ID and type)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reservation Expiry Time"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a locker is successfully reserved, a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"locker unit ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned in the response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return and Asset Drop-off Reservations"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For return or asset drop-off workflows, use the Create Return Reservation API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This workflow uses "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transactionType: return"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In this workflow a depositor places a package or asset into a locker. The reservation details include the intended receiving contact (e.g., store or department) and the depositor contact (e.g., customer or recipient) who will drop off the package or asset. Once the reservation is created, the depositor can use the provided locker unit information to complete the return drop-off, and the receiving contact can retrieve the item from the locker for processing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reservation can include:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Receiving contact information"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Depositor contact information"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tracking details"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reservation expiry information"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 4: Open a Locker Unit"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the Open Locker Unit API to remotely unlock a locker unit before package deposit or return drop-off operations. This API is used by mailroom operators or authorized users to open the locker unit door for secure, contactless package handling."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 5: Add or Update Deposit Information"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After reserving the locker unit, deposit the parcel inside the locker using "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/updatedeposit"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add/Update Deposit API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Using the same API, user can update the deposit information for example userId of the user."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This updates the locker reservation to reflect:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parcel successfully deposited"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deposit timestamp"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"depositExpiryTime (Once expired, the parcel may be removed or handled according to facility policy.)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parcel pickup code (Pickup Code will only be provided to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contactType: recipient"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contactType: department"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the recipients will pick the parcel by providing their "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personalId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need to pass:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 6: Retrieve Reservation Details"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These APIs help external systems, operators, or recipients retrieve reservation details."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/getreservationlist"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Reservations by Contact"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Retrieve all reservations linked to a specific recipient/contact."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/getreservation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Reservation by Tracking Number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Retrieve reservation details using the package tracking number."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 7: Update Reservation"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If reservation details need to be changed (e.g., expiry time, contact details, metadata), use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/updatereservation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update Reservation API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need to pass:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step 7: Free the Reserved Locker Unit"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/lockers/locker-unit/freereservation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Free Reserved Locker Unit API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to cancel the existing reservation. This makes the locker unit available for the next package."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need to pass:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerBankId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unit to be freed - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (path parameter)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Some Pitney Locker workflows require recipient, department, or depositor contact details. These contacts are managed through the Address Book APIs. For more information, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/addressbook/contact/addcontact"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Address Book APIs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/openapi/lockers"}],"sectionId":"/openapi/lockers"}]}]}},{"type":"group","label":"Locker Bank","link":"/openapi/lockers/locker-bank","routeSlug":"/openapi/lockers/locker-bank","items":[{"label":"Get List of all Locker Banks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-bank/getlockerbanks","routeSlug":"/openapi/lockers/locker-bank/getlockerbanks","metadata":{"seo":{"title":"Get List of all Locker Banks","description":"This API operation returns a list of all available locker banks where packages can be deposited for recipient pickup."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLockerBanks","name":"Get List of all Locker Banks","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get List of all Locker Banks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation returns a list of all available locker banks where packages can be deposited for recipient pickup."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"skip","in":"query","schemaId":"schema_271","description":"The number of records to skip in the returned list. Default is 0."},{"name":"limit","in":"query","schemaId":"schema_272","description":"The maximum number of locker banks to return in the response. Default is 100."},{"name":"locationId","in":"query","schemaId":"schema_273","description":" Filters the locker banks by the specific location ID where the lockers are placed."},{"name":"lockerBankId","in":"query","schemaId":"schema_274","description":"Filters the locker banks by the specific locker bank ID."}],"pointer":"/paths/~1api~1v1~1lockerBanks/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-PB-Developer-Partner-ID","in":"header","schemaId":"schema_275","description":"The Developer Partner ID is assigned by PB to uniquely identify a Developer's strategic business partners. If the developer is the sole business partner, this field isn't required."}],"pointer":"/paths/~1api~1v1~1lockerBanks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[],"query":[{"name":"skip","in":"query","required":false,"example":"0","schemaId":"schema_271"},{"name":"limit","in":"query","required":false,"example":"100","schemaId":"schema_272"},{"name":"locationId","in":"query","required":false,"example":"loc_auto_sa5cxxx","schemaId":"schema_273"},{"name":"lockerBankId","in":"query","required":false,"example":"AOne","schemaId":"schema_274"}],"querystring":[],"header":[{"name":"X-PB-Developer-Partner-ID","in":"header","required":false,"example":"PB123456","schemaId":"schema_275"}],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/api/v1/lockerBanks","href":"locker-bank/getlockerbanks","openApiOperationId":"getLockerBanks","summary":"Get List of all Locker Banks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the list of locker banks.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerBankResponse"}},"schemaId":"components/schemas/LockerBankResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerBankResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerBankResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-bank/getlockerbanks"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks"},{"label":"List of Locker Sizes in a Locker Bank","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-bank/lockersizes","routeSlug":"/openapi/lockers/locker-bank/lockersizes","metadata":{"seo":{"title":"List of Locker Sizes in a Locker Bank","description":"This API operation returns all available locker sizes in the specified locker bank to help select an appropriate size for reservations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"lockerSizes","name":"List of Locker Sizes in a Locker Bank","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1sizes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List of Locker Sizes in a Locker Bank","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation returns all available locker sizes in the specified locker bank to help select an appropriate size for reservations."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the locker bank whose locker sizes you want to retrieve. Use the value returned by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Get list of all locker banks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" API."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1sizes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/sizes","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/sizes","href":"locker-bank/lockersizes","openApiOperationId":"lockerSizes","summary":"List of Locker Sizes in a Locker Bank"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved locker sizes for the locker bank.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerSizesResponse"}},"schemaId":"components/schemas/LockerSizesResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"Locker bank not found"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1sizes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerSizesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerSizesResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404"},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-bank/lockersizes"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/sizes"},{"label":"Get Locker Bank by Locker Bank ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-bank/getlockerbankdetails","routeSlug":"/openapi/lockers/locker-bank/getlockerbankdetails","metadata":{"seo":{"title":"Get Locker Bank by Locker Bank ID","description":"This API operation retrieves detailed information for the specified locker bank along with the list of locker units."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLockerBankDetails","name":"Get Locker Bank by Locker Bank ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Locker Bank by Locker Bank ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation retrieves detailed information for the specified locker bank along with the list of locker units."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"Filters the locker banks by the specific locker bank ID.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks/{lockerBankId}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}","href":"locker-bank/getlockerbankdetails","openApiOperationId":"getLockerBankDetails","summary":"Get Locker Bank by Locker Bank ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Specified locker bank details has been retrived successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerBankDetailsResponse"}},"schemaId":"components/schemas/LockerBankDetailsResponse"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerBankDetailsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerBankDetailsResponse"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-bank/getlockerbankdetails"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}"}],"content":{"contentType":"group","meta":{"name":"Locker Bank"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Locker Bank","showPageActions":true},{"nodeType":"markdoc","content":"APIs for retrieving and managing locker bank information. Locker banks represent physical installations of smart lockers at specific locations. These APIs support operations such as listing available locker banks, retrieving locker bank details, and fetching available locker unit sizes within a bank. The returned lockerBankId is required for all subsequent locker unit operations."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/lockerBanks","summary":"Get List of all Locker Banks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-bank/getlockerbanks","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/sizes","summary":"List of Locker Sizes in a Locker Bank","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-bank/lockersizes","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}","summary":"Get Locker Bank by Locker Bank ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-bank/getlockerbankdetails","deprecated":false}]}]}]}]}},{"type":"group","label":"Locker Unit","link":"/openapi/lockers/locker-unit","routeSlug":"/openapi/lockers/locker-unit","items":[{"label":"Creates a new Reservation for a Locker","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/createreservation","routeSlug":"/openapi/lockers/locker-unit/createreservation","metadata":{"seo":{"title":"Creates a new Reservation for a Locker","description":"This API operation creates a reservation for a locker unit in the specified locker bank."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createReservation","name":"Creates a new Reservation for a Locker","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserve/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Creates a new Reservation for a Locker","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API operation creates a reservation for a locker unit in the specified locker bank."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locker selection rules"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, the system reserves that exact locker."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, the system selects any available locker of that size."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If both are provided, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes precedence and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ignored."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"This is the unique identifier of the locker bank.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserve/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LockerReservationRequest"}},"schemaId":"components/schemas/LockerReservationRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserve/post/requestBody","description":"Create a reservation"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserve","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/LockerReservationRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserve","href":"locker-unit/createreservation","openApiOperationId":"createReservation","summary":"Creates a new Reservation for a Locker"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/LockerReservationRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LockerReservationRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerReservationResponse"}},"schemaId":"components/schemas/LockerReservationResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserve/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerReservationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerReservationResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/createreservation"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserve"},{"label":"Create a return reservation","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/createreturnreservation","routeSlug":"/openapi/lockers/locker-unit/createreturnreservation","metadata":{"seo":{"title":"Create a return reservation","description":"Creates a locker reservation for a return or asset drop-off. Use this endpoint when the depositor needs to place a package or asset into a locker for pickup by a courier, or operations team. The reservation details include the intended receiving contact (e.g., store or department) and the depositor contact (e.g., customer or recipient) who will drop off the package or asset. Once the reservation is created, the depositor can use the provided locker unit information to complete the return drop-off, and the receiving contact can retrieve the item from the locker for processing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createReturnReservation","name":"Create a return reservation","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1asset~1reserve/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a return reservation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a locker reservation for a return or asset drop-off. Use this endpoint when the depositor needs to place a package or asset into a locker for pickup by a courier, or operations team. The reservation details include the intended receiving contact (e.g., store or department) and the depositor contact (e.g., customer or recipient) who will drop off the package or asset. Once the reservation is created, the depositor can use the provided locker unit information to complete the return drop-off, and the receiving contact can retrieve the item from the locker for processing."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the return locker is reserved.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1asset~1reserve/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LockerAssetReservationRequest"}},"schemaId":"components/schemas/LockerAssetReservationRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1asset~1reserve/post/requestBody","description":"Return reservation details, including the intended receiving contact and the depositor contact who will drop off the package or asset."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/asset/reserve","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/LockerAssetReservationRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/asset/reserve","href":"locker-unit/createreturnreservation","openApiOperationId":"createReturnReservation","summary":"Create a return reservation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/LockerAssetReservationRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LockerAssetReservationRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Return reservation created successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerAssetReservationResponse"}},"schemaId":"components/schemas/LockerAssetReservationResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1asset~1reserve/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerAssetReservationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerAssetReservationResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/createreturnreservation"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/asset/reserve"},{"label":"Open a locker unit","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/openlockerunit","routeSlug":"/openapi/lockers/locker-unit/openlockerunit","metadata":{"seo":{"title":"Open a locker unit","description":"Opens a specific locker unit remotely in the specified locker bank. Use this endpoint when an authorized user needs to unlock a locker unit for package deposit or return drop-off.Note: This API returns a success response only when the locker hardware is configured."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"openLockerUnit","name":"Open a locker unit","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1open/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Open a locker unit","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Opens a specific locker unit remotely in the specified locker bank. Use this endpoint when an authorized user needs to unlock a locker unit for package deposit or return drop-off."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API returns a success response only when the locker hardware is configured."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the locker unit is located.","required":true},{"name":"lockerUnitId","in":"path","schemaId":"schema_276","description":"The unique identifier of the locker unit to open.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1open/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_277"}},"schemaId":"schema_277","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1open/post/requestBody","description":"Open locker request details, including the user performing the action."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/open","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"lockerUnitId","in":"path","required":true,"example":"2","schemaId":"schema_276"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_277"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/open","href":"locker-unit/openlockerunit","openApiOperationId":"openLockerUnit","summary":"Open a locker unit"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"schema_277","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_277"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Locker unit opened successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OpenLockerResponse"}},"schemaId":"components/schemas/OpenLockerResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1open/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/OpenLockerResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OpenLockerResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/openlockerunit"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/open"},{"label":"Free a Reserved Locker Unit","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/freereservation","routeSlug":"/openapi/lockers/locker-unit/freereservation","metadata":{"seo":{"title":"Free a Reserved Locker Unit","description":"This API operation release a previously reserved locker unit or remove the reserved package based on the tracking number in the specified locker bank when the reservation needs to be released. Once the locker unit freed, the unit becomes available for new reservations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"freeReservation","name":"Free a Reserved Locker Unit","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1free/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Free a Reserved Locker Unit","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation release a previously reserved locker unit or remove the reserved package based on the tracking number in the specified locker bank when the reservation needs to be released. Once the locker unit freed, the unit becomes available for new reservations."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the locker unit is located. Retrieve this value using the Get Locker Banks API.","required":true},{"name":"lockerUnitId","in":"path","schemaId":"schema_276","description":"The unique identifier of the locker unit to be freed within the specified locker bank.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1free/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FreeLockerUnitRequest"}},"schemaId":"components/schemas/FreeLockerUnitRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1free/post/requestBody","description":"Free a reserved locker number."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/free","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"lockerUnitId","in":"path","required":true,"example":"2","schemaId":"schema_276"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/FreeLockerUnitRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/free","href":"locker-unit/freereservation","openApiOperationId":"freeReservation","summary":"Free a Reserved Locker Unit"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/FreeLockerUnitRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FreeLockerUnitRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The specified locker unit is freed successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FreeLockerUnitResponse"}},"schemaId":"components/schemas/FreeLockerUnitResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1free/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FreeLockerUnitResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FreeLockerUnitResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/freereservation"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/free"},{"label":"Get Reservation List by Contact ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/getreservationlist","routeSlug":"/openapi/lockers/locker-unit/getreservationlist","metadata":{"seo":{"title":"Get Reservation List by Contact ID","description":"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."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getReservationList","name":"Get Reservation List by Contact ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1contact~1{contactId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Reservation List by Contact ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"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."},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank from which reservation details must be retrieved.","required":true},{"name":"contactId","in":"path","schemaId":"schema_278","description":"The identifier of the contact (recipient or department) whose reservation details are requested.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1contact~1{contactId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/contact/{contactId}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"contactId","in":"path","required":true,"example":"684a6b7bbc85e1bce739xxxx","schemaId":"schema_278"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/contact/{contactId}","href":"locker-unit/getreservationlist","openApiOperationId":"getReservationList","summary":"Get Reservation List by Contact ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"All active reservations for the specified contact has been fetched successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReservationListResponse"}},"schemaId":"components/schemas/ReservationListResponse"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1contact~1{contactId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ReservationListResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReservationListResponse"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/getreservationlist"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/contact/{contactId}"},{"label":"Get Reservation by Tracking Number","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/getreservation","routeSlug":"/openapi/lockers/locker-unit/getreservation","metadata":{"seo":{"title":"Get Reservation by Tracking Number","description":"This API operation retrieves the reservation details for a specific parcel using its tracking number within the specified locker bank."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getReservation","name":"Get Reservation by Tracking Number","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1{trackingNumber}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Reservation by Tracking Number","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation retrieves the reservation details for a specific parcel using its tracking number within the specified locker bank. "},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank from which the reservation information must be retrieved.","required":true},{"name":"trackingNumber","in":"path","schemaId":"schema_279","description":"The tracking number of the parcel whose reservation details are being requested.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1{trackingNumber}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"isTrackNumUrlEncoded","in":"query","schemaId":"schema_280","description":"Indicates whether the tracking number provided in the request is URL encoded."},{"name":"includeAllParcels","in":"query","schemaId":"schema_280","description":"When set to true, the response includes all tracking numbers currently assigned to the locker unit."}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1{trackingNumber}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/{trackingNumber}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"trackingNumber","in":"path","required":true,"example":"TrackigID137","schemaId":"schema_279"}],"query":[{"name":"isTrackNumUrlEncoded","in":"query","required":false,"example":false,"schemaId":"schema_280"},{"name":"includeAllParcels","in":"query","required":false,"example":false,"schemaId":"schema_280"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/{trackingNumber}","href":"locker-unit/getreservation","openApiOperationId":"getReservation","summary":"Get Reservation by Tracking Number"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Reservation details for the specified tracking number has been fetched successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReservationResponse"}},"schemaId":"components/schemas/ReservationResponse"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1reserved~1{trackingNumber}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ReservationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReservationResponse"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/getreservation"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/{trackingNumber}"},{"label":"Deposit a package into a locker unit","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/updatedeposit","routeSlug":"/openapi/lockers/locker-unit/updatedeposit","metadata":{"seo":{"title":"Deposit a package into a locker unit","description":"This API operation deposit a package into a locker unit in the specified locker bank"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateDeposit","name":"Deposit a package into a locker unit","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1deposit/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deposit a package into a locker unit","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation deposit a package into a locker unit in the specified locker bank"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the locker unit is located.","required":true},{"name":"lockerUnitId","in":"path","schemaId":"schema_276","description":"The unique identifier of the locker unit within the specified locker bank.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1deposit/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PackageDepositRequest"}},"schemaId":"components/schemas/PackageDepositRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1deposit/patch/requestBody","description":"The details of the parcel deposit into a locker unit."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/deposit","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"lockerUnitId","in":"path","required":true,"example":"2","schemaId":"schema_276"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PackageDepositRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/deposit","href":"locker-unit/updatedeposit","openApiOperationId":"updateDeposit","summary":"Deposit a package into a locker unit"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/PackageDepositRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PackageDepositRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The package has been deposited into a locker unit in the specified locker bank.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PackageDepositResponse"}},"schemaId":"components/schemas/PackageDepositResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1deposit/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PackageDepositResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PackageDepositResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/updatedeposit"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/deposit"},{"label":"Update Reservation","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/updatereservation","routeSlug":"/openapi/lockers/locker-unit/updatereservation","metadata":{"seo":{"title":"Update Reservation","description":"This API operation updates the reservation information to add a package into an existing locker unit in the given locker bank."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateReservation","name":"Update Reservation","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1reservation~1update/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update Reservation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API operation updates the reservation information to add a package into an existing locker unit in the given locker bank."},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the locker unit is located.","required":true},{"name":"lockerUnitId","in":"path","schemaId":"schema_276","description":"The unique identifier of the locker unit whose reservation details need to be updated.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1reservation~1update/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateReservationRequest"}},"schemaId":"components/schemas/UpdateReservationRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1reservation~1update/patch/requestBody","description":"Update the reservation parcels for an existing locker unit."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/reservation/update","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"lockerUnitId","in":"path","required":true,"example":"2","schemaId":"schema_276"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateReservationRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/reservation/update","href":"locker-unit/updatereservation","openApiOperationId":"updateReservation","summary":"Update Reservation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/UpdateReservationRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateReservationRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateReservationResponse"}},"schemaId":"components/schemas/UpdateReservationResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1reservation~1update/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateReservationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateReservationResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/updatereservation"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/reservation/update"},{"label":"Get locker unit status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/getlockerunitstatus","routeSlug":"/openapi/lockers/locker-unit/getlockerunitstatus","metadata":{"seo":{"title":"Get locker unit status","description":"Retrieves the door status of a specific locker unit in the specified locker bank. Use this endpoint to check whether the locker unit door is open or closed after an open, deposit, pickup, return drop-off, or maintenance operation.  Note: This API returns a success response only when the locker hardware is configured."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLockerUnitStatus","name":"Get locker unit status","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get locker unit status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves the door status of a specific locker unit in the specified locker bank. Use this endpoint to check whether the locker unit door is open or closed after an open, deposit, pickup, return drop-off, or maintenance operation. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API returns a success response only when the locker hardware is configured."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the locker unit is located.","required":true},{"name":"lockerUnitId","in":"path","schemaId":"schema_276","description":"The unique identifier of the locker unit whose door status must be retrieved.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1status/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/status","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"},{"name":"lockerUnitId","in":"path","required":true,"example":"2","schemaId":"schema_276"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/status","href":"locker-unit/getlockerunitstatus","openApiOperationId":"getLockerUnitStatus","summary":"Get locker unit status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Locker unit status retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerDoorStatusResponse"}},"schemaId":"components/schemas/LockerDoorStatusResponse"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1{lockerUnitId}~1status/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/LockerDoorStatusResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LockerDoorStatusResponse"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/getlockerunitstatus"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/status"},{"label":"Pickup package from locker unit","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/lockers/locker-unit/pickuppackage","routeSlug":"/openapi/lockers/locker-unit/pickuppackage","metadata":{"seo":{"title":"Pickup package from locker unit","description":"This API operation is used to pick up deposited packages from locker units within the specified locker bank."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pickupPackage","name":"Pickup package from locker unit","isWebhook":false,"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1pickup/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Pickup package from locker unit","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API operation is used to pick up deposited packages from locker units within the specified locker bank."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint when:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A recipient picks up a delivered package from a locker unit."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A mailroom operator removes expired packages from locker units."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authorized user performs a package retrieval operation."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request can include one or more pickup requests. Each pickup request identifies the locker unit and package pickup code associated with the parcel pickup operation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pickupExpiryPackage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the API allows pickup of expired packages from locker units."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API is designed solely for client-side end-to-end testing in the sandbox environment."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"lockerBankId","in":"path","schemaId":"schema_274","description":"The unique identifier of the locker bank where the package pickup operation is performed.","required":true}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1pickup/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PickupPackageRequest"}},"schemaId":"components/schemas/PickupPackageRequest","pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1pickup/post/requestBody","description":"Package pickup request details for one or more locker units."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/lockerBanks/{lockerBankId}/lockers/pickup","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"parameters":{"path":[{"name":"lockerBankId","in":"path","required":true,"example":"AOne","schemaId":"schema_274"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PickupPackageRequest"}},"responseCodes":["200","400","401","404","500"],"pointer":"/api/v1/lockerBanks/{lockerBankId}/lockers/pickup","href":"locker-unit/pickuppackage","openApiOperationId":"pickupPackage","summary":"Pickup package from locker unit"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}],"schemaId":"components/schemas/PickupPackageRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PickupPackageRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Package pickup completed successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PickupPackageRequest"}},"schemaId":"components/schemas/PickupPackageRequest"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}},"schemaId":"components/schemas/invalidErrors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}},"schemaId":"components/schemas/unauthorizedError"},{"code":"404","description":"The requested resource was not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}},"schemaId":"components/schemas/notFoundErrors"},{"code":"500","description":"The request could not be completed due to an internal error.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}},"schemaId":"components/schemas/serverError"}],"pointer":"/paths/~1api~1v1~1lockerBanks~1{lockerBankId}~1lockers~1pickup/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PickupPackageRequest","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PickupPackageRequest"}}},{"code":"400","schemaId":"components/schemas/invalidErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/invalidErrors"}}},{"code":"401","schemaId":"components/schemas/unauthorizedError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/unauthorizedError"}}},{"code":"404","schemaId":"components/schemas/notFoundErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/notFoundErrors"}}},{"code":"500","schemaId":"components/schemas/serverError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/serverError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/locker-unit/pickuppackage"}],"panels":[]}]},"httpPath":"/api/v1/lockerBanks/{lockerBankId}/lockers/pickup"}],"content":{"contentType":"group","meta":{"name":"Locker Unit"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Locker Unit","showPageActions":true},{"nodeType":"markdoc","content":"APIs for managing locker unit reservations and parcel handling workflows within a locker bank. These APIs support operations such as reserving locker units, depositing parcels, retrieving reservation details, updating reservations, and freeing locker units. Together, these operations enable end-to-end management of locker-based delivery and pickup workflows."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserve","summary":"Creates a new Reservation for a Locker","prefix":{"name":"post","color":"post"},"badges":[],"link":"/locker-unit/createreservation","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/asset/reserve","summary":"Create a return reservation","prefix":{"name":"post","color":"post"},"badges":[],"link":"/locker-unit/createreturnreservation","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/open","summary":"Open a locker unit","prefix":{"name":"post","color":"post"},"badges":[],"link":"/locker-unit/openlockerunit","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/free","summary":"Free a Reserved Locker Unit","prefix":{"name":"post","color":"post"},"badges":[],"link":"/locker-unit/freereservation","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/contact/{contactId}","summary":"Get Reservation List by Contact ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-unit/getreservationlist","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/reserved/{trackingNumber}","summary":"Get Reservation by Tracking Number","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-unit/getreservation","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/deposit","summary":"Deposit a package into a locker unit","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/locker-unit/updatedeposit","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/reservation/update","summary":"Update Reservation","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/locker-unit/updatereservation","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/{lockerUnitId}/status","summary":"Get locker unit status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/locker-unit/getlockerunitstatus","deprecated":false},{"title":"/api/v1/lockerBanks/{lockerBankId}/lockers/pickup","summary":"Pickup package from locker unit","prefix":{"name":"post","color":"post"},"badges":[],"link":"/locker-unit/pickuppackage","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/LockerReservationRequest":{"id":"components/schemas/LockerReservationRequest","kind":"json-schema","title":"LockerReservationRequest","data":{"type":"object","required":["userId","contactId","contactType","trackingNumber"],"properties":{"userId":{"type":"string","description":"The identifier of the user performing the locker reservation action.","example":"thirdpartyuser@gmail.com"},"size":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requested locker size for the reservation.Used only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not provided. If both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lockerUnitId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided, this value is ignored. valid values are- small, medium, large and mlarge."},"children":[]}]}]}],"example":"small"},"accessible":{"type":"boolean","description":"Requests a locker that would be deemed handicapped accesible to recipients.","example":true},"lockerUnitId":{"type":"string","description":"The locker unit number you wish to reserve.","example":"2"},"contactId":{"type":"string","description":"The identifier of the recipient of the package for whom the locker reservation is created.","example":"684a6b7bbc85e1bce739xxxx"},"contactType":{"type":"string","description":"The source type of the recipient identifier.","example":"recipient","enum":["recipient","department"]},"trackingNumber":{"type":"string","description":"The primary identifier of a package, usually a carrier's tracking number.","example":"TrackigID137"},"secondaryTrackingNumber":{"type":"string","description":"A secondary identifier for a package, can be generated internally.","example":"TRACK-1234"},"reservationExpiryTime":{"type":"string","description":"The timestamp when the reservation for the locker unit is scheduled to expire. Once reservation is expired, the locker unit becomes available for new reservations.","example":"2027-12-01T00:00:00Z"}}}},"components/schemas/LockerReservationResponse":{"id":"components/schemas/LockerReservationResponse","kind":"json-schema","title":"LockerReservationResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier of the locker bank where the reservation was created.","example":"AOne"},"lockerUnitId":{"type":"string","description":"The locker unit number assigned for the reservation.","example":"2"},"size":{"type":"string","description":"The size of the locker assigned for the reservation.","example":"small"},"contactId":{"type":"string","description":"The identifier of the recipient of the package associated with the reservation.","example":"684a6b7bbc85e1bce739xxxx"},"contactType":{"type":"string","description":"The source type of the recipient identifier.","example":"recipient","enum":["recipient","department"]},"trackingNumber":{"type":"string","description":"The primary identifier of a package, usually a carrier's tracking number.","example":"TrackigID137"},"secondaryTrackingNumber":{"type":"string","description":"A secondary identifier for a package, can be generated internally.","example":"TRACK-1234"},"reservationExpiryTime":{"type":"string","description":"The timestamp when the reservation for the locker unit is scheduled to expire. Once reservation is expired, the locker unit becomes available for new reservations.","example":"2027-12-01T00:00:00Z"}}}},"components/schemas/LockerAssetReservationRequest":{"id":"components/schemas/LockerAssetReservationRequest","kind":"json-schema","title":"LockerAssetReservationRequest","data":{"type":"object","description":"The request to create a return or asset drop-off reservation.","required":["userId","size","contactId","contactType","depositorContactId","depositorContactType","trackingNumber"],"properties":{"userId":{"type":"string","example":"user@gmail.com","description":"The identifier of the user performing the reservation action."},"size":{"type":"string","description":"The size of the locker unit required for the return or asset drop-off.","example":"small"},"accessible":{"type":"boolean","example":true,"description":"Indicates whether an accessible locker unit is required."},"contactId":{"type":"string","example":"684a6b7bbc85e1bce739xxxx","description":"The identifier of the contact or department that will receive the returned package or asset."},"contactType":{"type":"string","description":"The type of contact that will receive the returned package or asset.","enum":["recipient","department"]},"depositorContactId":{"type":"string","example":"684a6b7bbc85e1bxxxxxxxxx","description":"The identifier of the person or contact in the address book who will deposit the returned package or asset into the locker."},"depositorContactType":{"type":"string","description":"The type of contact who will deposit the returned package or asset.","enum":["recipient","department"]},"trackingNumber":{"type":"string","example":"TrackigID137","description":"The primary tracking number or identifier for the returned package or asset."},"secondaryTrackingNumber":{"type":"string","example":"TRACK-1234","description":"The secondary tracking number or additional identifier for the returned package or asset."},"reservationExpiryTime":{"type":"string","example":"2027-12-01T00:00:00Z","format":"date-time","description":"The date and time when the reservation expires."}}}},"components/schemas/LockerAssetReservationResponse":{"id":"components/schemas/LockerAssetReservationResponse","kind":"json-schema","title":"LockerAssetReservationResponse","data":{"type":"object","description":"The response returned after a locker unit is reserved for a return or asset drop-off.","properties":{"lockerBankId":{"type":"string","example":"AOne","description":"The unique identifier of the locker bank."},"lockerUnitId":{"type":"string","example":"2","description":"The locker unit reserved for the return or asset drop-off."},"size":{"type":"string","example":"small","description":"The size of the reserved locker unit."},"contactId":{"type":"string","example":"684a6b7bbc85e1bce739xxxx","description":"The identifier of the contact or department that will receive the returned package or asset."},"contactType":{"type":"string","description":"The type of contact that will receive the returned package or asset.","enum":["recipient","department"]},"depositorContactId":{"type":"string","example":"684a6b7bbc85e1bxxxxxxxxx","description":"The identifier of the person or contact in the address book who will deposit the returned package or asset ."},"depositorContactType":{"type":"string","description":"The type of contact who will deposit the returned package or asset.","enum":["recipient","department"]},"depositorAccessCode":{"type":"string","example":"NR8PBW","description":"The access code given to the depositor to open the locker and drop off the package or asset."},"trackingNumber":{"type":"string","example":"TrackigID137","description":"The primary tracking number or identifier for the returned package or asset."},"reservationExpiryTime":{"type":"string","example":"2027-12-01T00:00:00Z","format":"date-time","description":"The date and time when the reservation expires."}}}},"components/schemas/OpenLockerResponse":{"id":"components/schemas/OpenLockerResponse","kind":"json-schema","title":"OpenLockerResponse","data":{"type":"object","description":"The response returned after the locker unit is opened.","properties":{"lockerBankId":{"type":"string","example":"AOne","description":"The unique identifier of the locker bank."},"lockerUnitId":{"type":"string","example":"2","description":"The unique identifier of the locker unit that was opened."},"contactId":{"type":"string","example":"684a6b7bbc85e1bce739xxxx","description":"The identifier of the contact associated with the locker reservation, if available."},"contactType":{"type":"string","description":"The type of contact associated with the locker reservation.","enum":["recipient","department"]},"activityType":{"type":"string","description":"The activity for which the locker unit was opened.","enum":["deposit","pickup","maintenance"]},"parcelsReserved":{"type":"array","description":"The list of parcels reserved in the locker unit, if any.","items":{"$ref":"#/components/schemas/Parcel"}},"parcelsDeposited":{"type":"array","description":"The list of parcels deposited in the locker unit, if any.","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/LockerDoorStatusResponse":{"id":"components/schemas/LockerDoorStatusResponse","kind":"json-schema","title":"LockerDoorStatusResponse","data":{"type":"object","description":"Response containing the current door status of the locker unit.","properties":{"status":{"type":"string","description":"The current door status of the specified locker unit. Expected values are 'open' or 'closed'.","example":"closed"}}}},"components/schemas/FreeLockerUnitRequest":{"id":"components/schemas/FreeLockerUnitRequest","kind":"json-schema","title":"FreeLockerUnitRequest","data":{"type":"object","required":["userId"],"properties":{"userId":{"type":"string","description":"The identifier of the user performing the locker unit free action.","example":"ThirdParty"},"parcels":{"type":"array","description":"The list of parcels associated with the locker being freed.","items":{"type":"object","properties":{"trackingNumber":{"type":"string","description":"The primary tracking number of the parcel.","example":"Dept03"},"secondaryTrackingNumber":{"type":"string","example":"TRACK-1234","description":"An optional secondary identifier for the parcel."}}}}}}},"components/schemas/FreeLockerUnitResponse":{"id":"components/schemas/FreeLockerUnitResponse","kind":"json-schema","title":"FreeLockerUnitResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier of the locker bank where the locker unit was freed.","example":"AOne"},"lockerUnitId":{"type":"string","description":"The identifier of the locker unit that was freed.","example":"2"},"unitReserved":{"type":"boolean","description":"Indicates whether the locker unit is reserved.","example":true},"contactId":{"type":"string","description":"The identifier of the recipient associated with the locker reservation that was freed.","example":"ThirdParty"},"contactType":{"type":"string","description":"The source type of the recipient identifier.","example":"recipient","enum":["recipient","department"]},"parcelsReserved":{"type":"array","description":"The list of parcels currently in reserved state for this locker unit. In case of no parcels in reserved state, no tracking number is returned.","items":{"type":"object","properties":{"trackingNumber":{"type":"string","description":"The tracking number of the parcel that was reserved.","example":"26112025_1"},"secondaryTrackingNumber":{"type":"string","description":"A secondary identifier for a package, can be generated internally.","example":"TRACK-1234"}}}}}}},"components/schemas/LockerSizesResponse":{"id":"components/schemas/LockerSizesResponse","kind":"json-schema","title":"LockerSizesResponse","data":{"description":"Response containing all sizes available in a particular locker bank.","type":"object","properties":{"supportedSize":{"type":"array","description":"The list of supported locker sizes in the locker bank.","items":{"$ref":"#/components/schemas/SupportedSize"}}}}},"components/schemas/SupportedSize":{"id":"components/schemas/SupportedSize","kind":"json-schema","title":"SupportedSize","data":{"type":"object","properties":{"size":{"type":"string","description":"The name of the locker size as used in LockerReservationRequest.","example":"small"},"uom":{"type":"string","description":"The unit of measurement for the dimensions of the locker size.","example":"in"},"dimension":{"type":"object","description":"The dimensions of the locker size.","$ref":"#/components/schemas/Dimension"},"total":{"type":"integer","description":"The total number of locker units for this size.","example":10},"available":{"type":"integer","description":"The number of available locker units for this size.","example":6},"accessible":{"type":"integer","description":"The total number of accessible locker units available for this size for individuals with disabilities.","example":2}}}},"components/schemas/Dimension":{"id":"components/schemas/Dimension","kind":"json-schema","title":"Dimension","data":{"type":"object","properties":{"length":{"type":"integer","description":"The length of the locker in the specified unit of measurement.","example":22.75},"width":{"type":"integer","description":"The width of the locker in the specified unit of measurement.","example":16.5},"height":{"type":"integer","description":"The height of the locker in the specified unit of measurement.","example":3.5}}}},"components/schemas/LockerBankResponse":{"id":"components/schemas/LockerBankResponse","kind":"json-schema","title":"LockerBankResponse","data":{"type":"array","description":"The list of locker banks available.","items":{"$ref":"#/components/schemas/LockerBank"}}},"components/schemas/ReservationListResponse":{"id":"components/schemas/ReservationListResponse","kind":"json-schema","title":"ReservationListResponse","data":{"description":"A list of all locker unit reservations associated with the specified contact within the locker bank.","type":"object","properties":{"reservedUnits":{"type":"array","description":"The list of reserved locker units for the contact.","items":{"$ref":"#/components/schemas/ReservationResponse"}}}}},"components/schemas/PackageDepositRequest":{"id":"components/schemas/PackageDepositRequest","kind":"json-schema","title":"PackageDepositRequest","data":{"type":"object","required":["parcels"],"properties":{"userId":{"type":"string","description":"The identifier of the user performing the deposit action.","example":"user@gmail.com"},"parcels":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Parcel"},{"type":"object","properties":{"photo":{"$ref":"#/components/schemas/Photo"}}}]}}}}},"components/schemas/PackageDepositResponse":{"id":"components/schemas/PackageDepositResponse","kind":"json-schema","title":"PackageDepositResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier for the locker bank.","example":"AOne"},"lockerUnitId":{"type":"string","description":"The unique identifier of the locker unit where the parcel was deposited.","example":"7"},"userId":{"type":"string","description":"The identifier of the user who performed the deposit action.","example":"user@gmail.com"},"pickupCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pickup code provided to the recipient for retrieving the deposited parcel."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pickup Code will only be provided to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contactType: recipient"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contactType: department"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the contacts will pick the parcel by providing  their "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personalId"},"children":[]}]}]}],"example":"NR8PBW"},"depositTime":{"type":"string","description":"The timestamp when the package was deposited in the locker unit.","example":"2025-11-27T11:23:26Z"},"depositExpiryTime":{"type":"string","description":"The timestamp when the deposited parcel is scheduled to expire. Once expired, the parcel may be removed or handled according to facility policy and the locker unit becomes available for new reservations.","example":"2025-11-28T11:23:26Z"},"parcelsDeposited":{"type":"array","description":"The list of parcels that were successfully deposited in the locker unit.","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/UpdateReservationRequest":{"id":"components/schemas/UpdateReservationRequest","kind":"json-schema","title":"UpdateReservationRequest","data":{"type":"object","required":["parcels"],"properties":{"userId":{"type":"string","description":"The identifier of the user performing the reservation update.","example":"user@gmail.com"},"reservationExpiryTime":{"type":"string","example":"2027-12-01T00:00:00Z","description":"The expiry time for the reservation."},"parcels":{"type":"array","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/UpdateReservationResponse":{"id":"components/schemas/UpdateReservationResponse","kind":"json-schema","title":"UpdateReservationResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier for the locker bank","example":"AOne"},"lockerUnitId":{"type":"string","description":"The unique identifier of the locker unit whose reservation was updated.","example":"7"},"userId":{"type":"string","description":"The identifier of the user who performed the reservation update.","example":"user@gmail.com"},"reservationExpiryTime":{"type":"string","example":"2027-12-01T00:00:00Z","description":"The expiry time for the reservation."},"parcelsReserved":{"type":"array","description":"The list of parcels reserved for this locker unit after the update.","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/ReservationResponse":{"id":"components/schemas/ReservationResponse","kind":"json-schema","title":"ReservationResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier for the locker bank.","example":"AOne"},"lockerUnitId":{"type":"string","description":"The unique identifier of the reserved locker unit.","example":"2"},"size":{"type":"string","description":"The size of the reserved locker unit.","example":"small"},"accessible":{"type":"boolean","description":"Indicates whether the reserved locker unit is accessible for individuals with disabilities.","example":true},"unitInService":{"type":"boolean","description":"Indicates whether the reserved locker unit is currently operational.","example":true},"unitReserved":{"type":"boolean","description":"Indicates whether the locker unit is currently reserved for a parcel.","example":true},"unitOccupied":{"type":"boolean","description":"Indicates whether one or more parcels have been deposited in the locker unit.","example":true},"parcelsReserved":{"type":"array","description":"The parcels that have been reserved for this locker unit but are not yet deposited.","items":{"$ref":"#/components/schemas/Parcel"}},"parcelsDeposited":{"type":"array","description":"The parcels that have already been deposited in the locker unit and are awaiting pickup","items":{"$ref":"#/components/schemas/Parcel"}},"contactId":{"type":"string","description":"The identifier of the contact (recipient or department) associated with the reservation.","example":"684a6b7bbc85e1bce739xxxx"},"contactType":{"type":"string","description":"This is an enumerated value that tells you where the contact code is coming from","enum":["recipient","department"],"example":"recipient"},"contactName":{"type":"string","description":"The name of the contact associated with the reservation.","example":"User Name"},"reservationTime":{"type":"string","description":"The timestamp indicating when the reservation was created.","example":"2025-11-12T16:13:06Z"},"reservationExpiryTime":{"type":"string","description":"The timestamp when the reservation for the locker unit is scheduled to expire. Once reservation is expired, the locker unit becomes available for new reservations.","example":"2025-12-19T09:59:00Z"},"transactionType":{"type":"string","description":" This indicates the nature of the transaction, such as whether it was a delivery or a return.","example":"deliver"},"depositorContactId":{"type":"string","description":"The identifier of the person or contact in the address book who will deposit the returned package or asset into the locker.","example":"684a6b7bbc85e1bxxxxxxxxx"},"depositorContactType":{"type":"string","description":"This is an enumerated value that tells you where the contact code is coming from.","example":"recipient","enum":["recipient","department"]},"depositTime":{"type":"string","description":"The timestamp when the parcel was deposited into the locker unit, returns only if the unit is occupied.","example":"2025-11-17T14:28:37Z"},"depositExpiryTime":{"type":"string","description":"The timestamp when the deposited parcel is scheduled to expire.","example":"2025-11-30T14:28:37Z"}}}},"components/schemas/LockerBank":{"id":"components/schemas/LockerBank","kind":"json-schema","title":"LockerBank","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The identifier for the locker bank used by the APIs.","example":"AOne"},"bankName":{"type":"string","description":"The display name of the locker bank for user reference.","example":"Locker One"},"locationId":{"type":"string","description":"The identifier of the location where the locker bank is placed","example":"loc_auto_sa5cxxx"},"lastHeartbeatTime":{"type":"string","example":"2025-11-27T11:23:26Z","format":"date-time","description":"The timestamp of the most recent heartbeat signal received from the locker bank. This value helps determine if the locker bank is online and communicating with the system.\n"},"rearLoadingEnabled":{"type":"boolean","example":true,"description":"Indicates whether the locker bank supports rear-side loading, allowing mailroom operators to place parcels into the lockers from the back of the unit.\n"},"deliveryEnabled":{"type":"boolean","example":true,"description":"Indicates whether the locker bank is currently active and available for delivery operations. If set to false, the locker bank is out of service.\n"},"assetEnabled":{"type":"boolean","example":true,"description":"Indicates whether the locker bank supports return functionality.\n"}}}},"components/schemas/LockerBankDetailsResponse":{"id":"components/schemas/LockerBankDetailsResponse","kind":"json-schema","title":"LockerBankDetailsResponse","data":{"type":"object","properties":{"lockerBankId":{"type":"string","description":"The unique identifier for the specified locker bank.","example":"AOne"},"bankName":{"type":"string","description":"The given name to the locker bank to help identify the locker bank by users.","example":"Locker One"},"locationId":{"type":"string","description":"The identifier of the location where the locker bank is installed.","example":"loc_auto_sa5cxxx"},"lockerBankDescription":{"type":"string","example":"Locker bank installed for parcel deliveries.","description":"A descriptive text about the specified locker bank."},"lastHeartbeatTime":{"type":"string","example":"2025-11-27T11:23:26Z","description":"The timestamp of the most recent heartbeat signal received from the locker bank, indicating its latest communication status."},"rearLoadingEnabled":{"type":"boolean","example":true,"description":"Indicates if the locker bank is have rear loading enabled."},"deliveryEnabled":{"type":"boolean","example":true,"description":"Indicates whether the locker bank is currently in service and available for operations."},"assetEnabled":{"type":"boolean","description":"Indicates whether asset support is enabled for the locker bank.","example":true},"lockerUnits":{"type":"array","items":{"$ref":"#/components/schemas/LockerUnit"}}}}},"components/schemas/LockerUnit":{"id":"components/schemas/LockerUnit","kind":"json-schema","title":"LockerUnit","data":{"type":"object","description":"About the all locker units of the locker bank.","properties":{"lockerUnitId":{"type":"string","description":"The unique identifier for the locker unit.","example":"1"},"size":{"type":"string","description":"The size of this locker unit.","example":"small"},"accessible":{"type":"boolean","description":"Indicates if the locker unit is handicapped accesible to recipients.","example":false},"unitInService":{"type":"boolean","description":"Indicates if the locker unit is currently operational.","example":true},"unitReserved":{"type":"boolean","description":"Indicates if the locker unit is currently reserved.","example":true},"unitOccupied":{"type":"boolean","description":"Indicates if the locker unit currently contains a deposited parcel.","example":false},"depositTime":{"type":"string","description":"The timestamp of the parcel deposit, returns only for occupied locker units.","example":"2025-11-17T14:28:37Z"},"depositExpiryTime":{"type":"string","description":"The timestamp when the deposited parcel is scheduled to expire. By default,  a deposited parcel expires 2 days after the deposit date, excluding weekends. Once expired, the mailroom operator may remove the parcel or handle it according to facility policy.","example":"2027-12-19T09:59:00Z"},"reservationTime":{"type":"string","description":"The timestamp when the locker unit reservation was made.","example":"2025-11-26T10:34:30Z"},"reservationExpiryTime":{"type":"string","description":"The timestamp when the reservation for the locker unit is scheduled to expire. Once reservation is expired, the locker unit becomes available for new reservations.","example":"2025-11-12T16:13:06Z"},"transactionType":{"type":"string","description":" This indicates the nature of the transaction, such as whether it was a delivery or a return.","example":"deliver"},"contactId":{"type":"string","description":"The identifier of the recipient of the package for whom the locker reservation is created.","example":"684a6b7bbc85e1bce739xxxx"},"contactType":{"type":"string","description":" Indicates the type of contact associated with the reservation.","enum":["recipient","department"],"example":"recipient"},"contactName":{"type":"string","description":"The name of the contact associated with the reservation.","example":"UserName"},"depositorContactId":{"type":"string","description":"The identifier of the person or contact in the address book who will deposit the returned package or asset into the locker.","example":"684a6b7bbc85e1bxxxxxxxxx"},"depositorContactType":{"type":"string","description":"This is an enumerated value that tells you where the contact code is coming from. For the depositor of the package, this field indicates the type of contact information provided for the depositor, such as whether it is a recipient or a department.","example":"recipient","enum":["recipient","department"]},"parcelsReserved":{"type":"array","description":"The parcels that have been reserved for this locker unit but have not yet been deposited.","items":{"$ref":"#/components/schemas/Parcel"}},"parcelsDeposited":{"type":"array","description":"A list of parcels that have already been deposited in the locker and are waiting to be picked up.","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/Parcel":{"id":"components/schemas/Parcel","kind":"json-schema","title":"Parcel","data":{"type":"object","properties":{"trackingNumber":{"type":"string","description":"The primary identifier of a package, usually a carrier's tracking number.","example":"26112025_6"},"secondaryTrackingNumber":{"type":"string","example":"TRACK-1234","description":"A secondary identifier for a package, can be generated internally."}}}},"components/schemas/Photo":{"id":"components/schemas/Photo","kind":"json-schema","title":"Photo","data":{"type":"object","properties":{"base64":{"type":"string","description":"A base64 encoded string photo","example":"iVBORw0KGgoAAAANSUhEUgAAAAUA..."},"contentType":{"type":"string","description":"The content type of the photo","example":"image/png"}}}},"components/schemas/PackageActivity":{"id":"components/schemas/PackageActivity","kind":"json-schema","title":"PackageActivity","data":{"type":"object","description":"This object is sent via the platform callback whenever an event occurs to a package.  Any properties that do not apply for the event will have NULL values","properties":{"lockerBankId":{"type":"string","example":"AOne","description":"The locker bank unique identifier in Pitney Locker."},"lockerUnitId":{"type":"string","example":"2","description":"The locker unit number"},"activityCode":{"type":"string","description":"The activity occuring to the package","enum":["reservation","cancelreservation","deposit","pickup","stalemailpickup"]},"activityDate":{"type":"string","example":"2025-11-27T11:23:26Z","format":"date-time","description":"The date and time when the event occurred."},"userId":{"type":"string","example":"user@gmail.com","description":"The person who is performing the action"},"photo":{"type":"string","example":"iVBORw0KGgoAAAANSUhEUgAAAAUA...","description":"The base64 encoded string taken by the locker bank of the person at the locker bank based upon configuration"},"signature":{"type":"string","example":"iVBORw0KGgoAAAANSUhEUgAAAAUA...","description":"The signature of the recipient if configured to capture as base64 encoded string of bytes"},"contactId":{"type":"string","example":"684a6b7bbc85e1bce739xxxx","description":"The identifier in the address book of the intended recipient of the package"},"contactType":{"type":"string","description":"This is an enumerated value that tells you where the recipient code is coming from","enum":["recipient","department"]},"trackingNumber":{"type":"string","example":"TrackigID137","description":"The primary identifier of a package, usually a carrier's tracking number"},"secondaryTrackingNumber":{"type":"string","example":"TRACK-1234","description":"A secondary identifier for a package, can be generated internally"}}}},"components/schemas/PickupPackageRequest":{"id":"components/schemas/PickupPackageRequest","kind":"json-schema","title":"PickupPackageRequest","data":{"type":"object","required":["userId","pickupRequests"],"properties":{"userId":{"type":"string","description":"The identifier of the user performing the package pickup operation.","example":"user@gmail.com"},"pickupExpiryPackage":{"type":"boolean","description":"Indicates whether expired packages can be picked up from the locker unit.","example":false},"pickupRequests":{"type":"array","description":"The list of package pickup requests.","items":{"type":"object","properties":{"pickupCode":{"type":"string","description":"Pickup code associated with the deposited package.","example":"NR8PBW"},"lockerUnitId":{"type":"string","description":"The unique identifier of the locker unit from which the package will be picked up.","example":"7"},"contactId":{"type":"string","description":"The identifier of the recipient or department performing the pickup.","example":"684a6b7bbc85e1bce739xxxx"},"contactType":{"type":"string","description":"The type of contact performing the pickup.","example":"recipient","enum":["recipient","department"]}}}}}}},"components/schemas/PickupPackageResponse":{"id":"components/schemas/PickupPackageResponse","kind":"json-schema","title":"PickupPackageResponse","data":{"type":"object","description":"The response returned after the package pickup operation is completed.","properties":{"lockerBankId":{"type":"string","description":"The unique identifier of the locker bank.","example":"AOne"},"userId":{"type":"string","description":"The identifier of the user who performed the pickup operation.","example":"user@gmail.com"},"pickupTime":{"type":"string","format":"date-time","description":"The timestamp when the package pickup was completed.","example":"2025-11-27T11:23:26Z"},"pickedUpParcels":{"type":"array","description":"The list of parcels successfully picked up from locker units.","items":{"$ref":"#/components/schemas/Parcel"}}}}},"components/schemas/unauthorizedError":{"id":"components/schemas/unauthorizedError","kind":"json-schema","title":"unauthorizedError","data":{"type":"object","properties":{"message":{"type":"string","example":"The request could not be completed.","description":"This is HTTP 401 Unauthorized response status code, which indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource."}},"required":["message"]}},"components/schemas/serverError":{"id":"components/schemas/serverError","kind":"json-schema","title":"serverError","data":{"type":"object","properties":{"message":{"type":"string","example":"The request could not be completed.","description":"This is HTTP 500 Internal Server Error response status code, which indicates that the server encountered an unexpected condition that prevented it from fulfilling the request."}},"required":["message"]}},"components/schemas/invalidErrors":{"id":"components/schemas/invalidErrors","kind":"json-schema","title":"invalidErrors","data":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"string","description":"Error code(s) that appear due to HTTP  400- Invalid or Bad Request, e.g., validation-error.","example":"validation_error"},"errorDescription":{"type":"string","description":"HTTP 400 Bad Request response status code indicates that the server cannot process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).","example":"userId - value missing."},"additionalCode":{"type":"string","description":"A unique identifier for the error, for example ILP10010, or ILP10030.","example":"already_exists"},"additionalInfo":{"type":"string","description":"This is an additional information about the error. This error 'Invalid Request' might appear due to invalid data, or if the information is missing.","example":"674eb7b67b34d787400fa453"},"additionalParameters":{"type":"array","items":{"type":"string","example":"userId","description":"The field(s) that might be incorrect in the request"}}}}}},"components/schemas/notFoundErrors":{"id":"components/schemas/notFoundErrors","kind":"json-schema","title":"notFoundErrors","data":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"string","example":"not_found","description":"Error code(s) that appear due HTTP 404 Page or File not found."},"errorDescription":{"type":"string","example":"resource not found","description":"HTTP 404 Not Found response status code indicates that the server cannot find the requested resource."},"additionalCode":{"type":"string","example":"0100025","description":"A unique identifier for the error, for example 0100025, 1110017, or 1090001."},"additionalInfo":{"type":"string","example":"Resource not found","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The additional information about the error. This error 'Not Found' might appear due to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Shipment Not Found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"No Shipments to close"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Original Transaction not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"additionalParameters":{"type":"array","items":{"type":"string","example":"userId","description":"The field(s) that might be incorrect in the request."}}}}}},"schema_271":{"kind":"json-schema","data":{"type":"integer","example":"0"},"id":"schema_271"},"schema_272":{"kind":"json-schema","data":{"type":"integer","example":"100"},"id":"schema_272"},"schema_273":{"kind":"json-schema","data":{"type":"string","example":"loc_auto_sa5cxxx"},"id":"schema_273"},"schema_274":{"kind":"json-schema","data":{"type":"string","example":"AOne"},"id":"schema_274"},"schema_275":{"kind":"json-schema","data":{"type":"string","example":"PB123456"},"id":"schema_275"},"schema_276":{"kind":"json-schema","data":{"type":"string","example":"2"},"id":"schema_276"},"schema_277":{"kind":"json-schema","data":{"type":"object","description":"The request to open a locker unit remotely.","required":["userId"],"properties":{"userId":{"type":"string","example":"user@gmail.com","description":"The identifier of the person or system user in the address book performing the open locker action."}}},"id":"schema_277"},"schema_278":{"kind":"json-schema","data":{"type":"string","example":"684a6b7bbc85e1bce739xxxx"},"id":"schema_278"},"schema_279":{"kind":"json-schema","data":{"type":"string","example":"TrackigID137"},"id":"schema_279"},"schema_280":{"kind":"json-schema","data":{"type":"boolean","example":false},"id":"schema_280"}},"exampleStore":{},"securitySchemeStore":{"basicAuth":{"id":"basicAuth","type":"http","scheme":"basic"},"bearerAuth":{"id":"bearerAuth","type":"http","scheme":"bearer"}},"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/parcelpoint","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/parcelpoint","description":"Production Server (uses live data)"}]},"options":{"hideDownloadButtons":false,"hideInfoMetadata":true,"jsonSamplesExpandLevel":3,"layout":"three-panel","schemasExpansionLevel":2,"generateCodeSamples":{"languages":[{"lang":"curl"},{"lang":"JavaScript"},{"lang":"Node.js"},{"lang":"Python"},{"lang":"Go"},{"lang":"Java"},{"lang":"C#"}]},"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi/lockers.json?download"},{"url":"/_bundle/openapi/lockers.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Pitney Locker APIs","description":"\nThe Pitney Locker APIs help manage smart locker operations for package delivery, returns, and asset drop-off workflows. These APIs allow external organizations to automate secure, contactless locker operations by integrating with Pitney Bowes smart lockers.\n\nBy integrating these APIs into your system, you can automate end-to-end locker workflows—from retrieving available locker banks and reserving locker units to remotely opening lockers, depositing packages, retrieving reservation details and releasing locker units after use . \n\n**Why Use Pitney Locker APIs**\n\n- Enable contactless, secure package deliveries\n\n- Automate locker assignment and release\n\n- Support forward delivery and return/drop-off workflows\n\n- Track which locker unit is assigned to which package\n\n- Simplify mailroom or internal delivery operations\n\n- Retrieve locker availability and locker status information\n\n\n**How Pitney Locker APIs Work**\n\nThe Pitney Locker APIs are designed to manage smart locker workflows—from retrieving available locker banks and reserving locker units to depositing packages and freeing locker units after completion.\n\nThe APIs support two primary workflows:\n\n- Forward delivery workflow (transactionType: deliver)\n- Return or asset drop-off workflow (transactionType: return)\n\nA user (typically a mailroom operator or system) can use these APIs to:\n\n  1. Look up locker banks\n  2. Check available locker unit sizes\n  3. Reserve locker units\n  4. Open locker units remotely\n  5. Deposit packages into locker units\n  6. Retrieve reservation details\n  7. Free locker units after use\n  8. Monitor locker unit operational status\n\n\n**Step-by-Step Workflow for Pitney Locker APIs**\n\n**Step 1: Retrieve Available Locker Banks**\n\nUse the [Get Locker Banks](/openapi/lockers/locker-bank/getlockerbanks) or [Get Locker Bank by Locker Bank ID](/openapi/lockers/locker-bank/getlockerbankdetails) APIs to retrieve the list of available locker banks at a facility.\nFilter by:\n\n- `locationId`: To get lockers for a specific location\n\n- `lockerBankId`: To retrieve a specific locker bank by ID. One location can have multiple banks.\n\n- Each locker bank has a unique `lockerBankId`, used in subsequent API calls.\n\n**Step 2: Get Locker Sizes for a Locker Bank**\n\nUse the [Get Locker Sizes API](/openapi/lockers/locker-bank/lockersizes) to retrieve the available locker unit sizes in a locker bank (e.g., small, medium, large) along with their availability status.\n\n- You need to pass the `lockerBankId` retrieved in Step 1 as a path parameter.\n\n**Step 3: Reserve a Locker Unit**\n\nOnce you know a locker unit is available, use the [Reserve Locker Unit API](/openapi/lockers/locker-unit/createreservation) to create a reservation.\nThis workflow is typically used for forward delivery operations and internally uses `transactionType: deliver`\n\nRequired fields include:\n\n- `lockerBankId` (path parameter)\n\n- Package tracking number\n\n- Locker size preference (e.g., small)\n\n- Recipient identification (contact ID and type)\n\n- Reservation Expiry Time \n\nIf a locker is successfully reserved, a **locker unit ID** will be returned in the response.\n\n**Return and Asset Drop-off Reservations**\n\nFor return or asset drop-off workflows, use the Create Return Reservation API.\n\nThis workflow uses `transactionType: return`\n\nIn this workflow a depositor places a package or asset into a locker. The reservation details include the intended receiving contact (e.g., store or department) and the depositor contact (e.g., customer or recipient) who will drop off the package or asset. Once the reservation is created, the depositor can use the provided locker unit information to complete the return drop-off, and the receiving contact can retrieve the item from the locker for processing.\n\nThe reservation can include:\n\n- Receiving contact information\n- Depositor contact information\n- Tracking details\n- Reservation expiry information\n\n**Step 4: Open a Locker Unit**\n\nUse the Open Locker Unit API to remotely unlock a locker unit before package deposit or return drop-off operations. This API is used by mailroom operators or authorized users to open the locker unit door for secure, contactless package handling.\n\n**Step 5: Add or Update Deposit Information**\n\nAfter reserving the locker unit, deposit the parcel inside the locker using [Add/Update Deposit API](/openapi/lockers/locker-unit/updatedeposit). Using the same API, user can update the deposit information for example userId of the user.\n\nThis updates the locker reservation to reflect:\n\n- Parcel successfully deposited\n- Deposit timestamp\n- depositExpiryTime (Once expired, the parcel may be removed or handled according to facility policy.)\n- Parcel pickup code (Pickup Code will only be provided to the `contactType: recipient`. For `contactType: department` the recipients will pick the parcel by providing their `personalId`)\n\nYou need to pass:\n\n- `lockerBankId` (path parameter)\n\n- `lockerUnitId` (path parameter)\n\n**Step 6: Retrieve Reservation Details** \n\nThese APIs help external systems, operators, or recipients retrieve reservation details.\n\n- [Get Reservations by Contact](/openapi/lockers/locker-unit/getreservationlist): Retrieve all reservations linked to a specific recipient/contact.\n- [Get Reservation by Tracking Number](/openapi/lockers/locker-unit/getreservation): Retrieve reservation details using the package tracking number.\n\n**Step 7: Update Reservation** \n\nIf reservation details need to be changed (e.g., expiry time, contact details, metadata), use the [Update Reservation API](/openapi/lockers/locker-unit/updatereservation).\n\nYou need to pass:\n\n- `lockerBankId` (path parameter)\n\n- `lockerUnitId` (path parameter)\n\n**Step 7: Free the Reserved Locker Unit**\n\nUse the [Free Reserved Locker Unit API](/openapi/lockers/locker-unit/freereservation) to cancel the existing reservation. This makes the locker unit available for the next package.\n\nYou need to pass:\n\n- `lockerBankId` (path parameter)\n\n- unit to be freed - `lockerUnitId` (path parameter)\n\n**Note:** Some Pitney Locker workflows require recipient, department, or depositor contact details. These contacts are managed through the Address Book APIs. For more information, see [Address Book APIs](/openapi/addressbook/contact/addcontact).\n"}},"baseSlug":"/openapi/lockers","routesMapping":{}}