Download BPOD Files

This API operation is used to download bulk of ERR (Electronic Return Receipt) - POD (Proof of Delivery) files, which are specific to USPS carrier.
User can download BPOD (Bulk Proof of Delivery) files either using Shipment IDs or Date Range. If user wants to check records based on dates and download BPOD files accordingly, then Start Date and End Date need to be passed in the request body as filter. Else Shipment IDs will be used as default value when user does not provide DateRange filter.
User is restricted to download 1000 BPOD files as max limit.

SecuritybearerAuth
Request
query Parameters
startDate
string

The BPOD files to be downloaded from which Date is the startDate in the Date Range filter. This field is not required if the Shipment IDs provided in the request body.

endDate
string

The BPOD files to be downloaded till which Date is the endDate in the Date Range filter. This field is not required if the Shipment IDs provided in the request body.

header Parameters
X-PB-Developer-Partner-ID
string

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 is not required.

Request Body schema: application/json

This is the request body to download BPOD files. Request body supports max of 1000 ShipmentIDs in a request.

shipmentIds
Array of strings
  • This shows the list of Shipment IDs. If this is present, then user does not need to provide Date Range filter. Else startDate and endDate need to be passed in the Query Parameters.
Responses
200

The ZIP URL for BPOD files has been created for download.

400

Invalid request.

401

The request could not be authorized.

500

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

post/api/v1/err/shipments/bpod
Request samples
application/json
{
  • "shipmentIds": [
    ]
}
Response samples