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.

Get Test Key
Get Production Key

Welcome to FedEx Web Services

Note: The FedEx Web Services (SOAP) is now in development containment. All new integrations can be completed using RESTFul APIs available at the FedEx Developer Portal.

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.

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.

Get Your Test Key

Please note:

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.

Test Environment Mock Tracking Numbers

Tracking Numbers for FedEx Express and FedEx Ground

Scan Event	Tracking Number	Track By Reference Info.	Shipment Account Number	Ship Date	Destination Postal Code
Shipment information sent to FedEx	449044304137821	Customer Reference: 115380173 Ground Shipment ID: DMWsGWdnN	510088000	2018-08-15	33126
Tendered	149331877648230	Ground Shipment ID: 149331877648230	510088000	2018-08-15	28752
Picked up	020207021381215	Ground Shipment ID: 53089528	510088000	2018-08-15	30549
Arrived at FedEx location	403934084723025	Ground Shipment ID: 403934084723025 Department: 31826722	510088000	2018-08-15	99206
At local FedEx facility	920241085725456	Customer Reference: 0014243047/34684523 Ground Shipment ID: 920241085725456	510088000	2018-08-15	19720
At destination sort facility	568838414941	Shipper Reference: P218101_004154359 Purchase Order: P218101_004154359	510088000	2018-08-15	85388
Departed FedEx location	039813852990618	Customer Reference: 4631962 Ground Shipment ID: THE HOUSE Department: McGee Purchase Order: 3385158	510088000	2018-08-15	24740
On FedEx vehicle for delivery	231300687629630	Customer Reference: W62283340102 Ground Shipment ID: 231300687629630 Purchase Order: 6228334	510088000	2018-08-15	33126
International shipment release	797806677146	N/A
Customer not available or business closed (Delivery Exception 007)	377101283611590	Ground Shipment ID: 377101283611590	510088000	2018-08-15	95815
Local delivery restriction (Delivery Exception 083)	852426136339225	Customer Reference: 118402713013	510088000	2018-08-15	11375
Incorrect address (Delivery Exception 03)	797615467620	Shipper Reference: OTHER-TK104	510088000	2018-08-15	70810
Unable to deliver (Shipment Exception 099)	957794015041323	N/A
Returned to sender/shipper	076288115212522	Invoice: 81909	510088000	2018-08-15	50323
Clearance delay (International)	581190049992	N/A
Delivered	122816215025810	Customer Reference: PO#174724	510088000	2018-08-15	24273
Hold at location	843119172384577	N/A
Shipment canceled	070358180009382	Customer Reference: 15241402 Ground Shipment ID: 070358180009382	510088000	2018-08-15	94545
Duplicate tracking number	713062653486	Unique Identifier 1: 2457821000~713062653486~FX Unique Identifier 2: 2457835000~713062653486~FX

Tracking Numbers for FedEx SmartPost®

Scan Event	Tracking Number	Track By Reference Info.	Shipment Account Number	Ship Date	Destination Postal Code
Shipment information sent to FedEx	449044304137821	Customer Reference: MLB 359926432 Invoice: 2860784 Purchase Order: 11716439 [4133589]	510088000	2018-08-15	80010
In transit	61292701078443410536	Customer Reference: MLB 359926432 Invoice: 2860740 Purchase Order: 11716414 [4130861]	510088000	2018-08-15	02919
Out for delivery	61292700726653585070	Customer Reference: PIRSQUARED	510088000	2018-08-15	53051
Delivered	02394653018047202719	Customer Reference: ASQBSQEQCSQ	510088000	2018-08-15	31757

Tracking Numbers for Freight LTL

Scan Event	Tracking Number	Track By Reference Info.	Shipment Account Number	Ship Date	Destination Postal Code
Picked up	2873008051	Purchase Order: 812147	510088000	2018-08-15	98903
In transit	1960003216	Bill of Lading: 598MAC031715MWD	510088000	2018-08-15	73801
Weather delay (Shipment Exception)	1208673524	Bill of Lading: Q858600 Purchase Order: 119494	510088000	2018-08-15	67846
Delivered	1636374036	Purchase Order: CIRCTWOPIR	510088000	2018-08-15	65560

Welcome to FedEx Web Services

Note: The FedEx Web Services (SOAP) is now in development containment. All new integrations can be completed using RESTFul APIs available at the FedEx Developer Portal. Customers moving to Production will need a new set of credentials to replace the existing TEST credentials. Click the “Get Production Key” below.

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.

Get Production Key

Steps for Moving to Production

1. Complete application profile.

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.

2. Sign license agreement.

View the End User License Agreement (EULA)

View the Developer Resource Center License Agreement for Consultants Only

3. Enter contact information.

4. Provide developer information.

Consultants must provide information about the company they work for.

5. Receive confirmation.

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.

6. Replace URL and credentials.

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

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

Production Environment

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

Please note:

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

FedEx Web Services Announcements

View product updates and other announcements.

See announcements

Stay Informed

Get the latest news and alerts from the FedEx Developer Resource Center.