{"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.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"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":["To provide the fastest possible response times, Pitney Bowes uses traffic shaping to ensure that a very large number of closely spaced API requests from an individual developer account cannot negatively impact response times for all developer accounts. During any given second, Pitney Bowes throttles the requests for an individual developer if that developer's requests would slow down other developers' requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pitney Bowes uses a custom algorithm to determine when to apply traffic shaping. Traffic-shaping policy is handled on a per-developer basis, so the number of requests sent per second to one developer has no effect on traffic shaping for any other developer."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"plan-based-throttling-limits","__idx":2},"children":["Plan-Based Throttling Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Safe Limit for any API operation performed by the developer varies based on the subscription plan assigned to it. To avoid traffic shaping, developers should observe the following limits:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sandbox-plan-based-throttling-limits","__idx":3},"children":["Sandbox Plan-Based Throttling Limits"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Plan Name"},"children":["Plan Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request Rate (TPS)"},"children":["Request Rate (TPS)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Burst Limit"},"children":["Burst Limit"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Daily Quota"},"children":["Daily Quota"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["BASIC_API_USAGE_PLAN_PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2000 per day"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DEFAULT_API_USAGE_PLAN_PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["50000 per day"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ENTERPRISE_API_USAGE_PLAN_PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unlimited"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PREMIUM_API_USAGE_PLAN_PPD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["15 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["30 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3000 per day"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"production-plan-based-throttling-limits","__idx":4},"children":["Production Plan-Based Throttling Limits"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Plan Name"},"children":["Plan Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request Rate (TPS)"},"children":["Request Rate (TPS)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Burst Limit"},"children":["Burst Limit"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Daily Quota"},"children":["Daily Quota"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["BASIC_API_USAGE_PLAN_PRD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["100 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unlimited"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DEFAULT_API_USAGE_PLAN_PRD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["150 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["300 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unlimited"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ENTERPRISE_API_USAGE_PLAN_PRD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["300 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["600 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unlimited"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PREMIUM_API_USAGE_PLAN_PRD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["150 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["300 per second"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unlimited"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Existing developers will be regulated under a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single key"]}," (the default key for the environment) until an explicit plan is assigned to them."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Rate (TPS):"]}," The maximum number of API requests a developer can send per second without throttling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Burst Limit:"]}," The maximum number of API requests a developer can send in short bursts before throttling applies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Daily Quota:"]}," The maximum number of API calls allowed per developer per day."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"impact-of-exceeding-throttling-limits","__idx":5},"children":["Impact of Exceeding Throttling Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a developer exceeds the assigned TPS limit, they may experience increased latency as excess requests are either queued or delayed before processing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-exceeding-tps-transactions-per-second-limit","__idx":6},"children":["1. Exceeding TPS (Transactions Per Second) Limit"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a developer sends more requests than the allowed ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TPS rate"]},", excess requests may be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["throttled"]}," and processed with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["higher response times (latency)"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-exceeding-burst-limit","__idx":7},"children":["2. Exceeding Burst Limit"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a developer exceeds the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["burst limit"]},", requests beyond the allowed threshold will be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["throttled"]},", and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Too Many Requests"]}," error will be returned."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-exceeding-the-daily-quota","__idx":8},"children":["3. Exceeding the Daily Quota"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["daily API quota"]}," is reached, all subsequent requests will be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["rejected"]},", and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limit Exceeded"]}," error will be returned for the rest of the day."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Pitney Bowes may adjust the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["traffic-shaping policy"]}," for APIs over time."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-does-traffic-shaping-apply","__idx":9},"children":["When Does Traffic Shaping Apply?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the request volume exceeds the assigned limit, Pitney Bowes may throttle requests until one of the following conditions is met:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The TPS for the API operation falls below the assigned request rate (e.g., 10 TPS for Basic Plan) for one second."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OR"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The total TPS for the API operation for all developers falls below 50% of the maximum allowable bandwidth, as defined by the Pitney Bowes engineering teams, for one second."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that Pitney Bowes traffic-shaping policies do not, in general, specifically target concurrent (simultaneous) transactions. For example, a developer sending bursts of 200 concurrent transactions at the beginning of each second would be treated identically to a developer sending one transaction every 500 milliseconds."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"build-tps-limits-into-your-applications","__idx":10},"children":["Build TPS Limits into Your Applications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As a best practice, build TPS limits into your applications to avoid sending more transactions per second than the Safe Limit allows. This might mean spacing out transactions by a set number of milliseconds or limiting the number of threads in a multi-threaded application."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Code that defines how retry requests are handled should also be reviewed to prevent the retry policy from compounding traffic-related issues."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you frequently encounter throttling issues, consider upgrading your usage plan. Please contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.pitneybowes.com/us/support.html"},"children":["Pitney Bowes Support"]}," for assistance with plan upgrades."]}]}]},"headings":[{"value":"Traffic Shaping","id":"traffic-shaping","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Plan-Based Throttling Limits","id":"plan-based-throttling-limits","depth":2},{"value":"Sandbox Plan-Based Throttling Limits","id":"sandbox-plan-based-throttling-limits","depth":3},{"value":"Production Plan-Based Throttling Limits","id":"production-plan-based-throttling-limits","depth":3},{"value":"Impact of Exceeding Throttling Limits","id":"impact-of-exceeding-throttling-limits","depth":2},{"value":"1. Exceeding TPS (Transactions Per Second) Limit","id":"1-exceeding-tps-transactions-per-second-limit","depth":3},{"value":"2. Exceeding Burst Limit","id":"2-exceeding-burst-limit","depth":3},{"value":"3. Exceeding the Daily Quota","id":"3-exceeding-the-daily-quota","depth":3},{"value":"When Does Traffic Shaping Apply?","id":"when-does-traffic-shaping-apply","depth":2},{"value":"Build TPS Limits into Your Applications","id":"build-tps-limits-into-your-applications","depth":2}],"frontmatter":{"seo":{"title":"Traffic Shaping"}},"lastModified":"2026-05-15T13:59:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/support/traffic-shaping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}