POST /tracking
This API allows users to retrieve detailed information about a specific USPS® package. Using the USPS® Tracking Request, individuals can view the delivery status of various mail items, such as Priority Mail®, Priority Mail Express®, and Package Services (including Parcel Post®, Bound Printed Matter, Library Mail, and Media Mail®) that have USPS® Tracking. By collecting mail class and service information from Product Tracking Systems, USPS® Tracking provides users with delivery status updates. By entering the tracking number, users can view the detailed delivery status of single Priority Mail® and Package Service parcels with Delivery Confirmation.
By registering for the USPS® Tracking by Email service, users can receive email notifications about their package tracking events. This service allows customers to submit their email address to be notified of current or future tracking activity. Users can choose to receive notifications for all activity to date, all future activity, or both. Whenever a mail piece receives an email notifiable event, an email with the relevant information will be generated and sent. With the new request type, users can make multiple requests for a single mail piece in a single request. Tracking status can be obtained using just the IMpb, and if multiple items are found, users can include additional details in the request.
Servers
- https://apis.usps.com/tracking/v3r2
- https://apis-tem.usps.com/tracking/v3r2
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
[] |
Array | Yes | |
[].trackingNumber |
String | Yes |
Tracking ID, must be alphanumeric characters, string length is between 4 and 34. |
[].destinationZIPCode |
String | No |
Destination 5-digit ZIP Code™ |
[].mailingDate |
String | No |
Used to reconcile duplicate tracking number scenarios. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.