Product

FedEx Web Services

FedEx Web Services

Integrate FedEx functionality into the application you are developing.

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. 

Documentation

document icon
FedEx Web Services Developer Guide

Available online or as a PDF download, the following online guide and PDF documents are searchable for easy access to information:

documents icon
Other Documents

Other helpful FedEx Web Services documents:

Downloads

download icon

Select a service below to download WSDLs. Sample code is also available in Java, C#, VB.Net, and PHP. (Note: C# and VB.NET sample code was created using Visual Studio 2017.) You can also click and download PDF documentation to view the pertinent chapter of documentation.

For regional availability of each feature, please see the FedEx Web Services Online Developer Guide.

Please note: The documents referenced above are provided in Adobe® Acrobat® Portable Document Format (PDF). To read these files, download Adobe Reader® here.

Rate
Download WSDL or XSD
Service Availability
Download WSDL or XSD
Postal Code Inquiry
Download WSDL or XSD
Track
Download WSDL or XSD
Signature Proof of Delivery
Download WSDL or XSD
Notification
Download WSDL or XSD
Search Locations
Download WSDL or XSD
Download all
Download WSDL or XSD
Create Shipment
Download WSDL or XSD
Cancel Shipment
Download WSDL or XSD
Shipment Validation
Download WSDL or XSD
Return Tag
Download WSDL or XSD
Cancel Return Tag
Download WSDL or XSD
ETD/Upload Service
Download WSDL or XSD
Pickup
Download WSDL or XSD
Cancel Pickup
Download WSDL or XSD
Pickup Availability
Download WSDL or XSD
Express Tag Availability
Download WSDL or XSD
SmartPost Close
Download WSDL or XSD
Close Shipment (Ground Only)
Download WSDL or XSD
Reprint Close Report
Download WSDL or XSD
Create Email Label
Download WSDL or XSD
Add Packages
Download WSDL or XSD
Delete Packages
Download WSDL or XSD
Create Open Shipment
Download WSDL or XSD
Delete Open Shipment
Download WSDL or XSD
Modify Open Shipment
Download WSDL or XSD
Validate Open Shipment
Download WSDL or XSD
Confirm Open Shipment
Download WSDL or XSD
Retrieve Open Shipment
Download WSDL or XSD
DGDS
Download WSDL or XSD
DGLD
Download WSDL or XSD
Address Validation
Download WSDL or XSD
In-Flight Shipment Service
Download WSDL or XSD
Download All
Download WSDL or XSD

The FedEx Web Services Testing Environment is a functional, full-runtime environment ideal for testing your web services solutions. Although good for confirming functionality, the Testing Environment should not be used for stress testing. It is recommended that developers test to ensure that their code operates as desired.

laptop icon

Obtain Test Key
Obtaining a set of testing credentials is easy. Once you have read and accepted the terms and conditions of the Testing Agreement, you will receive a Test Account Number, a Test Meter Number, and a Developer Test Key and Password. These credentials must be included in your code as specified in the FedEx Web Services technical documentation. Without this information, your transactions will be rejected. Once your code includes the testing credentials, you may proceed to fully testing your application.

When shipping with FedEx Freight LTL using FedEx Web Services, you will need a FedEx Express account as well as a FedEx Freight account within your application. Test accounts are provided for both operating companies when you register for test credentials. If you do not have a FedEx Freight account established for production, please call 1.866.393.4585.

The FedEx Testing Environment does incur unexpected downtime throughout the year, and may see extended downtime during our twice-a-year corporate loads in January and June.
International customers who intend to test intra-country shipping services within Austria, Belgium, Czech Republic, Denmark, Finland, France, Germany, Hungary, Italy, Luxembourg, Netherlands, Norway, Poland, Spain, Sweden, Switzerland, and Russia must obtain a specific test credential for each country in addition to a U.S. and Global account number.

laptop icon

Certification
Once the developer has completed the design, implementation, and testing of their projects, they must certify their applications with FedEx. Certification is the process of determining if your implementation meets a number of requirements to achieve the safe, secure, and effective operation of your solution in the FedEx production environment.

An outline of the basic process is below.

Standard Services are automatically enabled for production. Simply apply for FedEx Production Credentials on the next tab or click Move to Production. Credentials include Meter Number, Authentication Key, and Password.

Standard Services include:

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

Advanced Services Without Label Certification requires enablement by FedEx.


Advanced Services Without Label Certification include:

  • Address Validation
  • Pickup Services
  • Email Label
  • Return Tags
  • FedEx Express Tag® Availability
  • Close Service

Advanced Services with Label Certification requires label evaluation and enablement by FedEx.


Advanced Services With Label Certification include:

  • FedEx Shipping
  • Open Shipping
  • Upload Document Service

The documents referenced above are provided in Adobe® Acrobat® Portable Document Format (PDF). To read these files, download Adobe Reader® here.

When shipping with FedEx Freight LTL using FedEx Web Services, you will need a FedEx Express account as well as a FedEx Freight account within your application. Test accounts are provided for both operating companies when you register for test credentials. If you do not have a FedEx Freight account established for production, please call 1.866.393.4585.
The FedEx Testing Environment does incur unexpected downtime throughout the year, and you may see extended downtime during our twice-a-year corporate loads in January and July.
International customers who intend to test intra-country shipping services within Australia, Austria, Belgium, Colombia, Czech Republic, Denmark, Finland, France, Germany, Hungary, India, Italy, Luxembourg, Mexico, Netherlands, Norway, Poland, Russia, Spain, Sweden, Switzerland, United Arab Emirates, and United Kingdom must obtain a specific test credential for each country in addition to a U.S. and Global account number.

arrow icon

Move to Production
Customers moving to production will need a new set of credentials that will replace the test credentials currently in their application. Credentials include Meter Number, Authentication Key, and Password.

Note: FedEx account billing contact information is required to complete the production registration process.

Steps for Moving to Production

Remember to select only the type of web services you are implementing. If you have not coded to FedEx Web Services for Office and Print, then do not select that check box.

application profile screen

Consultants must provide information about the company they work for.

After completing the process, you will receive a confirmation email. If you are working as a consultant, both you and your customer will get the email.

Note: Due to the sensitivity of this information, the production authentication key is not provided in the confirmation email. Please retain this information for your records.

Learn how to change the WSDL endpoint to point to the FedEx production environment from the FedEx test environment:

FedEx Web Services Customers Using WSDLs:

  • Open the <service name>.WSDL and scroll down to the end of the WSDL.
  • Remove the word “beta” from the attribute value of the “address location” element.
  • Replace your test credentials (Authentication Key, Password, Account, and Meter Number) with your production credentials.
  • Sign up for Web Services Alerts and Outage Notifications.


FedEx Web Services Customers Using XSDs:

  • Remove the word “beta” from the URL contained within your HTTPS post operation.
  • Replace your test credentials (Authentication Key, Password, Account, and Meter Number) with your production credentials.
  • Sign up for Web Services Alerts and Outage Notifications.


Examples

Test Environment

<service name="RateService">
<port name="RateServicePort" binding="ns:RateServiceSoapBinding">
<s1:address location="https://wsbeta.fedex.com:443/web-services/rate"/>
</port>
</service>

Note: The test server URL is https://wsbeta.fedex.com:443/web-services.

Production Environment

<service name="RateService">
<port name="RateServicePort" binding="ns:RateServiceSoapBinding">
<s1:address location="https://ws.fedex.com:443/web-services/rate"/>
</port>
</service>

Note: The production server URL is https://ws.fedex.com:443/web-services.

XSD Customers

Test Environment: https://wsbeta.fedex.com:443/xml
Production Environment: https://ws.fedex.com:443/xml

The documents referenced above are provided in Adobe® Acrobat® Portable Document Format (PDF). To read these files, download Adobe Reader® here.

When shipping with FedEx Freight LTL using Web Services, you will need a FedEx Express account as well as a FedEx Freight account within your application. Test accounts are provided for both operating companies when you register for test credentials. If you do not have a FedEx Freight account established for production, please call 1.866.393.4585.

The FedEx Testing Environment does incur unexpected downtime throughout the year, and may see extended downtime during our twice-a-year corporate loads in January and June.

Other Resources

news icon

FedEx Web Services Announcements

View product updates and other announcements.

See Announcements
question mark icon

FedEx Web Services FAQs

Find answers to commonly asked questions.

See FAQs