Introduction
The Comprehensive Rate and Transit Times API provides all the possible rate quotes and transit times for the applicable services for your packaging type along with rate quotes for FedEx One Rate service in a single rate request. This enables you to choose the best possible option as per your shipping needs. For FedEx Express services, it compares account specific standard rates, including FedEx One Rate and returns the lower rate quote.
Note:
- Your account should be enabled for FedEx One Rate and FedEx Ground Economy services to get the rate quotes for the respective services.
- FedEx One Rate service has certain dimensional and weight restrictions for shipments. Only the shipments that qualify the dimensional and weight conditions are eligible for FedEx One Rate.
- The Comprehensive Rate and Transit Times API does not provide the rate quotes for FedEx freight services. To know about the rate quotes of FedEx freight service, visit the Freight LTL API docs page.
Benefits of Comprehensive Rate and Transit Times API
- Get rate quotes for both FedEx One Rate and standard FedEx services for your packaging.
- Save time by receiving account-specific rates, FedEx One Rate, and quotes for all other applicable FedEx services (including FedEx Ground and FedEx Express) in a single request.
- Automatically determine the most accurate FedEx One Rate packaging type when package dimensions are provided.
- Control how the rate is displayed (lower rate and whether to include or exclude FedEx One Rate) for flexibility and transparency.
- Reduce unexpected shipping charges for more accurate quotes and billing.
- Return a complete portfolio of FedEx services with corresponding rates and transit times to meet business needs.
- Compare services to choose lower-cost options.
This API provides you the flexibility to receive rate quotes for both FedEx One Rate services along with account specific discounted rates. Quotes can be for both FedEx packaging or for your packaging.
For more information refer Package types.
Note: FedEx Tube is not an accepted packaging type for this API.
Following are the features associated with this API:
- Get all Rate Quotes in a Single Transaction
Get all rates (FedEx Ground Economy outbound, FedEx Express, FedEx One Rate, account specific rates) in a single transaction. - Transit time
Get transit times for services between source and destination. - Auto-Calculate Packaging Type
The volumetric calculation provides accurate packaging type for the shipment based on your specified dimensions.
Note:
- To receive FedEx One Rate in the response, you must either specify a valid FedEx Packaging Type (Envelope, Pak, Small Box, Medium Box, Large Box, or Extra-Large Box) or select Your_Packaging and provide FedEx One Rate qualifying dimensions otherwise the API will only return the account specific/discounted rate quotes.
- To receive a FedEx One Rate for an Envelope or Pak, you must specify the packaging type as Envelope or Pak respectively.
How Comprehensive Rate and Transit Times API Works
Comprehensive rate and transit times API works by performing a volumetric calculation based on the package dimensions provided for your packaging to the corresponding FedEx standard package types (Medium box, Large box etc.,), to determine if your package is eligible for One Rate services and provides the One Rate pricing along with the rate quotes for all the other applicable services.
Disclaimer to compatible shippers or any shipper looking to use the Ship API to create FedEx One Rate labels: Users must pass a FedEx Packaging Type of FEDEX_ENVELOPE, FEDEX_PAK, FEDEX_EXTRA_SMALL_BOX, FEDEX_SMALL_BOX, FEDEX_MEDIUM_BOX, FEDEX_LARGE_BOX, or FEDEX_EXTRA_LARGE_BOX along with a Special Service Flag of FEDEX_ONE_RATE to receive One Rate pricing. Note if the Ship API passes a Packaging Type of YOUR_PACKAGING, FedEx One Rate will NOT apply however the customer will receive account specific rates. For more information on how to Ship FedEx One Rate using the Ship API please see the Ship API documentation or contact your FedEx representative.
Note:
- Default behavior: When you select Your_Packaging type and provide dimensions and weight, the API returns the lower rate quote for each applicable service (for example, FedEx One Rate, FedEx Express, FedEx Ground and Ground Economy services).
- Default rules: If rateDisplayOption is omitted or set to blank/empty/null, it defaults to LOWER_RATE.
To get all possible quotes (not just the lower rate), explicitly set rateDisplayOption in your request to one of the following:
- SELECTED_RATES_INCLUDING_F1R — returns all applicable rates, including FedEx One Rate (F1R).
- SELECTED_RATES_EXCLUDING_F1R — returns all applicable rates, excluding FedEx One Rate (F1R).
Below volumetric and weight conditions are checked to determine the eligibility of a package for FedEx One Rate.
Package Measurements Specified Auto calculated corresponding FedEx Packaging Type Rate Quotes for services returned in response Volume (Length X Width X Height) Thickness Weight Your Packaging Not Specified NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Envelope Not Specified Not Specified < 10 lbs. FedEx Envelope One Rate for FedEx Envelope and other applicable services <= 300 cubic inches <= 3 inches <= 10 lbs. FedEx Envelope One Rate for FedEx Envelope and other applicable services <= 300 cubic inches > 3 & <= 5 inches <= 10 lbs. FedEx Pak One Rate for FedEx Pak and other applicable services <= 300 cubic inches <= 5 inches > 10 & <= 50 lbs. FedEx Pak One Rate for FedEx Pak and other applicable services > 300 & <= 650 cubic inches <= 5 inches <= 50 lbs. FedEx Pak One Rate for FedEx Pak and other applicable services > 1 & <= 168 cubic inches > 5 inches <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches > 5 inches <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches > 5 inches <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches > 5 inches <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches > 5 inches <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches > 5 inches <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified Not Specified > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Pak <= 650 cubic inches <= 5 inches <= 50 lbs. FedEx Pak One Rate for FedEx Pak and other applicable services > 1 & <= 168 cubic inches > 5 inches <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches > 5 inches <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches > 5 inches <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches > 5 inches <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches > 5 inches <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches > 5 inches <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified Not Specified > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Extra Small Box Not Specified NA < 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Small Box Not Specified NA < 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Medium Box Not Specified NA < 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Large Box Not Specified NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate FedEx Extra Large Box Not Specified NA < 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 1 & <= 168 cubic inches NA <= 50 lbs. FedEx Extra Small Box One Rate for FedEx Extra Small Box and other applicable services > 168 & <= 420 cubic inches NA <= 50 lbs. FedEx Small Box One Rate for FedEx Small Box and other applicable services > 420 & <= 650 cubic inches NA <= 50 lbs. FedEx Medium Box One Rate for FedEx Medium Box and other applicable services > 650 & <= 1,100 cubic inches NA <= 50 lbs. FedEx Large Box One Rate for FedEx Large Box and other applicable services > 1,100 & <= 2,200 cubic inches NA <= 50 lbs. FedEx Extra Large Box One Rate for FedEx Extra Large Box and other applicable services > 2,200 cubic inches NA <= 50 lbs. Your Packaging All applicable services except FedEx One Rate Not Specified NA > 50 lbs. Your Packaging All applicable services except FedEx One Rate Note: Thickness is defined as the shortest measurement of length, width, and height.
Packaging Type
Comprehensive Rate Quote
Use this endpoint to request a list of all possible rate quotes and optional transit information based on the input details.
The required input information associated with this request is:
- accountNumber: Specify your account information.
- returnTransitTimes: Specify if the transit time and the commit data are required in the response
- shipper: Specify the details of the shipper such as country code, postal code, and so on.
- recipient: Specify the details of the recipient such as country code, postal code, and so on.
- pickupType: Specifies the method the package is tendered to FedEx.
Example: CONTACT_FEDEX_TO_SCHEDULE, USE_SCHEDULED_PICKUP. - rateDisplayOption (optional): Controls which rates are returned in the API response..
- LOWER_RATE— Returns the lowest rate after comparing one-rate (F1R) and standard rates. If no dimensions are provided, only the customer-supplied packaging rate is returned.
- SELECTED_RATES_INCLUDING_F1R— Returns all applicable rates; no comparison is performed. One-rate and standard rates are both included.
- SELECTED_RATES_EXCLUDING_F1R— Returns all applicable rates except one-rate.
Default: If the field is omitted, or an invalid value is provided, LOWER_RATE is used.
- weight: Specify the weight of the package.
- Dimensions (optional): Specify the length, width, height, and unit of measure for the package.
Note:
- To get FedEx One Rate quotes, you must specify package dimensions. Without dimensions, the API returns account-specific/discounted rates for other applicable services only.
- The packagingType and rateDisplayOption elements are optional. Defaults are YOUR_PACKAGING and LOWER_RATE. You can change them to any standard option to fit your shipping needs.
- Use the processingOptions element to include on-call pickup rates in the response. Select the INCLUDE_PICKUPRATES value for this request.
- Use the requestType field to get pickup rate quotes for a future date. Select the FUTURE_DAY value, which will populate requestedShipment.pickupDetail.readyDateTime and requestedShipment.pickupDetail.latestPickupDateTime for request details.
- The response includes all possible rate quotes and optional transit information for applicable services, with service codes, service types, packaging types, and commitment details (example, days/time in transit, Saturday delivery).
- For decimal length, width, or height values in Web Services, only the whole number is used for rate calculations. For example, entering 9.4 will be calculated as 9.
Business Rules
- Multiple piece shipments (MPS) are not eligible for FedEx One Rate.
- Packages over 50 lbs or exceeding 2,200 cubic inches are not eligible for FedEx One Rate.
- To get a FedEx One Rate quote for an Envelope or Pak, specify the packaging type as Envelope or Pak.
- Package dimensions are required for FedEx One Rate quotes when using your own packaging. Without dimensions, only rates for other applicable services (excluding One Rate) will be returned.
- If you specify carrierCodes in the rate request, rates will be returned only for those carriers.
- The timeout limit for any rate request is 6 seconds.
- FedEx One Rate quotes are returned even if you do not select FEDEX_ONE_RATE as specialServiceTypes in the rate request.
- Use the optional flag rateDisplayOption to include or exclude FedEx One Rate quotes:
- SELECTED_RATES_INCLUDING_F1R
- SELECTED_RATES_EXCLUDING_F1R
- If rateDisplayOption is missing or invalid, it defaults to LOWER_RATE.
