FedEx Web Services

Welcome to FedEx Web Services, your convenient source for developer guides, sample code, certification, production keys, and other information you will need to integrate FedEx into a website or application you’re developing.

Learn more about FedEx Web Services

Get Started on the Right Path

To make sure your integration follows the correct process, we need to know if the application you are developing is for your company's use, or if you plan to resell it.

Your Application Is for Internal Company Use Only:

Click the steps below to get started.

icon-web-serv-documentation icon-web-serv-develop-and-test icon-web-serv-certification icon-web-serv-production

1) Documentation and Downloads

2) Develop and Test

3) Certification

4) Move to Production

Move to documentation

Move to development

Move to certification

Move to production

Your Application May Be Resold:

You must be a member of FedEx Compatible® in order to distribute your software.

FedEx Web Services Announcements

January 2016 - FedEx Web Services Coding Best Practices Guidelines

To efficiently integrate with FedEx Web Services, developers should follow these best practice guidelines. Click here for the document.

December 2015 - FedEx 2016 Rate and Pricing Changes

As you begin to plan your next year’s shipping needs, we want to inform you of changes to FedEx® Standard List Rates that will take effect on Jan. 4, 20161. Additionally, effective Jan. 4, 2016, there will be changes to shipping fees and surcharges that may apply to your shipment and affect your total shipping rate.

Which rates are changing?

  • FedEx Express package and freight standard list rates will increase an average of 4.9% for U.S., U.S. export and U.S. import services.
  • FedEx Ground and FedEx Home Delivery® standard list rates will increase an average of 4.9%.
  • FedEx International Premium® rates will change.
  • Minimum rates for FedEx Express® services will change.
  • FedEx Ground Multiweight® rates will change.
  • FedEx SmartPost® rates will change.
  • FedEx One Rate® pricing will change.
  • FedEx Freight rates will increase by 4.9% on average, applicable to the FXF 1000, FXF 501 and other related series base rates.
  • FedEx® Retail Rates will change. Use our Rate Tools application to view 2016 FedEx Retail Rates beginning Jan. 4, 2016.

Where online do I find the newest updates?
Go to fedex.com/us/2016rates to:

  • Get detailed information about rate, surcharge, fee and other changes.
  • Learn how to use FedEx rate tools.
  • Get answers to frequently asked questions.

You can also access fedex.com/us/2016rates from the fedex.com home page.

If you have any questions, please contact your FedEx customer integration consultant or contact the Technical Support Center at 1.877.FDX Assist 1.877.339.2774, Monday through Friday, 7 a.m. to 9 p.m. CST; and Saturday, 9 a.m. to 3 p.m. CST. For more information, go to fedex.com/us/2016rates.

1 Please check your FedEx shipping agreement to determine the net impact of these changes on your shipping costs.

December 2015 - Important SHA-2 Security Update for FedEx Web Services Customers

FedEx proactively enables, promotes and elevates secure automation transaction technology and communication protocol standards. As part of our commitment to ensuring strong encryption standards within SSL/TLS and code-signing certificates, on January 30, 2016, FedEx will be updating our encryption and communication protocol requirements. These new enhancements include the upgrade of our certificates to SHA-256 and only supporting TLS protocol connections; as well as, the disablement of SSLv3 protocol.

Our updated requirements reflect the new and more secure industry standards of SHA-256 (SHA-2) encryption and TLS protocol, which are in line with a broader industry shift in how browsers and websites encrypt traffic to protect the contents of online communications. As part of the update, FedEx will replace its current SHA-1 certificates with the SHA-2 standard on the following environments:

  • gateway.fedex.com
  • ws.fedex.com

What you should do:
As of January 30, 2016, customers will need to support the SHA-2 encryption and TLS protocol security standards to continue to communicate to FedEx and prevent a potential communication failure. We recommend that you test/check your applications, systems or devices that connect to FedEx to verify they support the SHA-2 and TLS standards.

If your system already supports SHA-2 security standards, then no action is necessary; but if your system only supports SHA-1 based certificate verification and/or an SSLv3 protocol, you will experience connection issues if you fail to update both. Customers will need to ensure that they have a plan to support SHA-2 and TLS prior to January 30, 2016.

Customers who need a local copy of the FedEx SSL SHA-2 certificate installed in their configuration should click on FedEx Web Services SHA-2 Certificate to register for access to the updated certificate.

FedEx Web Services customers can verify if they are SHA-2 compliant and TLS ready by testing a transaction in our FedEx Web Services test environment by pointing their application to the wsbeta.fedex.com:443/web-services/ endpoint which has been upgraded to TLS and the SHA-2 certificate. A successful transaction in our test environment indicates SHA-2 compliance.

For support:
Please ensure that the appropriate team members and customers are aware of this important update. If customers have questions or need technical assistance either before or following the update:

September 2015 – The FedEx SHA-2 September 19, 2015 Upgrade is Delayed

The initiative for FedEx to update its encryption security to SHA-256 (SHA-2) on Saturday, September 19, 2015 has been delayed. FedEx will keep you informed when this important security update will occur and provide further instructions about downloading the required certificates.

Meanwhile, please ensure that the appropriate team members are aware of this important update.

FedEx Support:

For FedEx Web Services:

 

September 2015 – FedEx September Service Update

Please be advised of the following important service updates from FedEx. Customers using FedEx Web Services will be unable to process certain transactions during the time periods listed below:

September 5, 2015: Production and Test Environment Interruption:

Start Date and Time: Saturday, September 5, 2015, 9 p.m. CT
End Date and Time: Sunday, September 6, 2015, 1 a.m. CT
Duration: 4 hours
Affected Environment: Production and Test
Affected Functionality: Rating, Shipping and Tracking

September 14-19, 2015: Test Environment Interruption:

Due to scheduled maintenance updates to the FedEx test environment, customers may encounter an unstable test environment from 7 a.m. CT September 14 to 11:59 p.m. CT September 18.

What you should do:

Please ensure that the appropriate team members are aware of these important updates. We regret any inconvenience due to these service interruptions. If you have questions or need technical assistance, please call 1.877.339.2774 or send an email to websupport@fedex.com. Support hours are 7 a.m. to 9 p.m. CT Monday through Friday and 9 a.m. to 3 p.m. CT Saturday.

For questions from Europe, the Middle East and Africa (EMEA), send an email to emeawebservices@fedex.com.

For questions from Asia-Pacific (APAC), send an email to apacwebservices@fedex.com.

July 2015 – FedEx Releases New 2015 FedEx Web Services Software

Today FedEx announces the 2015 general release of new software for FedEx Web Services. With this release, you will have access to new features and enhancements to improve your shipping experience, enable your day-to-day operations to run smoother and allow your shipping processes to work smarter.

New features in FedEx Web Services 2015 include:

 

International Shipping Enhancements:

  • Standard Overnight Intra-Canada Express Service gives you a next-business-day delivery
  • Delivery International First Expansion provides a 2-day business delivery to 32 new origin countries for a fast international shipping service
  • Currency Conversion improves the conversion process to accurately calculate surcharge amounts and customs values

FedEx Ground® Shipping Enhancements:

  • Service Availability Enhancements provide a number of FedEx Ground transit times with service availability requests; now you can make better shipping decisions with more ease

Dangerous Goods Shipping Enhancements:

  • FedEx Express Dangerous Goods Enhancements allow you to add more qualifying words to the technical name. You now have the option to include global telephone numbers within the fields available for dangerous goods

Shipping Label Enhancements:

  • FedEx SmartPost Label Standardization allows you to indicate what to print in the secondary barcode space on your label
  • Customize Non-Shipping Labels allow you to include graphics, barcodes, text and boxes to accentuate information
  • Automation Label Standardization changes the FedEx plain paper label layout from a 7 x 4 3/4” PDF or PNG image label to an image of the 4 x 6” thermal label for U.S. domestic FedEx Express® and FedEx Ground® shipments only. The thermal label image will be rotated 90°. There are no other changes, but the labels will look differently.

 

To view the technical documentation and the What’s New document, click here.

Thank you for using FedEx Web Services. We appreciate your business.

 

July 2015 – FedEx Web Services Corporate Load Changes

Click here for new enhancements and software changes in FedEx Web Services as part of the summer corporate load.

June 2015 – FedEx Web Services Secure Socket Layer (SSL) Certificate SHA-2 Upgrade on September 19, 2015

As technology evolves, it is critical to stay ahead of those who wish to defeat cryptographic technologies for their malicious benefit. FedEx continues to make FedEx Web Services transactions and communication protocols more secure by proactively enabling, promoting and elevating strong cryptographic standards within SSL/TLS and code-signing certificates.

The initiative to migrate from SHA-1 to SHA-256 (SHA-2) is the next proactive phase to better secure websites, intranet communications and applications. Organizations must develop a migration plan for any SHA-1 SSL and code signing certificates prior to February 2016.

As part of this effort, FedEx has developed the following migration plans from allowing SSLv3 as an accepted SSL Protocol and for switching from SHA-1 to SHA-2 SSL certificates:

 

Affected Certificate/Protocol

Environment / URL

Upgrade Date

SSLv3 disablement

Test: gatewaybeta.fedex.com and wsbeta.fedex.com

July 20, 2015

SHA-256 upgrade

Test: gatewaybeta.fedex.com and wsbeta.fedex.com

August 3, 2015

SSLv3 disablement

Production: gateway.fedex.com and ws.fedex.com

September 5, 2015

SHA-256 upgrade

Production: gateway.fedex.com and ws.fedex.com

September 19, 2015

What you should do:
Customers who need a local copy of the FedEx SSL SHA-2 certificate installed in their configuration can download the updated certificate, beginning July 22, 2015, by clicking the appropriate link:

  • For gatewaybeta.fedex.com and gateway.fedex.com click here or enter the following URL into the browser: http://www.fedex.com//images.fedex.com/us/developer/downloads/gatewaybeta-gateway.BETA-PROD-SHA2.zip
  • For wsbeta.fedex.com and ws.fedex.com click here or enter the following URL into the browser: http://www.fedex.com//images.fedex.com/us/developer/downloads/wsbeta-ws.fedex.com.BETA-PROD-SHA2.zip

The SHA-2 site certificate for gatewaybeta.fedex.com and gateway.fedex.com will expire on February 24, 2016 and the site certificate for wsbeta.fedex.com and ws.fedex.com will expire on March 4, 2016.

Customers requiring a local copy must install the new certificate prior to the SHA-256 upgrade dates, or their FedEx test integration will not function.

For support
Please ensure that the appropriate team members are aware of this important update. If you have questions or need technical assistance following the update, please call 1.877.339.2774 or send an email to websupport@fedex.com. Support hours are 7 a.m. to 9 p.m. CT Monday through Friday and 9 a.m. to 3 p.m. CT Saturday.

For questions from Europe, the Middle East and Africa (EMEA), send an email to emeawebservices@fedex.comemeawebservices@fedex.com.

For questions from Asia-Pacific (APAC), send an email to apacwebservices@fedex.com.

February 2015 – FedEx Web Services Secure Socket Layer (SSL) Certificate Renewal

FedEx will renew the site certificate with VeriSign for the following FedEx Web Services servers on February 21, 2015:

  • gatewaybeta.fedex.com
  • gateway.fedex.com
  • ws.fedex.com
  • wsbeta.fedex.com

Customers who need a local copy of the FedEx SSL certificate installed in their configuration can download the updated certificate, beginning February 17, 2015, by clicking the appropriate link:

  • For gatewaybeta.fedex.com and gateway.fedex.com click here or by typing the following URL into their browser: /us/developer/downloads/gatewaybeta-gateway-beta-prod-2015.zip
  • For wsbeta.fedex.com and ws.fedex.com click here or by typing the following URL into their browser: /us/developer/downloads/wsbeta-ws.fedex.com-beta-prod-2015.zip

The site certificate for gatewaybeta.fedex.com and gateway.fedex.com will expire on February 24, 2015 and the site certificate for wsbeta.fedex.com and ws.fedex.com will expire on March 4, 2015. Customers requiring a local copy must install the new certificate prior to February 24, 2015, or their FedEx test integration will not function.

If you have any questions or need technical assistance, please contact the FedEx Help Desk at 1.877.339.2774 or send an email to websupport@fedex.com.

January 2015 – FedEx Service Update for January 2015

Please be advised of the following important service updates from FedEx. Customers using FedEx Web Services will be unable to process certain transactions during the time periods listed in the attached document. Click here for additional details.

September 2014 – Retirement of Freight XML Tracking

After December 31, 2014, FedEx Freight will no longer support the Extensible Markup Language (XML) tracking application. We recommend integrating FedEx Web Services into your systems moving forward.

For more information click here.

August 2014 – FedEx Web Services 2014 is Now Available

FedEx announces the 2014 general release of FedEx Web Services. With this new release, you will have access to new features and enhancements that will enable your day-to-day operations to run smoother and shipping processes to work smarter.

Experience the Difference

Features available in FedEx Web Services 2014 include:

  • FedEx Global Returns Email Return Labels
  • Expansion of Global Domestic Services
  • A variety of international enhancements
  • New specialty services enhancements

Learn More

To learn more about this release and for more feature details, click to view the What’s New document.

To take advantage of all the new features in FedEx Web Services, contact your FedEx customer integration consultant or contact the FedEx Technical Support Center at 1.877.FDX. Assist 1.877.339.2774 and say "FedEx Web Services" when prompted.

February 2014 – FedEx Web Services Secure Socket Layer (SSL) Certificate Renewal

FedEx will renew the site certificate with VeriSign for the following FedEx Web Services servers on March 01, 2014:

  • gatewaybeta.fedex.com
  • gateway.fedex.com
  • ws.fedex.com
  • wsbeta.fedex.com

Customers who need a local copy of the FedEx SSL certificate installed in their configuration can download the updated certificate, beginning February 25, 2014, by clicking the appropriate link:

The site certificate for gatewaybeta.fedex.com will expire on March 4, 2014. Customers requiring a local copy must install the new certificate prior to March 04, 2014, or their FedEx test integration will not function.

If you have any questions or need technical assistance, please contact the FedEx Help Desk at 1.877.339.2774 or send an email to websupport@fedex.com.

 

January 2014 – Address Validation Database Change for Web Services

FedEx has improved the reliability and accuracy of address validation within FedEx Web Services by implementing a new Address Validation Database. In addition to improved results, you will notice slight differences in transaction responses. For more information about the new Address Validation Database and the data differences you may notice, click here.

2014 Rate and Pricing Changes for FedEx® Services

As you begin to plan for next year’s shipping needs, we want to let you know about changes to
FedEx standard list rates that will take effect Jan. 6, 2014.1

Which rates are changing?

  • FedEx Express package and freight rates will increase an average of 3.9% for U.S., U.S. export and U.S. import services.
  • FedEx Express is not adjusting the fuel price at which the fuel surcharge begins and is not reducing the fuel surcharge.
  • FedEx One RateSM pricing will not change.
  • There will be an increase in FedEx Ground, FedEx Home Delivery® and FedEx SmartPost® rates.
  • Minimum rates for FedEx Express® services will change.
  • Select surcharge, fee and other changes will also take effect Jan. 6, 2014.

Where online do I find the newest updates?

Go to fedex.com/rates2014 to:

  • Get detailed information about rate, surcharge, fee and other changes.
  • Find out how to use FedEx rate tools.
  • Get answers to frequently asked questions.

What are my options to learn more?

We provide several ways for you to obtain rate information:

  • Go to our dedicated website at fedex.com/rates2014 or access it from the fedex.com
    home page.
  • Beginning Dec. 13, 2013, you can go to fedex.com/2014serviceguide to download the
    January 6, 2014, FedEx Service Guide.

If you have any questions, please contact your FedEx customer integration consultant or contact the Technical Support Center at 1.877.FDX Assist 1.877.339.2774, Monday through Friday, 7 a.m. to 9 p.m. CST; and Saturday, 9 a.m. to 3 p.m. CST. For more information, go to fedex.com/us/2014rates/.

Thank you
We appreciate your confidence in us and look forward to serving you in the future.

1 Please check your FedEx shipping agreement to determine the net impact of these changes on your shipping costs.

See all announcements

See all announcements

Services Available Through FedEx Web Services

The following services are available. To get started click here.

Standard Services
(no certification required)

  • Rate Services
  • Service Availability
  • Tracking and Visibility
  • FedEx Locator

Advanced Services
(require a certification process)

  • Shipping Services
  • Upload Document Services
  • Pickup Services
  • FedEx ExpressTag®
  • Close Services
  • Open Shipping
  • Address Validation

FAQs for FedEx Web Services

Find answers to commonly asked questions.

See FAQs