An update is scheduled to the FedEx Developer Portal on January 18, 2025, from 8:00PM to 10:00PM CST
and the portal will be unavailable during this time.
Developer Portal
Rates and Transit Times API
Introduction
This detailed guide will help you to learn all that you need to know about rates and transit times. FedEx provides you the estimated delivery date/time and rate quotes for each service offered.
When requesting rate quotes, it is important to specify the details of the shipment. This will include the date, detailed origin address, destination address, dimensions, and the package weight. By providing these accurate details, you can ensure that you receive the correct quote for your shipment. If you have any special requirements, such as shipping hazardous goods, you must specify these requirements in the shipment details.
Note: The Rate 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.
FedEx Rates and Transit Times API Details
When planning your budget, it helps you to know the estimated cost of shipping. FedEx offers a variety of rates to cater to your needs. You can request rates for your FedEx shipments. Apart from that there are list rates, discounts, surcharges, fees and other factors that can affect your shipping rates.
Following are the features associated with this API:
- Get Quick Rate Quote
Get quick rate quotes and transit times without entering detailed package descriptions.
- Transit time
Get transit times for services between source and destination.
- Detailed Rate Quote
Get rate quotes, transit times, including duty and tax estimates for domestic as well as international shipment. Customers must input detailed shipment information, including package dimensions, declared value (DV) amounts, and additional service options. Duty and tax estimates are only available to FedEx customers who are shipping products/commodities, and not documents.
Benefits of the FedEx Rates and Transit Times API:
- Simplifies shipment planning by determining costs and transit times from any origin to any destination worldwide.
- Provides both standard list and account-specific rate quotes for various FedEx services.
- Saves time with quick access to account-specific rates.
- Saves money by comparing rates by service and allowing you to make decisions based on your shipping needs.
- Saves time with quick answers to shipment cost and delivery date questions.
This API provides a shipping rate quote for a specific service combination depending on the origin and destination information supplied in the request. The following details apply:
- Discount rates are available for all services and origin/destination pairs.
- This API returns rate for the origin and destination for the requested service and will not validate whether that service is available for your ship date as well as origin and destination.
- Rates can also be retrieved for intra-Mexico FedEx Express shipping.
- Rates are also available for FedEx Ground® Economy (Formerly known as FedEx SmartPost®) Shipping.
- Service-specific commitment and rate information may also be specified.
For more detailed information about the services offered by FedEx, see the electronic FedEx Service Guide.
How FedEx Rates and Transit Times API Works
Rate and Transit Times
Request a list of all possible rates quotes and optional transit information based on input details. The required input information associated with this request are:
- Account Number
- Shipment details.
When requesting rates and transit times:
- Include as much detail as possible about your shipment. This information is important for calculating the correct shipping costs with surcharges.
- Use the RateRequestTypes element to request specific rates whether LIST or account specific. If you choose LIST as the element value, you receive both account specific and list rates.
- For requesting rate quotes for a single service, specify the service to ensure rate data for the service is returned. Multiple services rates are returned, if you do not include the ServiceType value.
- For carrier specific detailed rates, specify the carrier by using CarrierCode in your request and rate data for all services for the input carrier will be returned, or do not specify a CarrierCode to receive all available services from all carriers in the return.
- Use the returnTransitTimes element to include transit time information in the reply. FedEx Express, FedEx Ground and FedEx Home Delivery do include the estimated days and date the package will be delivered, based on the ship date you specified.
- The response for the transit times request for FedEx Ground® Economy (Formerly known as FedEx SmartPost®) will include specific delivery date and day of the week, based on the values specified in the request.
- Information such as carrier code, service type or service option can be used to filter the results.
- Results can be sorted (Element: rateSortOrder) in order to get the rate quote data in a desired way/format.
Rates and Transit Times Response
Result of this request will provide a list of all possible rate quotes and optional transit information with service code, service types, packaging types and commitment details such as days/time in transit and any specific day delivery (Saturday delivery).
The following are the rates and charges returned in response:
- LIST Rates – returns published list rates in addition to account-based (if applicable).
- PREFERRED Rates – returns rates in Preferred Currency provided in the request.
- INCENTIVE Rates – promotional pricing.
- ACCOUNT Rates – account assigned rates
- Surcharges
- Discounts
- Fees and Taxes
Note: A rate request does not return route. All rate quotes are estimates only and may differ from the actual invoiced amount.
For more information on discount programs refer to Discounts.
FedEx Special Rates
Multiple-Piece Shipment Rates
This option is available with FedEx Domestic, FedEx International multiple-piece shipments (MPS), FedEx domestic as well as International Ground® MPS, FedEx Express international C.O.D. multiple-piece shipments, and FedEx Ground international C.O.D. multiple-piece shipments.
U.S. Package Rates: FedEx Express Multiweight®
FedEx Express multiple-piece shipments may receive a rate on a total-shipment-weight basis if the total shipment weighs 100 lbs. or more (200 lbs. or more for FedEx Express Saver® shipments). A 15-lbs. average minimum package weight for the shipment applies. Multiply the per-pound rate by total shipment weight. The lowest rate out of the FedEx Express Multiweight shipment rate or the sum of the individual price per package will be selected and automatically applied in the billing.
FedEx One Rate
FedEx One Rate is flat-rate shipping that does not require you to weigh or measure shipments under 50 lbs. You can choose the box or tube that best fits the size of what they need to ship and fill the package to capacity, as long as the shipment doesn’t exceed 50 pounds. It gives you a simple, predictable, flat rate shipping option for your FedEx Express packages. FedEx One Rate a shipping portfolio based on six FedEx Express Service options, combined with seven FedEx proprietary (white) packaging types.
FedEx One Rate Packaging
The FedEx packaging types that are valid/available with the One Rate pricing option are:
- FEDEX_ENVELOPE
- FEDEX_SMALL_BOX
- FEDEX_MEDIUM_BOX
- FEDEX_LARGE_BOX
- FEDEX_EXTRA_LARGE_BOX
- FEDEX_PAK
- FEDEX_TUBE
Your own packaging is not available for the One Rate pricing option.
For more information about packaging services refer to Packaging Types
How to Specify One Rate Pricing
To specify FedEx One Rate Pricing Option, perform the following steps:
- Specify the \"FEDEX_ONE_RATE\" Shipment Special Service.
- Specify one of the Packaging Types.
- Specify a U.S. origin and a U.S. destination.
- Specify one of the following FedEx Express service types:
- FIRST_OVERNIGHT
- PRIORITY_OVERNIGHT
- STANDARD_OVERNIGHT
- FEDEX_2_DAY
- FEDEX_2_DAY_AM
- EXPRESS_SAVER
Note: Intra-Hawaii shipments are not allowed for One Rate pricing.
Note: FedEx customers can request both One Rate and weight based (non-One Rate) rates in a single Rate Request by specifying \"FEDEX_ONE_RATE\" as a Service Option Type in the request.
Variable Handling Fees and Charges
Variable handling fee
Any additional handling fees charged in addition to shipping charges for your shipping operation are added to your total shipment charge. These charges are returned in the Rate reply and can be configured to print on the Doc-Tab. For more information refer to Variable Handling Fees
Rate Surcharge Return
For any additional special handling or services the surcharges are charged in addition to shipping charges for your shipment. These charges are returned in the Rate reply.
The rate quote returns the available surcharges along with the rate details.
Surcharges returned in the Rate reply are as follows:
- Total surcharge
- Total taxes (for Canadian origin shipments)
- Itemized surcharge
For more information refer to Surcharges
Fees and Other Shipping Information
Your shipment may incur fees in addition to its base rate.
- For FedEx Express U.S. import shipments, fees vary depending on origin country; however, each fee works the same as for U.S. export.
- U.S. Express Package Services includes FedEx First Overnight®, FedEx Priority Overnight®, FedEx Standard Overnight®, FedEx 2Day® A.M., FedEx 2Day® and FedEx Express Saver®.
- U.S. Ground Services includes FedEx Ground® and FedEx Home Delivery®.
- International Express Package Services includes FedEx International First®, FedEx International Priority®, FedEx International Economy®, and Fedex Deferred Freight.
- International Ground Service includes FedEx International Ground® .[Service ENUM : FEDEX_GROUND]
Business Rules
- Do not assume a particular service will be available for all scenarios. For example, STANDARD_OVERNIGHT (among others) is not available between all postal codes.
- If a specific service is being requested for rating, include the Service Type in the request. This will decrease the size of the reply and reduce transaction response time.
- Multiple piece shipments (MPS) are not eligible for FedEx One Rate.
- For a special service to be included on a shipment, both the special service type and its detail must be included. If the special service details are not included, then there may be no indication that the special services are not included.
- The timestamp for a rate or shipment should be the time the package is expected to be tendered to FedEx or a FedEx agent. This is not necessarily the time at which the ship or rate transaction is performed. For example, a shipment generated late Friday night for a package that will not be picked up by FedEx until Monday should have a Monday timestamp. Use the correct timestamp if it is known, or the delivery estimation and rates may not be correct.
- The rate and transit time application only uses city name or zip/postal code to define transit time. FedEx only displays the city or zip/postal code served by FedEx in the destination and origin countries you selected.
- FedEx does not deliver to Post Office Box addresses in the U.S. Please enter a Zip Code to find the transit time for your shipment or click on Find Zip/Postal code.
- Packages picked up from a residence may have one additional transit day. For faster returns please drop off at a staffed FedEx location.
- Pharmacy delivery is not valid with Hold at location.
Rates and Transit Times API (1.0.0)
Error Codes
COUNTRY.POSTALCODEORZIP.INVALID
Invalid postal code/ZIP for the country selected. Please correct and try again.
CURRENCY.TYPE.INVALID
The currency type you selected is invalid. Please select another currency type.
CURRENCYTYPE.CADORUSD.REQUIRED
CAD or USD are the only currency types available. Please select CAD or USD as your currency type.
CUSTOMVALUE.LIMITEXCEEDS.ERROR
The total declared value for customs entered exceeds the limit for FedEx® international services.For additional information, including other services that may be available, please contact FedEx Customer Service.
DIMENSIONS.EXCEEDS.LIMITS
Dimensions exceeds the maximum dimensions for this service. Please refer to the FedEx Service Guide.
POSTALCODE.ZIPCODE.REQUIRED
Postal code/ZIP is required
CURRENCY.TYPE.MISMATCH
Declared value currency type must be equal to customs value currency type.
ACCOUNT.NUMBER.INVALID
Invalid account number.
ACCOUNTNUMBER.ENROLLED.INVALID
The shipping account number is not enrolled in FedEx Priority Alert(TM) service.
ACCOUNTNUMBER.ONERATE.NOTAVBL
FedEx One Rate® is not available for this account. Please use FedEx Standard Rate.
CARRIAGE.VALUE.EXCEEDSMAXIMUM
The declared value for carriage entered exceeds the maximum. Please verify and reenter
CARRIAGEVALUE.CUSTOMVALUE.VALIDATION
Rates and transit times are not available for the account number entered. For immediate assistance, please contact your local FedEx Customer Service.
CITY.REQUIRED
A valid city is required
COUNTRY.POSTALCODE.INVALID
Origin postal code is required or invalid.
SHIPPER.POSTALSTATE.MISMATCH
Shipper Postal-State Mismatch. Please correct and try again.
CURRENCY.MISSMATCH.ERROR
Package insured value currency {CURRENCY_TYPE_1} does not match the customs value currency {CURRENCY_TYPE_2}.
CURRENCY.TYPE.SELECT
Please enter Currency
CURRENCYAMOUNT.CURRENCYTYPE.INVALID
The maximum declared value is {CURRENCY_AMOUNT} {CURRENCY_TYPE}. Contact FedEx Customer Service for more information.
CURRENCYTYPE.CADORUSD.ONLYAVAILABLEERROR
Based on the information entered this shipment qualifies for FedEx Home Delivery®. Please resubmit your request as FedEx Home Delivery to continue with the shipment.
DELIVERY.DAY.ERROR
Please choose either Saturday Pickup or Saturday Delivery.
DIMENSION.EXCEEDS.MAXMUM
The dimensions entered exceed the maximum dimensions for this service. Please refer to the FedEx Service Guide.
DIMENSION.TYPE.ERROR
The dimensions you have entered exceed the limit for the origin and/or destination selected; please verify and reenter.
DIMENSIONS.EXCEEDS.LIMIT
The dimensions you have entered exceed the height limit allowed; please verify and reenter.
ENTERED.ZIPCODE.NOTFOUND
The state or province and ZIP or postal code entered was not found, or the state or province and ZIP or postal code are not served by FedEx in this country.
SERVICE.PACKAGECOMBINATION.INVALID
Invalid service and packaging combination.
FEDEXHOMEDELIVERY.SERVICE.QUALIFICATIONERROR
Based on the information entered this shipment qualifies for FedEx Home Delivery®. Please resubmit your request as FedEx Home Delivery to continue with the shipment.
FEDEXSERVICE.NOT.AVAILABLE
FedEx does not provide services to the destination country or from the origin country at this time. Contact FedEx Customer Service.
FREIGHTGUARANTEE.TIMEVALUE.REQUIRED
A valid Freight Guarantee time value is required.
FREIGHTGUARANTEEE.TIME.REQUIRED
{PACKAGING_TYPE} cannot exceed {weight}{weight_units}. Select another packaging type.
DECLAREDVALUE.NOT.ALLOWED.FOR.SMARTPOST
Declared Value is not allowed for SmartPost.
LOCATION.PICKUP.NOTAVAILABLE
Your location does not allow pickup. Select Drop-off to drop your package off at a FedEx location or contact FedEx Customer Service.
MAXIMUMWEIGHT.TYPE.ERROR
Maximum weight allowed for this application is 68kg/150lbs. Please re-enter weight or contact FedEx Customer Service.
ORIGIN.COUNTRY.REQUIRED
A valid origin country is required
ORIGIN.PICKUP.ERROR
The origin selected does not allow pickup for FedEx Express Freight services. You may contact your local FedEx Customer Service (U.S. and Canada, please dial 1.800.GoFedEx 1.800.463.3339) for other shipment collection options.
ORIGIN.PICKUP.NOTALLOWED
The declared value for carriage entered exceeds the maximum. Please verify and re-enter.
PACKAGE.INVALID.TYPE
Section II Lithium Batteries/Cells are not allowed with a document shipment.
PACKAGE.WEIGHT.INVALID
Package weight is missing or invalid.
PACKAGEDIMENSION.TYPE.ERROR
Package dimensions must be at least 1 cm/inch for length, width and height. If you''re not sure of the dimensions, you can leave these fields blank.
RATE.SPECIALSERVICETYPE.NOTALLOWED
Special Service {0} is not allowed.
PICKUPTYPE.NOT.AVAILABLE
Pickup is not available. Please change the service type, the ship date or select dropoff to complete the shipment.
RATING.CARRIAGE.EXCEEDSLIMITS
Declared value for carriage exceeds limit allowed based on the information entered.
RATING.CARRIAGLIMITS.EXCEED
Dimensions exceed the maximum dimensions for this service. Please refer to the FedEx Service Guide.
RATING.DIMENSIONSEXCEEDS.LIMITS
Customs Value exceeds limit of {CURRENCY_AMOUNT} {CURRENCY_TYPE}.
RATING.DIMENSIONSTYPE.EXCEEDSLIMITS
Dangerous Goods shipping has not been enabled for your account. Please call your local FedEx customer service for assistance.
RATING.ZIPCODE.INVALID
Information about rates and delivery times is not available. Try again later or contact FedEx Customer Service
RATE.PACKAGES.WEIGHT.UNIT.MISMATCH
Weight unit of measure must be the same for all packages.
RESIDENTIAL.DELIVERY.NOTAVAILABLE
Residential delivery is not available for the selected service.
SERVICE.LOCATION.UNAVAILABLE
FedEx service is not currently available to this origin / destination combination. Enter new information or contact FedEx Customer Service (U.S. and Canada, please dial 1.800.GoFedEx 1.800.463.3339).
SERVICETYPE.FORPOSTALCODE.NOTALLOWED
The declared value for carriage entered exceeds the maximum. Please verify and re-enter.
SHIPMENT.DGDIVIOLATIONS.NOTALLOWED
Your shipment is not allowed because of dangerous goods or dry ice violations that limit your shipping options. If you have any questions, please call your local FedEx customer service.
SHIPMENT.DGVIOLATIONS.NOTALLOWED
Your shipment is not allowed because of dangerous goods violations that limit your shipping options. If you have any questions, please call 1.800.463.339 and press "81" for the FedEx Dangerous Goods/Hazardous Materials hotline.
WEIGHT.BELOWMINIMUMLIMIT.ERROR
The weight entered is below the standard minimum for FedEx {package} Express services. Please enter a weight of at least {WEIGHT} {WEIGHT_UNITS}.
SHIPMENTPROCESSING.ACCOUNTVIOLATIONS.ERROR
There are no services returned due to dangerous goods, hazardous materials, or dry ice violations on your account.
STATE.TYPE.INVALID
A valid State/Province is required
STATE.TYPE.REQUIRED
State/Province is required
SUBTYPE.SELECT.FORBATTERIES
Section II Lithium Batteries/Cells and one of the sub-types must be selected.
WEIGHT.TYPE.INVALID
Please enter a valid weight.
RATE.QUOTENO.NOTFOUND
Rate quote number could not be found
ACCOUNTNBR.MISSING.ORINVALID
The condition type ACCOUNT_NUMBER value is missing or invalid
SPECIAL.SERVICE.CONFLICT
Special service conflict.Hold At Location is not valid with Residential Delivery.
DRYICEWEIGHT.REQUIRED.INKGS
Package {0} - Dry Ice weight (in kilograms) is required with Dry Ice special service.
SERVICETYPE.PICKUPMETHOD.NOT.ALLOWED
{0} is not allowed with the pickup method.
FXSPRETURN.RATES.ERROR
Rates for SmartPost return shipments are not currently available.
RATE.SPECIALSERVICE.NOTALLOWED.ORIGIN
{0} is not allowed for the origin.
PACKAGINGTYPE.MISSING.OR.INVALID
Packaging type missing or invalid.
RATE.SPECIALSERVICE.NOT.ALLOWED
Package {0} – Special Service {1} is not allowed.
SMARTPOST.HUBID.INVALID
SmartPost hub id is invalid.
SPECIALSERVICE.NOT.ALLOWED.SHIPMENTORPACKAGE
Special Service {0} not allowed at {1} level.
SPECIALSERVICE.NOT.SUPPORTED.REQUESTED.SHIPDAY
{0} is not supported for the requested ship day of the week. Please update and try again.
CODDETAIL.EMPTY.ORNULL
Package {0} - CodDetail object cannot be null.
DESTINATION.POSTALCODE.MISSING.ORINVALID
Destination postal code missing or invalid.
TOTALCUSTOMSVALUE.CURRENCYTYPE.INVALID
Invalid currency type for total customs value.
RATE.PACKAGES.DIMENSION.UNIT.MISMATCH
Dimension unit of measure must be the same for all packages.
COMMODITY.NUMBEROFPIECES.REQUIRED
Commodity {COMMODITY_INDEX} - Number of pieces is required and cannot be a negative value or exceed 9,999.
PICKUPTYPE.REQUIRED
PickupType element is required in input request.
ORIGIN.COUNTRY.INVALID
Origin country code is invalid or missing. Please refer to documentation for valid format.
DESTINATION.COUNTRY.INVALID
Destination country code is invalid or missing. Please refer to documentation for valid format.
MAXIMUM.WEIGHT.EXCEEDED
The package weight in the request is not supported. Maximum package weight across all services is 2200 lbs or 998 kgs.
ACCOUNT.NUMBER.MISMATCH
When payment Type is SENDER, ShippingChargesPayment Payor AccountNumber should match the shipper account number.
SHIPDATESTAMP.FORMAT.INVALID
Please provide a valid shipDatestamp format YYYY-MM-DD
INTERNAL.SERVER.ERROR
We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time.
RATING.DESTINATIONSTATEPOSTAL.MISMATCH
Destination state postal code mismatch.
ACCOUNT.NUMBERORKEY.INVALID
Invalid account information. Account number and/or key is invalid.
RATING.QUOTE.NOTAVAILABLE
Rates and transit times are not available for the account number entered. For immediate assistance, please contact your local FedEx Customer Service.
SHIPPER.COUNTRY.INVALID
Shipper country code is invalid or missing. Please update and try again.
FREIGHTSERVICEORIGIN.FREIGHT.NOTALLOWED
The origin is not served for Freight services.
FREIGHTSERVICEORIGIN.PICKUP.NOTALLOWED
The origin does not allow pickup for Freight services.
REGIONAL.MAILPICKUP.NOTALLOWED
Regional Mail Pickup is not allowed.
REGIONAL.MAILDELIVERY.NOTALLOWED
Regional Mail Delivery is not allowed.
FREIGHT.GUARANTEE.NOTALLOWED
Freight Guarantee is not allowed.
SHIPMENT.CUSTOMSVALUE.REQUIRED
Commodity {COMMODITY_INDEX} - Customs value is required.Please update and try again.
ORIGINZIPCODE.SERVICE.ERROR
This origin postal code is not serviced.
SERVICETYPE.NOT.ALLOWED
Selected Service Type is not allowed between origin and destination. Please update and try again.
ACCOUNT.HAZARDOUSMATERIALS.NOTALLOWED
Hazardous material shipping is not enabled for your account.
DECLAREDVALUE.EXCEEDS.LIMIT
Declared value exceeds allowed limit. Please update and try again.
ENTERED.AMOUNT.INVALID
The entered amount for COD for Package {PACKAGE_INDEX} has exceeded the maximum limit. Please update and try again.
PACKAGE.DECLAREDVALUE.EXCEEDED
Package {PACKAGE_INDEX} - Declared value exceeds limit of {CURRENCY_AMOUNT} {CURRENCY_TYPE} for the packaging type.
PACKAGETYPE.DECLAREDVALUE.EXCEEDED
Declared value exceeds limit of {CURRENCY_AMOUNT} {CURRENCY_TYPE} for package {PACKAGE_INDEX}. Please update and try again.
SERVICE.TYPE.NOTAVAILABLE
The requested service type is not supported. Please update and try again.
SPECIALSERVICE.PICKUPMETHOD.NOT.ALLOWED
{SPECIAL_SERVICE_TYPE} is not allowed with the pickup method. Please update and try again.
SHIPMENT.DGHMDIVIOLATIONS.NOTALLOWED
{SERVICE_TYPE} service is not allowed because of dangerous goods or dry ice violations that limit your shipping options. Please update and try again.
CURRENCYAMOUNT.CURRENCYTYPE.EXCEEDSLIMIT
The total declared value for customs entered exceeds the limit of {CURRENCY_AMOUNT} {CURRENCY_TYPE} for {SPECIAL_SERVICE_TYPE}. Please update and try again.
