{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Traffic Shaping","description":"itney Bowes Shipping API, developers can integrate features such as comparing shipping rates from multiple carriers, creating and purchasing shipping labels, tracking packages, scheduling pickups, managing returns, and accessing other shipping features. These APIs also offers a variety of shipping services, including international shipping and multi-carrier rate shopping, which allows developers to choose the best carrier and rate for each shipment."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"traffic-shaping","__idx":0},"children":["Traffic Shaping"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pitney Bowes applies rate limiting and traffic-management controls to help maintain platform stability, ensure fair use of shared resources, and protect downstream carrier and partner services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pitney Bowes monitors platform utilization and may adjust traffic-management controls when necessary to maintain service reliability."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-rate-limiting-works","__idx":2},"children":["How Rate Limiting Works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If an application generates a high volume of requests within a short period, Pitney Bowes may temporarily throttle or reject additional requests to help protect platform stability."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rate-limiting behavior may vary based on factors such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Sandbox or Production environment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API operation being invoked"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request volume and traffic patterns"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Current platform conditions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Downstream carrier or partner-service constraints"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Pitney Bowes does not publish a single throughput value that applies to every API operation. Actual throughput and response times may vary depending on request characteristics, API dependencies, carrier response times, and overall platform conditions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-rate-limiting-occurs","__idx":3},"children":["When Rate Limiting Occurs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If request volume exceeds the level that can be processed reliably, Pitney Bowes may temporarily throttle or reject additional requests. The API may return:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"HTTP/1.1 429 Too Many Requests\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An HTTP 429 response should be treated as a temporary condition. Applications should reduce the request rate and use an appropriate retry and backoff strategy."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Downstream carriers and partner services may also apply their own limits. As a result, some requests may be constrained by systems outside the Pitney Bowes platform."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handle-rate-limits-gracefully","__idx":4},"children":["Handle Rate Limits Gracefully"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applications should be designed to handle temporary throttling without creating additional traffic spikes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As a best practice:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Implement exponential backoff when retrying requests that receive an HTTP 429 response."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avoid immediately retrying unsuccessful requests."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add randomized delays, also known as jitter, to prevent multiple requests from retrying at the same time."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apply retry controls across the entire integration rather than only to individual requests."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Distribute requests evenly over time where possible."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Limit concurrency and avoid large bursts of traffic."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use batch or bulk operations where available."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recommended-response-to-an-http-429-error","__idx":5},"children":["Recommended response to an HTTP 429 error"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reduce the request rate."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wait before retrying the request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gradually resume normal traffic after requests are being accepted successfully."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sandbox-considerations","__idx":6},"children":["Sandbox Considerations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Sandbox environment is intended for integration development and functional validation. Sandbox capacity and traffic-management settings may differ from Production."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Automated tests should avoid unnecessary repeated calls and should use mocks or test doubles where practical. Applications should not use Sandbox performance as an indication of Production throughput."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requesting-a-limit-review","__idx":7},"children":["Requesting a Limit Review"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customers with sustained high-volume workloads or specialized throughput requirements should contact Pitney Bowes Support before going live."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A limit-review request may consider:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Expected transaction volume and peak request rate"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["APIs and operations used by the integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Traffic distribution and burst patterns"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Concurrency and retry behavior"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Downstream carrier and partner constraints"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform capacity and operational readiness"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pitney Bowes may review the requested traffic profile and recommend an appropriate configuration or request-management approach."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-notes","__idx":8},"children":["Additional Notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Different APIs and operations may have different processing characteristics."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Traffic-management settings may be modified periodically to maintain platform reliability and service performance."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Carrier and partner systems may impose additional constraints outside the control of Pitney Bowes."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customers should monitor API responses and adjust request patterns accordingly."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Pitney Bowes may revise traffic-management policies as platform capacity, operational requirements, and downstream-service constraints evolve."]}]}]},"headings":[{"value":"Traffic Shaping","id":"traffic-shaping","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"How Rate Limiting Works","id":"how-rate-limiting-works","depth":2},{"value":"When Rate Limiting Occurs","id":"when-rate-limiting-occurs","depth":2},{"value":"Handle Rate Limits Gracefully","id":"handle-rate-limits-gracefully","depth":2},{"value":"Recommended response to an HTTP 429 error","id":"recommended-response-to-an-http-429-error","depth":3},{"value":"Sandbox Considerations","id":"sandbox-considerations","depth":2},{"value":"Requesting a Limit Review","id":"requesting-a-limit-review","depth":2},{"value":"Additional Notes","id":"additional-notes","depth":2}],"frontmatter":{"seo":{"title":"Traffic Shaping"}},"lastModified":"2026-10-15T03:24:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/support/traffic-shaping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}