Package Pickup APIs

Submit a pickup request and we will pick up your packages for free with Package Pickup API.

Register and Get Access to Web Tools APIs
Back to Full List of USPS Web Tools®

Package Pickup API
Package Pickup

Package Pickup APIs

Package Pickup Expand Collapse FAQ question

Check the availability for Package Pickup at a specific address, Schedule a Pickup, and get first available date for pickup. Package Pickup is not available for all address. Available for Priority Mail Express™, Priority Mail®, International, and returns packages. Package Pickup is not available for all addresses.

View Technical Document

Test XML Request (Package Pickup Availability)

https://secure.shippingapis.com/ShippingAPITest.dll?API=CarrierPickupAvailability&XML=<CarrierPickupAvailabilityRequest USERID="xxxxxxxxxxxx">
<FirmName>ABC Corp.</FirmName>
<SuiteOrApt>Suite 777</SuiteOrApt>
<Address2>1390 Market Street</Address2>
<Urbanization></Urbanization>
<City>Houston</City>
<State>TX</State>
<ZIP5>77058</ZIP5>
<ZIP4>1234</ZIP4>
</CarrierPickupAvailabilityRequest>

 

Test XML Response (Package Pickup Availability)

<?xml version="1.0"?>
<CarrierPickupAvailabilityResponse>
<FirmName>ABC Corp.</FirmName>
<SuiteOrApt>Suite 777</SuiteOrApt>
<Address2>1390 Market Street</Address2>
<Urbanization/>
<City>HOUSTON</City>
<State>TX</State>
<ZIP5>77058</ZIP5>
<ZIP4>1234</ZIP4>
<DayOfWeek>Monday</DayOfWeek>
<Date>3/1/2004</Date>
<CarrierRoute>C</CarrierRoute>
</CarrierPickupAvailabilityResponse>

 

Test XML Request (Package Pickup Change)

https://secure.shippingapis.com/ShippingAPITest.dll?API=CarrierPickupChange&XML=<CarrierPickupChangeRequest USERID="xxxxxxxxxxxx">
<FirstName>John</FirstName>
<LastName>Doe</LastName>
<FirmName/>
<SuiteOrApt/>
<Address2>1390 Market Street</Address2>
<Urbanization/>
<City>Houston</City>
<State>TX</State>
<ZIP5/>
<ZIP4/>
<Phone>(555) 555-1234</Phone>
<Extension/>
<Package>
<ServiceType>PriorityMail</ServiceType>
<Count>1</Count>
</Package>
<EstimatedWeight>14</EstimatedWeight>
<PackageLocation>Front Door</PackageLocation>
<SpecialInstructions/>
<ConfirmationNumber>WTC123456789</ConfirmationNumber>
</CarrierPickupChangeRequest>

 

Test XML Response (Package Pickup Change)

<?xml version="1.0"?>
<CarrierPickupChangeResponse>
<FirstName>JOHN</FirstName>
<LastName>DOE</LastName>
<FirmName/>
<SuiteOrApt/>
<Address2>1390 MARKET STREET</Address2>
<Urbanization/>
<City>HOUSTON</City>
<State>TX</State>
<ZIP5>77058</ZIP5>
<ZIP4>1234</ZIP4>
<Phone>(555) 555-1234</Phone>
<Extension/>
<Package>
<ServiceType>PriorityMail</ServiceType>
<Count>1</Count>
</Package>
<EstimatedWeight>14</EstimatedWeight>
<PackageLocation>Front Door</PackageLocation>
<SpecialInstructions/>
<ConfirmationNumber>WTC123456789</ConfirmationNumber>
<DayOfWeek>Monday</DayOfWeek>
<Date>3/1/2004</Date>
<Status>Update successful</Status>
</CarrierPickupChangeResponse>

 

Test XML Request (Package Pickup Inquiry)

https://secure.shippingapis.com/ShippingAPITest.dll?API=CarrierPickupInquiry&XML=<CarrierPickupInquiryRequestUSERID="xxxxxxxxxxxx">
<FirmName/>
<SuiteOrApt/>
<Address2>1390 Market Street</Address2>
<Urbanization/>
<City/>
<State/>
<ZIP5>77058</ZIP5>
<ZIP4/>
<ConfirmationNumber>WTC123456789</ConfirmationNumber>
</CarrierPickupInquiryRequest>

 

Test XML Response (Package Pickup Inquiry)

<?xml version="1.0"?>
<CarrierPickupInquiryResponse>
<FirstName>JOHN</FirstName>
<LastName>DOE</LastName>
<FirmName/>
<SuiteOrApt/>
<Address2>1390 Market Street</Address2>
<Urbanization/>
<City>HOUSTON</City>
<State>TX</State>
<ZIP5>77058</ZIP5>
<ZIP4>1234</ZIP4>
<Phone>(555) 555-1234</Phone>
<Extension>201</Extension>
<Package>
<ServiceType>ExpressMail</ServiceType>
<Count>1</Count>
</Package>
<Package>
<ServiceType>PriorityMail</ServiceType>
<Count>1</Count>
</Package>
<Package>
<ServiceType>International</ServiceType>
<Count>1</Count>
</Package>
<Package>
<ServiceType>OtherPackages</ServiceType>
<Count>1</Count>
</Package>
<EstimatedWeight>14</EstimatedWeight>
<PackageLocation>FrontDoor</PackageLocation>
<SpecialInstructions/>
<ConfirmationNumber>WTC123456789</ConfirmationNumber>
<DayOfWeek>Monday</DayOfWeek>
<Date>3/1/2004</Date>
</CarrierPickupInquiryResponse>