
Developer Portal
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
- Enables you to get rate quotes for both FedEx One Rate and FedEx standard services for your packaging shipments.
- Saves time by providing account-specific rates, FedEx One Rate, and rate quotes for all other applicable FedEx services including FedEx Ground and FedEx Express in a single rate request.
- Improves the overall customer experience by systemically calculating the most accurate FedEx One Rate packaging type, when dimensions are provided.
- Provides a more accurate rate quote and billing experience by reducing the number of unexpected additional shipping expenses.
- Provides you with more options to meet your business needs by returning a complete portfolio of FedEx services with their corresponding rates and transit times.
- Offers you the option to save money by comparing and choosing a less expensive service.
Comprehensive Rate and Transit Times API Details
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_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:
- If Your_Packaging type is selected but the dimensions are not specified, then the API will return all possible rate quotes including FedEx Express, FedEx Ground and Ground Economy services but not FedEx One Rate.
- If Your_Packaging type is selected and dimensions and weight are specified, then the API will return all possible rate quotes including FedEx One Rate, FedEx Express, FedEx Ground and Ground Economy services.
- If your package is not One Rate eligible then also you will receive the account specific rate quotes for the other applicable services but not for FedEx One Rate.
Below volumetric and weight conditions are checked to determine the eligibility of a package for FedEx One Rate.
Packaging Type | 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 |
|
<= 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 |
||
<= 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 |
|
<= 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 Small Box |
Not Specified |
NA |
< 50 lbs. |
FedEx Small Box |
One Rate for FedEx Small Box and other applicable services |
|
<= 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 |
|
<= 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 |
|
<= 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 |
|
<= 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. |
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, etc.
- recipient: Specify the details of the recipient such as country code, postal code etc.
- pickupType: Specify the method by which the package is to be tendered to FedEx.
Example: CONTACT_FEDEX_TO_SCHEDULE, USE_SCHEDULED_PICKUP. - weight: Specify the weight of the package.
- Dimensions (optional): Specify the length, width, height, and unit of measure for the package.
Note:
- To get rate quotes for FedEx One Rate service, you must specify the dimensions of your package otherwise the API will only return the account specific/discounted rate quotes for the other applicable services.
- The element packagingType is optional and its default value is YOUR_PACKAGING. You can change it to any standard packaging type as per your shipping needs.
Result of this request will provide a list of all possible rate quotes and optional transit information for all applicable services with service code, service types, packaging types and commitment details such as days/time in transit and any specific day delivery (Saturday delivery).
Business Rules
- Multiple piece shipments (MPS) are not eligible for FedEx One Rate.
- Package weight above 50 lbs. or volume above 2,200 cubic inches are not eligible for FedEx One Rate.
- To receive a FedEx One Rate quote for an Envelope or Pak, you must specify the packaging type as Envelope or Pak respectively.
- Package dimensions are required to get the rate quotes for FedEx One Rate for your own packaging type. If dimensions are not specified, only the rate quotes for other applicable services (except One Rate) will be returned in the response.
- If you specify the carrierCodes in the rate request, then rates will be returned only for those operating companies.
- The timeout limit is 6 seconds for any rate request.
- You will get the rate quotes for FedEx One Rate services even if you do not select FEDEX_ONE_RATE as specialServiceTypes in the rate request.
JSON API Collection
Explore our JSON API collection to see how we can deliver on your business needs. Test your integration with these sample requests.
Please log in to view this API's documentation.
Enter your user ID and password to log in