Changelog Archive¶
The Changelog Archive contains all Changelog items that are older than the current year and previous year.
Released in 2021¶
Released on 2021-12-18
PB Standard Delivery 4X5 and 4X6 labels can now use the BMP format. See PB Delivery Labels.
Released on 2021-12-06
The
carrier
query parameter is optional in the Track a Package API, except for PB Standard labels. PB Standard labels require thecarrier
query parameter.
Released on 2021-11-14
The Transaction Reports API now provides the
referralCode
query parameter which lets you query based on the referral code a merchant used to sign up.
Released on 2021-11-01
The Merchant Object now has the
paymentServicesAccountId
to indicate the account used to fund postage and thepaymentServicesAccountIdActive
field to indicate whether the account is active.
Released on 2021-10-23
PB Standard Delivery 4X5 labels can now use the TIF format. See PB Delivery Labels.
Released on 2021-09-15
The APIs now use
PBCS
to indicate PB Standard as the carrier.
Released on 2021-08-01
Developer Hub uses new URLs. See the links in the Developer Account section of the API Overview.
Released on 2021-07-15
FedEx 4X6 labels can now use the
ZPL2
file format. See FedEx Labels.UPS 4X6 labels can now use the
ZPL2
andGIF
file formats. See UPS Labels.
Released on 2021-07-01
CBDS has opened a new United Kingdom Hub.
Released on 2021-06-19
The Container Label API now prints PNG and JPEG labels.
Released on 2021-06-19
The new
customs.customsInfo.importerCustomsReferenceType
field supports the new EU rules on VAT and IOSS numbers.
Released on 2021-06-15
The subdomain portion of all base URLs has changed. For current base URLs, see API Environments.
Released on 2021-06-08
The Transaction Reports API now returns PB Standard transactions through the new carrier parameter.
Released on 2021-06-01
Client Support has a new email address: ClientSupportTechServices@pb.com
Released on 2021-05-22
Tracking now provides additional status information, including event descriptions targeted specifically to buyers or sellers.
Transaction Reports now query on transaction status through the new
printStatus
parameter.
Released on 2021-05-01
The Tracking Webhook now returns PB Standard transactions.
Released on 2021-04-15
The Intelligent Mail Indicia (IMI) on the upper right corner of USPS labels now uses IMI-Standard (IMI-STD) instead of IMI-Minimum (IMI-MIN).
Released on 2021-03-31
The CBDS California Hub has moved.
Released on 2021-03-02
The Container Label API’s now gives the option to print only the barcode.
Released on 2021-02-26
The Pickup API now includes the
pickupSummary.returnShipment
field to indicate the pickup includes a return shipment.
Released on 2021-02-20
The APIs support the new USPS rules on when customs forms are required for domestic shipments
Released on 2021-02-04
PB Standard Returns labels sized 4X6 or 6X4 can now use the
ZPL2
format.PB Standard Returns now provides parameters for printing custom barcodes.
Released on 2021-02-01
The merchant signup URL can now pre-populate the signup form with merchant information. See these parameters.
Released on 2021-01-29
The documentation now combines carrier information for PB Expedited and PB Standard onto one Pitney Bowes Expedited and PB Delivery and PB Return Services carrier page.
Released on 2021-01-27
The Print a Container Label for Shipment to a PB Facility provides the
submissionDate
field for including all shipments that have been manifested up to the specified shipment date.
Released on 2021-01-09
The Create SCAN Form API now ignores empty Strings in the
parcelTrackingNumbers
array and prints the SCAN form without throwing an error.
Released on 2021-01-04
The Print a Container Label for Shipment to a PB Facility provides the
PACKAGE_COUNT
parameter for entering the number of parcels in the container.
Released in 2020¶
Released on 2020-10-18
The new HS Code API predicts the HS code for a parcel.
The new Archived Transactions API obtains transaction data older than six months.
Released on 2020-10-14
The Rates API returns rates for PB Standard Delivery parcels.
PB Standard Returns labels now print custom logos and additional sizes and formats.
Released on 2020-09-20
The
trackingStatus
query parameter in Transaction Reports can now take a value ofALL
to return all tracking statuses.
Released on 2020-09-10
For a return label, Get Transaction Reports now return a
POSTAGE PRINT
transaction the same day.The Get Merchant Accounts API now returns the
company
field.
Released on 2020-08-30
Get Transaction Reports now query on tracking status through the
trackingStatus
query parameter. Transaction Reports also now return the induction postal code.
Released on 2020-08-26
PB Expedited Returns now use cubic rates and flat-rate packaging.
Released on 2020-08-08
Void a Shipment no longer requires a request body. The API provides query parameters for passing all values.
Released on 2020-07-18
Get Transaction Reports now return adjustment reasons of
duplicate
andusedRefundedLabel
in line with expanded coverage by USPS Automated Package Verification.
Released on 2020-07-01
The new Add Tracking Events API allows you to record tracking events.
Released on 2020-06-30
Merchants can generate container labels through the Merchant Portal.
Released on 2020-06-10
The Print a Container Label for Shipment to a PB Facility API prints a label for the shipment of containerized parcels destined for a Pitney Bowes facility.
CBDS now provides a bulk-pickup solution. See CBDS Delivery Solutions.
Released on 2020-05-19
The new PB Standard Returns API prints a returns label and provides the option to create a QR code.
The new Carrier Facility API locates Post Offices and other facilities near a given address.
Released on 2020-05-16
You can now create PB Standard Delivery Manifests by specifying parcel tracking numbers.
Released on 2020-04-15
When you print an IMb label for an FCM letter or flat, Pitney Bowes now creates a “Label created” tracking event.
Released on 2020-04-11
Support for USPS shipment of irregular parcels and nonmachinable letters.
Released on 2020-04-06
The default date range for Transaction Reports is now 92 days prior to the current date.
Released on 2020-03-31
CBDS now supports shipment to Canada of ID8000 commodities. For details, see this FAQ.
Released on 2020-03-07
FedEx integration. Merchants can integrate existing FedEx accounts with the APIs.
The Rate and Shipment APIs now determine the best rate for a soft pack by looking at weight-based pricing and 2-dimensional cubic pricing.
Released on 2020-02-23
The CBDS International Outbound Shipment API provides the option to print first-mile labels.
Released on 2020-02-15
First-Class Mail letters and flats now display the postage amount as human readable.
First-Class Mail flats now print return addresses in the top left corner of the label.
Released on 2020-02-12
The
X-PB-Shipper-Carrier-AccountId
request header is now conditional. See Add Commercial Carrier Accounts.
Released on 2020-01-14
The Tracking API tracks PB Standard parcels using the
carrier
query parameter. The API reports both PB Standard and USPS tracking events.If you onboard merchants through Merchant Portal and retrieve account details through the Merchant Authorization API, you can now use the optional
paymentMethod
query parameter to specify which payment methods to make available.
Released on 2020-01-04
Merchants can now print PB Presort Labels for U.S. Territories, U.S. Possessions, and Freely Associated States. This is in addition to previous support for APO/FPO/DPO.
Released in 2019¶
Released on 2019-12-05
PB Expedited Returns labels are now in Production.
Released on 2019-11-14
If you use the APAC Services to print PB Standard Delivery labels as PDFs, the PDFs are returned as Base64-encoded strings, not as URLs.
CBDS now provides the Prepay Express (
PBXPE
) service.
Released on 2019-10-30
Pitney Bowes has changed the domain for retrieving PDF labels and manifests.
Released on 2019-10-24
PB Standard shipments can use 4X4 labels. See PB Standard Labels.
USPS 4X6 domestic labels can use 300 DPI. See the
resolution
field in the Documents Object.A merchant’s PB Postage Account can have a negative account balance in certain circumstances (such as after an APV transaction). In such cases, the merchant will not be able to print a label until the postage account is refilled.
Released on 2019-10-04
CBDS now provides the Postpay Standard (
PBXUS
) service.
Released on 2019-10-03
The Transaction Reports API returns
CREDIT ADJUSTMENT
andDEBIT ADJUSTMENT
transactions to indicate manual adjustments to postage accounts.
Released on 2019-10-01
The Transaction Reports API reports the initiation and resolution of APV disputes.
The Auto Refund service is no longer available.
Released on 2019-09-30
If a merchant has multiple carriers, the Get Merchant Accounts API now returns information on the merchant’s carrier accounts.
Released on 2019-09-07
PB Presort labels for Standard Mail flats can now include human-readable tracking information. See the PRINT_IMBREADABLE_BARCODE shipment option.
PB Presort labels for flats can now print an Electronic Service Requested endorsement. See the NON_DELIVERY_OPTION shipment option.
PB Presort labels for flats can now print a custom message. See the PRINT_CUSTOM_MESSAGE_1 shipment option.
Released on 2019-07-27
You can now set the DPI of a PB Standard Delivery label using the
documents.resolution
field. See Documents Object.
Released on 2019-07-25
ACH is now available on request as a payment method for a merchant’s PB Postage Account.
Released on 2019-07-17
To optimize performance for requests originating in the Asia-Pacific Region, the following APIs provide APAC URLs: Create PB Standard Delivery Shipment, Create PB Standard Manifest, Void a Shipment.
Released on 2019-07-11
The Authorize a Merchant API can now use a referral code to identify who referred a merchant.
Released on 2019-07-09
The new CBDS Shopping Cart Quotes API retrieves estimates of the shipping costs, duties, and taxes for the items in a buyer’s shopping cart.
Released on 2019-06-15
The PMOD Shipments API includes two new PMOD options for specifying NASS code and destination entry facility.
Released on 2019-06-06
Released on 2019-06-01
UPS integration. You can now integrate a merchant’s existing UPS account with the APIs. The APIs provide the following new operations for integrating UPS accounts: Add a Carrier Account, Get Carrier License Agreement.
Shipping to APO/FPO/DPO destinations using the Bound Printed Matter (
BPM
) service is now supported. Parcels ship using thePKG
parcel type and the PB Presort carrier service.
Released on 2019-05-13
The v4.0 Transaction Reports now return Postage Fund information within the hour.
The v4.0 Transaction Reports provide the new
shipDetails
query parameter to let you choose the level of detail to return.
Released on 2019-04-20
The v4.0 Transaction Reports return Print and Refund Request information within the hour.
Released on 2019-03-16
For USPS, the cutoff time to include the current day’s date on a label or SCAN form has changed. See:
What are the cutoff times for USPS shipments and manifests?
What is included in a USPS SCAN form?
Released on 2019-02-19
Pitney Bowes automatically credits and debits prepaid postage accounts with APV adjustments made by USPS.
To view APV adjustments, use Transaction Reports.
Released on 2019-02-09
Improved error messages for address validation.
Released on 2019-02-01
Merchants can now use the Refill API to add funds to their PB Postage Accounts.
Released on 2019-01-29
To bolster security of the APIs, Pitney Bowes made a change to deserialize incoming requests.
Released on 2019-01-27
The APIs provide the option to use a standard error format. See Error Object.
Released in 2018¶
Released on 2018-11-22
CN 22 and CP 72 customs forms accommodate more characters in the
To
andFrom
address blocks by allowing lowercase characters.
Released on 2018-10-27
You can specify the DPI for PNG shipping labels using the
documents.resolution
field. See Documents Object.PB Standard shipments can print 4X5 labels.
Released on 2018-09-29
You can subscribe a PB Standard shipment to receive provisioned notifications by including the
NOTIFICATIONS
special service in the PB Standard Delivery request.You can print custom messages on PB Standard labels using the PRINT_CUSTOM_MESSAGE_2 shipment option.
Released on 2018-08-23
The APIs require TLS v1.2 or higher.
Released on 2018-08-17
The new
references
field maps client-generated identifiers to fields in the PB Standard package record.
Released on 2018-07-29
Support for USPS carrier route codes. See the
carrierRoute
definition in the Address Object.
Released on 2018-06-15
The API prints PB Standard labels.
Merchants can print PB Presort Labels for Bound Printed Matter (
BPM
) and Standard Mail (STANDARD
).
Released on 2018-05-26
Released on 2018-05-11
The Get Transaction Reports API supports new query values.
Released on 2018-04-19
Register a Merchant makes additional validations on the merchant contact information.
Released on 2018-03-09
The new Get Account Balances API retrieves the current balances for a PB Postage Account and PB Line of Credit.
Released on 2018-02-20
The API supports Doc Tab labels.
Released on 2018-01-21
First-Class Mail International (
FCMI
) shipments may contain only documents, not goods.
Released on 2018-01-07
The API prints PB Presort labels.
Released in 2017¶
Released on 2017-09-16
The API prints PMOD labels and PMOD manifests.
The Address Validation API returns the 2-digit delivery point when available.
Released on 2017-08-26
The Create Shipment API generates a single-ply customs declaration form for shipments to APO/FPO/DPO destinations and to participating countries.
Released on 2017-07-22
The new Pickups API allows merchants to schedule carrier pickups.
The Rate Parcel and Create Shipment APIs support printing a First-Class Letter with an Intelligent Mail barcode (IMb). See this FAQ on IMb.
The Rate Parcel and Create Shipment APIs support the Soft Pack (
SOFTPACK
) parcel type.
Released on 2017-07-09
The new Suggest Addresses API provides address suggestions, when they’re available.
The new Get Carrier Rules API retrieves USPS rules for domestic and international shipments.
When using the Rate Parcel API, you can leave out the
parcelType
,serviceId
, or both, allowing merchants to find rates for multiple parcel types and services with one call. You can also specify special services in the rate request and obtain the special service fee in the response.The Rate Parcel and Create Shipment APIs support DVD Flat Rate Boxes and Large Video Flat Rate Boxes.
Released on 2017-06-10
The Parcel Object includes two new fields for specifying the value of the parcel:
valueOfGoods
andcurrencyCode
.The Create Shipment API automatically reassigns values in the parcel.dimension object to ensure length is the longest dimension, followed by height, followed by width.
The Create Shipment API generates customs forms for U.S. territories, possessions, and Freely Associated States.
The Create Shipment API returns an error if the declared value for customs exceeds $400 for either of the following two services: First-Class Mail International, First-Class Package International Service.
Released on 2017-05-31
Adult Signature Required and Adult Signature Restricted Delivery are supported with the Rate Parcel and Create Shipment APIs.
The Create Manifest API allows you to both list shipments and specify a Shipper ID.
Released on 2017-05-12
The Create Manifest API now lets you filter shipments based on their
inductionPostalCode
.