Transaction Reports FAQs

How do I get transaction history for a developer or merchant?

There are three ways to view transaction history:

  • PB Shipping APIs

    Use the Transaction Reports API. By default, the API returns transactions for all merchants in the developer account. To return transactions only for a specific merchant, use the API’s query parameters.

  • Developer Hub

    In Developer Hub, your transaction history returns all the transactions for your developer account. To return transactions for a specific merchant, use the Filter Criteria.

  • Merchant Portal

    A merchant can log into Merchant Portal and view transactions.

Do transaction reports provide real-time data?

Transaction reports return transactions within 60 minutes of their postings.

Is there a limit on the number of transactions reported?

The current limit is 2000 records per call to the Transaction Reports API. Pitney Bowes recommends keeping the expected number of transactions per page to under 500, to make sure all transactions get processed.

Why is the Reports API ignoring my entered dates?

Make sure you are using the correct date format in the request. The following is the correct format. Be sure to include the Z at the end.

fromDate=YYYY-MM-DDT00:00:00.00Z
toDate=YYYY-MM-DDT00:00:00.00Z

Also, make sure you have no misspellings or incorrect cases in the query parameter keyword.

How do I filter for SBR transactions?

To retrieve a report that displays only USPS SBR transactions, issue the Transaction Reports API call with the printStatus query parameter set to one of the following:

  • SBR: Returns all SBR labels.
  • SBRPrinted: Returns labels that are printed but not yet scanned into the USPS® mailstream.
  • SBRCharged: Returns labels that are scanned into the USPS mailstream. Note that once an SBR label is scanned, it typically takes two days for the API to display the event.

See also: How do I know if an SBR label has been used?