HTTP Status Codes

Overview

The PB Shipping APIs use conventional HTTP status codes to indicate the success or failure of an API request. If a request fails, an error code is also returned.

To view the status of the PB Shipping APIs, go to the Pitney Bowes API Status Page. To troubleshoot errors, see Troubleshooting.

HTTP Status Codes

Code Message Additional Information
200 OK The request is successful.
201 Created The new resource is created.
400 Bad Request Possible causes include a missing parameter, missing value, invalid structure, or malformed request.
401 Unauthorized Possible causes include an expired or invalid access token.
403 Forbidden Possible causes include the account is not enabled for the operation.
404 Not Found The resource does not exist or is temporarily unavailable.
405 Method Not Allowed The HTTP method specified in the request (e.g., POST, GET, DELETE) is not allowed for this resource.
500 Internal Server Error

There has been an error on the Pitney Bowes servers.

IMPORTANT: If you receive this error when creating a shipment, do not resubmit your request without first checking if the label was created by invoking the Retry Shipment API.

If this error occurred for a different API call, try the call again. If the problem persists, please contact Support.

503 Service Unavailable Possible cause can be an unplanned maintenance window. Try the call again. If the problem persists, please contact Support.