Release Notes

Released on 2022-10-03

Released on 2022-09-17

Released on 2022-08-18

Released on 2022-08-11

Released on 2022-07-28

Released on 2022-07-18

  • CBDS now provides domestic shipping within Canada.

  • CBDS has opened the new Richmond, British Columbia hub. See Canada Hubs.

Released on 2022-06-30

Released on 2022-05-07

Released on 2022-04-30

  • The Standard Returns API now provides the option to return QR Codes as URLs. This is in addition to the option to return QR Codes as Base64-encoded strings.

Released on 2022-04-16

  • The NDC (Network Distribution Center) now shows at the bottom of the label.

  • The Tracking Webhook lets you limit events to certain carriers.

Released on 2022-04-13

Released on 2022-04-03

Released on 2022-03-25

  • The CBDS Track Shipments page has a new URL:

    The old URL ( redirects to the new URL, but we strongly urge you to update your code to use the new URL.

Released on 2022-03-03

  • The default merchant that comes with developer account is now enabled by default to print PB Standard labels on Sandbox.

Released on 2022-01-20

  • The Add Tracking Events API now uses the value PBCS to indicate PB Standard as the carrier. For backward compatibility, the API still accepts previous values.

Released on 2022-01-09

Released in 2021

  • Released on 2021-12-18

  • 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 the carrier 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. See the Query Parameters table for the Transaction Reports API.

  • Released on 2021-11-01

    • The merchant object has two new fields: paymentServicesAccountId, which indicates the payment services account used to fund postage, and paymentServicesAccountIdActive, which indicates whether the payment services account is active. The merchant object is returned when retrieving merchant information and when registering or authorizing a merchant.

      As a result of this change, the paymentKey field is deprecated.

  • Released on 2021-10-23

    • PB Standard Delivery 4X5 labels can now use the TIF format. See Standard Delivery Labels.

    • The Tracking API now uses the value PBCS to indicate PB Standard as the carrier service. For backward compatibility, the API still accepts previous values.

  • Released on 2021-10-03

    • The USPS Holiday Rate Change applies to shipments from October 3, 2021 to December 25, 2021.

  • Released on 2021-09-15

    • The APIs now use the value PBCS to indicate PB Standard as the carrier service. For backward compatibility, the APIs still accept previous values.

  • Released on 2021-08-01

  • Released on 2021-07-15

    • FedEx® 4X6 labels can now use the ZPL2 file format (fileFormat). For all options, FedEx Labels.

    • UPS® 4X6 labels can now use the ZPL2 and GIF file formats (fileFormat). For all options, UPS Labels.

  • Released on 2021-07-01

  • Released on 2021-06-19

  • Released on 2021-06-19

    • Pitney Bowes has added the customs.customsInfo.importerCustomsReferenceType field to support the European Union (EU) rules that went into effect July 2021 requiring that shipments to the EU include a VAT (Value Added Tax) number or IOSS number. Use this field in combination with the customs.customsInfo.importerCustomsReference field to specify the VAT or IOSS number.

  • Released on 2021-06-15

    • New Base URLs: The subdomain portion of all base URLs has changed and is now prepended with shipping-. Each operation’s resource path remains the same. For current base URLs, see API Environments.

  • Released on 2021-06-08

  • Released on 2021-06-01

  • Released on 2021-05-22

    • The Tracking API provides additional status information, including event descriptions targeted specifically to buyers or sellers.

    • The Transaction Reports API now queries on transaction status through the new printStatus query parameter.

  • Released on 2021-05-01

    • The Tracking Webhook returns PB Standard transactions.

  • Released on 2021-04-15

    • The Intelligent Mail Indicia (IMI) on the upper right corner of USPS labels uses IMI-Standard (IMI-STD) instead of IMI-Minimum (IMI-MIN). The following comparison shows an example IMI-STD and an example IMI-MIN:

      IMI Comparison
  • Released on 2021-03-31

    • The CBDS California Hub has moved to 11260 Cedar Ave, Bloomington, CA 92316.

  • Released on 2021-03-02

  • 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

  • Released on 2021-02-04

  • Released on 2021-02-01

    • The merchant signup URL can now pre-populate the Merchant Portal signup form with the merchant’s name, address, and other information. To pre-populate the form, use these parameters.

  • Released on 2021-01-29

    • The documentation now combines carrier information for PB Expedited and PB Standard onto one Pitney Bowes carrier page.

  • Released on 2021-01-27

    • The Create a Container Label 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.

    • The new USPS rounding rules went into effect January 9, 2021. USPS rounds dimensions to 2 decimal places (e.g. 0.12) instead of 3 decimal places (e.g. 0.123) when determining price and rates.

  • Released on 2021-01-04

    • The Create a Container Label 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 being shipped internationally and gives the level of confidence in the prediction.

    • 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 print additional sizes and formats.

  • Released on 2020-09-20

    • The trackingStatus query parameter in the Transaction Reports API can now take a value of ALL to return all tracking statuses.

  • Released on 2020-09-10

  • Released on 2020-08-30

    • Get Transaction Reports now query on tracking status through the trackingStatus query parameter and now return the most recent tracking event within 30 days of the parcel’s ship date. Transaction Reports also now return the induction postal code.

  • Released on 2020-08-26

    • USPS has retired the Scan-Based Return (SBR) program. In its place, merchants can use PB Expedited Returns. Cubic rates and flat-rate packaging are now available for PB Expedited Returns.

  • Released on 2020-08-24

    • The California and Kentucky CBDS Hubs now ship Standard DDP (PBXPS) to additional countries.

  • Released on 2020-08-08

    • Void a Shipment no longer requires a request body. The API provides query parameters for passing all values. You can still pass values through a request body, but using query parameters is recommended.

  • Released on 2020-07-18

    • The USPS Automated Package Verification system, which supports adjustments for weight, dimensions, zone, and packaging, has expanded the coverage to include “Duplicate” and “Used Refunded” labels. As a result, the Get Transaction Reports API will return two new values in the adjustmentReason field: duplicate and usedRefundedLabel

  • Released on 2020-07-01

    • The Add Tracking Events API allows merchants, carriers, and other parcel handlers to record tracking events for shipments. The API supports adding multiple events to multiple shipments in a single request.

    • USPS has deprecated the “Return Receipt for Merchandise” (RRM) special service.

  • Released on 2020-06-30

  • Released on 2020-06-18

    • The Transaction Reports API does not provide information for transactions that were created more than six months ago. To retrieve older transactions, use the Archived Transactions API.

  • Released on 2020-06-10

  • Released on 2020-05-19

  • Released on 2020-05-16

  • 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

    Released on 2020-04-06

  • Released on 2020-03-31

    • Canadian destinations only: CBDS supports shipment to Canada of ID8000 commodities. For details, see this FAQ.

  • Released on 2020-03-07

  • Released on 2020-02-23

  • Released on 2020-02-15

  • Released on 2020-02-12

    • The X-PB-Shipper-Carrier-AccountId request header is now conditional. The header is required only if the merchant has multiple accounts with a carrier. If the merchant has only one account with the carrier, the header is not required. For more information on carrier accounts, 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. Customs forms are not required.

Released in 2019

  • Released on 2019-12-05

  • Released on 2019-11-21

  • Released on 2019-11-14

  • Released on 2019-10-30

  • 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

  • Released on 2019-10-03

    • The Transaction Reports API returns CREDIT ADJUSTMENT and DEBIT ADJUSTMENT transactions to indicate manual adjustments to postage accounts.

  • Released on 2019-10-01

  • 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

  • Released on 2019-07-11

    • If you use the Authorize a Merchant API to enroll merchants, you can now use a referral code to identify who referred a merchant to your software.

  • Released on 2019-07-09

  • Released on 2019-06-15

    • USPS rule changes are in effect for shipments with a ship date of June 23, 2019 or later.

    • The Create PMOD Shipments API includes two new PMOD options for specifying NASS code and destination entry facility.

  • Released on 2019-06-07

    • The Parcel Protection APIs (deprecated) let you void coverage and request reports. Note: Parcel Protection is deprecated.

  • Released on 2019-06-06

  • Released on 2019-06-01

    • UPS (United Parcel Service) integration. You can now integrate a merchant’s existing UPS account with the APIs. Merchants use existing API operations to print and track UPS labels. The APIs provide the following new operations for integrating a merchant’s UPS account: 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 the PKG parcel type and the PB Presort carrier service.

  • Released on 2019-05-21

    • The Parcel Protection APIs (deprecated) let you request quotes and obtain coverage. Note: Parcel Protection is deprecated.

  • Released on 2019-05-13

    • The v4.0 Transaction Reports API now returns information within the hour for POSTAGE FUND transactions.

    • In the v4.0 Transaction Reports API, the new shipDetails query parameter lets you choose whether to return the following fields for each transaction:

      • dimensionalWeightOz

      • valueOfGoods

      • specialServices

      • customMessage1

      • customMessage2

  • Released on 2019-04-20

    • The new version (v4.0) of the Transaction Reports API returns information within the hour for the following:

      • POSTAGE PRINT transactions

      • POSTAGE REFUND requests

        Note that the resolution of a refund request is returned the same day that USPS approves or denies the refund.

      The API now also returns additional information about transactions. For more information, please see Transaction Reports.

  • Released on 2019-04-05

    • An issue with refund requests made between April 3 to 5, 2019, has been corrected. The issue had caused all refunds for those dates to be rejected. The issue is corrected, and all refunds requested on those dates have been resubmitted.

  • Released on 2019-03-16

  • Released on 2019-02-19

    • Pitney Bowes automatically credits and debits prepaid postage accounts with APV adjustments made by USPS. Pitney Bowes applies adjustments made by USPS February 1st and later.

      To view APV adjustments, use the Transaction Reports API.

  • Released on 2019-02-09

    • Improved error messages for address validation: In case of an incomplete or undeliverable address, the additionalInfo field in the error object now provides a reason for the address validation failure. This applies to the Address Validation and Create Shipment APIs. As an example, if an address contains an unrecognized street name, the APIs now return the following error:

          "errorCode": "1019003",
          "errorDescription": "Either Invalid or missing street or stateProvince or postalcode ",
          "additionalInfo": "E411 - The street cannot be found in this locality.",
  • Released on 2019-02-01

    • Merchants can now use the Refill API to add funds to their PB Postage Accounts. Previously, merchants could perform refills only through the Merchant Portal.

  • 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 for all errors encountered. See Error Object.

Released in 2018

  • Released on 2018-11-22

    • CN 22 and CP 72 customs forms accommodate more characters in the To and From address blocks by allowing lower-case 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

  • 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

  • Released on 2018-05-26

    • The Rates and Shipment APIs determine the best rate for a soft pack by looking at different pricing options.

  • Released on 2018-05-11

  • Released on 2018-04-19

    • Additional validations are made on the merchant contact information sent through the Merchant Signup API (deprecated) and Register a Merchant API.

  • 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

  • Released on 2018-01-21

    • First-Class Mail International (FCMI) shipments may contain only documents, not goods.

  • Released on 2018-01-07

Released in 2017

  • Released on 2017-09-16

  • 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. See this FAQ.

  • Released on 2017-07-22

  • Released on 2017-07-09

    • The new Suggest Addresses API provides address suggestions, when they’re available. The response can contain up to 20 suggestions. Results are not sorted by priority.

    • The new Get Carrier Rules API retrieves USPS rules for domestic and international shipments. The rules provide information on weight/dimension constraints and on service compatibility.

    • 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 two new parcel types with Priority Mail International (PMI):

      • DVD Flat Rate Box (DVDBOX)

      • Large Video Flat Rate Box (VIDEOBOX)

  • Released on 2017-06-10

    • The Parcel Object includes two new fields for specifying the value of the parcel: valueOfGoods and currencyCode.

    • 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.

    • Support has been removed for deprecated USPS STCs (Service Type Codes).

  • Released on 2017-05-12