Track API
Introduction
Tracking number is unique number assigned to each package, which allows you to monitor the movement of a package between countries or even inside a country. FedEx Tracking options provide you with accurate and timely tracking information for FedEx Express®, FedEx Ground®, FedEx Home Delivery®, FedEx Freight® and FedEx Ground® Economy (Formerly known as FedEx SmartPost®) shipments .
Track API Details
FedEx Tracking helps you to get an insight into the location of the shipments.With the availability of tracking notifications, you can request various types of notifications about your shipments on your email and on your mobile on the go.
You can also track the status of shipments by using a reference number, such as a purchase order (PO) number, customer reference, invoice, Bill of Lading (BOL), part number, or Transportation Control Number (TCN). Tracking by something other than a tracking number also requires inclusion of Sender's account number and should contain secure tracking content.
Take advantage of detailed shipment–status updates, search capabilities and other tools that help you manage your shipments.
- Track the status of up to 30 FedEx Express, FedEx Ground, FedEx Home Delivery, FedEx Freight, FedEx Ground® Economy and FedEx Office shipments/orders tracking numbers.
- Send requests for notifications and receive the status of your shipments/orders on email.
- Review status updates in a calendar or list view to help you plan more effectively.
- Filter by reference number, shipment date, company name and other variables.
- View print or email FedEx Signature Proof of Delivery letters. Even if no signature is available, you can still view/print, email and fax the available proof of delivery information. Fax option is not available for multiple Signature proof of delivery requests.
- Request that an eligible package be held for pickup at a FedEx location (U.S. only).
- Track Package delivery schedule. i.e., on schedule or expected to deliver early or any delays with details
FedEx Tracking Methods
To help you ship with confidence, FedEx provides you with various ways to track the approximate location of your shipments.
Following are the tracking methods:
Track by Tracking Numbers
This option applies to FedEx Express, FedEx Ground shipments and FedEx Ground® Economy (Formerly known as FedEx SmartPost®) shipments. You can track any package shipped by FedEx using this tracking method.
You can enter any combination of up to 30 FedEx Express, FedEx Ground, FedEx Home Delivery, FedEx Ground® Economy, or FedEx Custom Critical® tracking numbers. Please ensure that you enter only one tracking number per line.
Note: FedEx Ground® service is available in the U.S. and Canada only. FedEx Home Delivery, FedEx Ground® Economy and FedEx Custom Critical services are available in the U.S. only.
Track by Door Tag Number
This option is available for FedEx Express and FedEx Ground U.S. and Canadian shipments. This option allows you to track the status of shipments by a FedEx door tag number. A Door Tag is left at the recipient address, if the recipient is not there to receive the package. A Door Tag number is linked at FedEx with the package’s original tracking number.
This tracking functionality allows you to track using only the door tag number without requiring the associated tracking number. No additional search elements are required to track by door tag. You may request tracking scan information for any packages shipped by FedEx by entering a valid door tag number.
Door tag numbers start with the letter’s 'DT' followed by 12 numbers. You can enter more than one door tag number in the request to get more details. You can enter any combination of up to 30 door tag tracking numbers at a time ensuring one door tag per line.
Track by FedEx Office Order Number
You can enter a combination of up to 30 FedEx Office order numbers at a time. You need to ensure that you enter only one FedEx Office order number per line. Hyphen and spaces between office order numbers are not allowed.
Note: FedEx Office orders are available in the U.S. only.Tracking by something other than tracking number is referred to as tracking by reference. A reference number can be any of the following: purchase order (PO) number, customer reference, invoice, Bill of Lading (BOL), or part number. This option applies to FedEx Express, FedEx Ground, and FedEx Ground® Economy.
Note: Door tags are available in the U.S. and Canada only.
Track by Reference
Tracking by something other than tracking number is referred to as tracking by reference. A reference number can be any of the following: purchase order (PO) number, customer reference, invoice, Bill of Lading (BOL), part number. This option applies to FedEx Express, FedEx Freight, FedEx Ground, and FedEx Ground® Economy.
Track by Transportation Control Number(TCN)
Track your Government orders by simply entering the Transportation Control Number (TCN).
Note: Do not precede the number with any spaces or with the letters 'TCN.'
Request Signature Proof of Delivery (SPOD)
Use Signature Proof of Delivery option to obtain an image of the recipient's signature (if the signature is available) after the shipment has been delivered. SPOD is available for FedEx Express and FedEx Ground shipments up to 16 months from the ship date. This includes the signature image and associated shipment data. The signature image and additional recipient information may not be available for display in all countries and is indicated on the SPOD where applicable.
The SPOD information will be presented as a byte array instead of an image. The byte array is a base64 encoded string, which should be decoded to get the final signature image in PDF or PNG format.
Track by Multiple–Piece Shipment (MPS) Tracking Number
This option is available for FedEx Express U.S. and international multiple–piece shipments (MPS), FedEx Ground U.S. and international multiple–piece shipments, FedEx Express International C.O.D. multiple–piece shipments, FedEx Freight, and FedEx International C.O.D. multiple–piece shipments.
MPS tracking allows you to track by the master tracking number or by one of the associated sequential tracking numbers of child packages.
- Tracking by master tracking number returns the tracking data of all the associated child tracking numbers.
- Tracking by the child tracking number returns details specific to package associated with it.
To track MPS packages, use the Master Tracking Number and use the Package Identifier Type value as STANDARD_MPS.
How Track API Works
The Track API provides the following options to actively track your shipments:
Track by Tracking Numbers
You can use this option to track packages based on a tracking number or Door Tag Number or FedEx Office Order Number for various shipping services.
The key input information associated with this request are as:
- Tracking Number (Maximum 30 tracking numbers are allowed)
- Detailed Scans to be included (True/False)
Result of this request will provide the tracking results for all the input tracking numbers along with key information such as latest status, last updated destination/location, distance to destination, any special handling details, scan events and return information in case of a return shipment.
Track by References
You can use this option to track packages based on alternate references other than tracking number such as customer reference numbers, etc.
The key input information associated with this request are as:
- Reference Type and Values (BILL OF LADING, CUSTOMER_REFERENCE, INVOICE, PURCHASE_ORDER)
- FedEx Account Number
- Detailed Scans to be included (True/False)
Result of this request will provide the tracking results for all the input reference numbers along with key information such as detailed tracking entry information, latest status, last updated destination/location, distance to destination, any special handling details, scan events and return information in case of a return shipment.
Track by Transportation Control Number
You can use this option to track packages based on Tracking Control Number.
The key input information associated with this request are as:
- Transportation Control Number (N552428361Y555XXX) – Only 1 TCN is supported per request.
- Detailed scans to be included (True/False)
Result of this request will provide the tracking results for the input Tracking Control Number along with key information such as detailed tracking entry information, latest status, last updated destination/location, distance to destination, any special handling details, scan events and return information in case of a return shipment.
Track Multiple-Piece Shipment (MPS)
You can use this option to track multiple piece shipments, Group MPS, or an outbound shipment which is linked to a return shipment.
The key input information associated with this request are as:
- Master Tracking number
- Associated shipment type – MPS, Group MPS, or an outbound shipment which is linked to a return shipment (Example: STANDARD_MPS)
- Detailed scans to be included (True/False)
Result of this request will provide the tracking results for the input master tracking Number along with key information such as detailed tracking entry information, latest status, last updated destination/location, distance to destination, any special handling details, scan events and return information in case of a return shipment.
Track Document
You can use this option to request any one of the below documents:
- Signature Proof of Delivery (SPOD)
- Bill of Lading (BOL)
- Freight Billing Document (FBD)
The key input information associated with this request are as:
- Document Type (SIGNATURE_PROOF_OF_DELIVERY, BILL_OF_LADING or FREIGHT_BILLING_DOCUMENT)
- Tracking number
- Document Format (PDF/PNG)
If SPOD is selected as the document type, then you will receive the image of the recipient's signature (if the signature is available) once the shipment has been delivered.
If Bill of Lading is selected as the document type, then you will receive a document that will contain the details of your shipment, and the legal contracts of carriage with terms and conditions.
If Freight Billing document is selected as the document type, then you will receive the shipment invoice.
Send Notifications
You can use this option to setup up and customize the tracking event notifications to be received for a shipment.
Use Notification to have FedEx automatically notify you and/or your customer and/or another third party by email of significant shipment events, such as clearance delays, delivery attempts, releases, and pre–alerts.
FedEx offers email notification for the shipment being created, for estimated delivery, Tendered, for any Exception and delivery.
Recipient emails may be specified with the shipment request and use any or all of these notification types if you want an email notification sent to the recipients. This notification is supported for FedEx Express, FedEx Freight, FedEx Ground, and FedEx Ground® Economy. FedEx also offers a new email notification for Estimated Delivery which triggers an email on the delivery date.
The key input information associated with this request are as:
- Sender Name
- Notification events (ON_DELIVERY, ON_ESTIMATED_DELIVERY, ON_EXCEPTION, ON_TENDER.)
- Tracking number
The successful result of this request will set the notifications on the given events and will be sent to the given email address as and when the event occurs.
Track Summary Results
When tracking multiple shipments at once, the summary results screen shows date/time, status, destination for FedEx shipments, and/or order number, order status, date/time for FedEx Office orders.
To get tracking detail results for your shipment, send in the tracking request with the tracking number and/or FedEx order number.
You can also get email Signature Proof of Delivery letters for all delivered FedEx Express, and FedEx Ground shipments you select. Please note Signature Proof of Delivery is not available for FedEx Ground® Economy shipments.
Tracking Delivery Schedule (On Schedule/Delayed)
You can get real time single/MPS shipment delivery schedule estimates such as delay in delivery, on time and early delivery. This is applicable when you track your package by Tracking number, by reference or tracking control number (TCN).
If a package delivery is on schedule or expected to be delivered early, then the tracking response element trackResults\scanEvents\delayDetail\status will have value as ON_TIME and EARLY respectively.
If your packages are delayed due to any reason, the tracking response will provide you the required delay details (if any) with reason. In this case, the tracking response element trackResults\scanEvents\delayDetail\status will have value as DELAYED along with delay category (type) such due to WEATHER and additional delay category (subType) such as due to SNOW.
FedEx Estimated Delivery Time Window (EDTW)
The FedEx Estimated Delivery Time Window (EDTW) helps recipients plan their schedules by providing a time range for shipment deliveries based on historical data of shipments delivered in the location requested by the customer.
Note: The estimated delivery time may vary based certain delivery locations.
EDTWs are available for the following regions and operating companies:
- Regions: Packages destined to following countries:
- U.S.
- Canada
- Belgium
- Germany
- Netherlands
- Operating Companies: The following are the services which provide EDTW feature:
- FedEx Express
- FedEx Ground
- FedEx Home Delivery (FHD) services
Note: The EDTW details are not returned for all the tracking numbers due to various reasons and package handlings such as Request Appointment, Date Certain, or Evening delivery for FHD shipments or changing delivery to FedEx Hold at Location (HAL) for pickup at the nearest FedEx Authorized Ship Centers (FASCs), FedEx-staffed Ship Centers (Express only packages), FedEx Office, and FedEx OnSite locations. Contact your FedEx representative for more information.
EDTW Technical details:
No specific inputs to be included in the track requests as most tracking numbers will return EDTW information based on the shipment events.
The below information in the Track output/response can be used for getting EDTW:
You should use below EDTW elements in object estimatedDeliveryTimeWindow returned in the Track response under output/completeTrackResults/trackResults:
· window/begins – EDTW begin date/timestamp range. Example: '2019-05-07T08:00:07'
· window/ends – EDTW end date/timestamp range. Example: '2019-05-15T15:00:07'
EDTW Benefits:
The following are the advantages of EDTW:
- Incorporation of EDTW reduces the time spent on shipment delay resolution.
- No more wait time on calls to inquire about package delivery times.
- Reduced risk of package damage and narrowed scope of any possible theft.
Signature Proof of Delivery
After your shipment is successfully delivered and if signature is obtained, the signature will be returned with the shipment (depends on signature availability) when requested through secured tracking. This is only applicable for FedEx Express and FedEx Ground shipments.
To confirm a shipment that has been received and signed for, you can also use our signature proof of delivery option to obtain this letter online, print it out, email or fax it.
Below are some helpful tips:
- The difference between tracking and Signature Proof of Delivery:
You can use tracking to check the status of your shipment at any time during and within 90 days after delivery. You can use signature proof of delivery to get a picture of the recipient's signature (if the signature is available) once the shipment has been delivered.
- Signature Proof of Delivery data availability:
Signature Proof of Delivery is available for up to 16 months for FedEx Express and FedEx Ground shipments. This includes the signature image and associated shipment information. The signature image and additional recipient information may not be available for display in all countries. This will be indicated on the Signature Proof of Delivery where applicable.
- Multiple Signature Proof of Delivery Requests
You can request up to 30 Signature Proof of Delivery letters at once.
- Signature Proof of Delivery letters with multiple requests may take up to several minutes to process.
- Please note – the fax option is not available for multiple Signature Proof of Delivery requests.
- Signature Proof of Delivery letters will be provided for delivered shipments only. SPOD for shipments currently in–transit will not be provided until they are delivered.
Signature Types
The following are the signature types and features supported by FedEx shipments:
- Indirect Signature Required
FedEx obtains a signature from someone at the delivery address; from a neighbor, building manager or someone at a neighboring address; or the recipient can also leave a FedEx Door Tag authorizing release of the package without anyone present. This option is available for residential deliveries only.
- Direct Signature Required
FedEx obtains a signature from someone at the delivery address. If no one is at the address, the delivery is reattempted.
- Adult Signature Required
FedEx obtains a signature from someone at least 21 years old (and possessing the required government–issued photo ID) at the delivery address. If no eligible is at the address, the delivery is reattempted.
- No Signature Required
Even if no signature is available, you can still view/print, email and fax the available proof of delivery information. If no signature is available after seven business days, please call Customer Service. Please note that the signature may be unavailable if it was released (the sender or recipient signed a signature release agreement).
- Summary Signature Proof of Delivery
You can obtain a Signature Proof of Delivery letter with summary information without providing the 9–digit FedEx shipper or payer account number. This letter contains limited shipment information such as the city, state/province, and country information for the shipper and recipient. The signature image may not be available for display in all countries. This will be indicated on the signature proof of delivery letter where applicable.
- Signature Proof of Delivery details
You can obtain a Signature Proof of Delivery letter with detailed information by providing the 9–digit FedEx account number or logging into fedex.com. If the account number or your login matches the shipper or payer of the shipment, you will be able to view detailed Signature Proof of Delivery information, which includes complete contact name, company name, street address, city, state/province, ZIP, and country information for both the shipper and recipient (if available).
Note: The signature image and additional recipient information may not be available for display in all countries. This will be indicated on the Signature proof of delivery letter where applicable. - Addressee
You can add addressee information for the Proof of Delivery letter.
- Your Shipment Notes
Add personal notes specific to a tracking number to remind you of important details of your shipment. These notes are visible only to you and can be used when performing a search within FedEx Tracking.
Track by Reference
You can track packages by a reference number entered during the shipping operation.
This option applies to FedEx Express, FedEx Freight and FedEx Ground shipments. You can track packages by a reference number entered during the shipping operation.
Track by Reference Number can use any of the following sources –
- Shipper/Customer Reference
Note: With a FedEx Express, FedEx Freight and FedEx Ground shipment, the customer's reference number is coded as a Shipper Reference and Customer Reference. - Invoice Number
- PO
- Department (not available for FedEx Ground® Economy)
- Part Number (not available for FedEx Ground® Economy)
- Returns Material Authorization (RMA) (not available for FedEx Freight®)
- TCN (not available for FedEx Freight and FedEx Ground® Economy)
- BOL (not available for FedEx Ground® Economy)
Note:
- If you enter a tracking number as part of this request, the tracking number always takes precedence over the Reference element. Therefore, if you enter a tracking number for a shipment that does not include the Reference data you requested, the tracking number is returned with no error message. To limit the number of tracking replies for a specific reference, you can enter a date range for this search.
- The Shipment Account Number is not required but makes tracking by reference much easier. If Shipment Account Number is not specified, then the Destination Postal Code & Country Code, and the ship date range (Begin date & End date), must be specified.
Reference with an Account Number
You can track using reference account number. The minimum information for this request are reference value, account number, Ship date begin and end date. All shipments associated with the account number and reference(s) will be displayed.
Reference without an Account Number
You can track using without referencing account number. The minimum information for this request are reference value, destinationPostalCode, destinationCountryCode, Ship date begin and end date. Please enter ship date (+/– 15 days), destination country, and destination postal code. Not all countries support postal codes. Please select destination country first to determine the postal code requirement.
Note: Only unique matches will be displayed when tracking by reference without an account number. If multiple results are found for the same reference number, you must select a FedEx service before clicking Resubmit all. If a unique match cannot be found, you will be prompted to enter the account number.
Track Associated Shipments
FedEx provides you convenient multiple–piece shipment status tracking information. Each shipment in a multiple–piece shipment is linked as associated shipments (track the status of one shipment and have access to information for all associated multiple–piece shipments).
Master Tracking Number: The first tracking number in a multiple–piece shipment that associates all tracking numbers in the shipment.
Batch Tracking
The Batch Tracking service enables you to send multiple tracking numbers to track the shipments. The batch additional information on batch tracking is required for request and reply elements.
For example, within a request, it is possible to have multiple occurrences of the Request Selection Details element for batch tracking. The maximum number of packages within a single–track transaction is limited to 30.
Each level of Notifications within the new tracking response is as shown below
- The Reply’s Notifications element provides the Overall Transaction Status
- The Reply’s Completed Tracking Details>>Notifications element provides Individual Track Request Status
- The Reply’s Completed Tracking Details>>Tracking Details>>Notification = Specific Tracking Number Status
Note:
- If there is a failure or error notification at the method level, (Reply>>Notifications) then Ignore the remaining response/payload.
- If there is a failure or error notification at the individual reply notification level, then Ignore the remaining response/payload.
International Package Tracking/Tracing
Tracking of international packages is available upon request. You can also track the status of shipments by using a reference number, such as a purchase order (PO) number, customer reference, invoice, Bill of Lading (BOL), part number, or Transportation Control Number (TCN).It uses elements such as carrier code, geographic coordinates, operating company, package identifier, and so on for tracking a package.
You can track international package tracking using the following methods:
- Track by Tracking Number provides customers Package tracking information based on a tracking number for various shipping services.
- Track by Tracking Control Number returns tracking information based on a Tracking Control Number. Opcos: FedEx Cargo, Custom Critical, Express, and Ground Shipment.
- Track by Multiple–Piece Shipment (MPS) Tracking Number allows you to track by the master tracking number or by one of the associated sequential tracking numbers for child packages. To track MPS packages, use the Master Tracking Number and use the PackageIdentifier /Type value of STANDARD_MPS.
- Track by References returns tracking information based on alternate references other than Tracking Number such as Customer reference numbers, etc. Either shipper.AccountNumber or Destination.countryCode (and postal for postal aware countries) are required.
- Track by Document to request any one of the document: Signature Proof of Delivery, Bill of Lading, or Freight Billing Document.
- Track by Tracking number provides customers Package tracking information based on a tracking number for various shipping services.
- Track by Door Tag Number allows you to track the status of shipments by a FedEx Door Tag number. A Door Tag is left at the recipient’s shipping address if the recipient is not there to receive the package. This option is available for FedEx Express and FedEx Ground U.S. and Canadian shipments.
Note:
- Tracking by something other than tracking number requires inclusion of Sender's account number and it must contain secure tracking content.
- FedEx Express shipments support intra–Mexico shipping for Signature Proof of Delivery (SPOD).
- FedEx Express and FedEx Ground Signature Proof of Delivery (SPOD) are available for 16 months after the ship date.
To trace your package, you must have all of the following information when you call FedEx Customer Service.
- Air waybill number
- Date of shipment
- Recipient’s name and address
- Number of packages and total weight of shipment
- Contents and value of shipment
- Your name and phone number
Request Notifications
FedEx provides you convenient email notifications (Plain Text or HTML) that you can use to notify up to 4 email recipients. You can also add a personal message per your preference (not available for non–English characters). Notification types include:
- Send me the current status – Notify the current tracking detailed results.
- FedEx has received the package – Notify when a shipment has been taken into FedEx possession.
- A delivery exception has occurred – Notify when a clearance delay or a delivery exception (unexpected events that could possibly interrupt package movement or delivery) occurs. If a clearance delay occurs and once the international shipment is released from clearance process, another notification will be sent automatically.
- Estimated delivery updates – Send reminder the day before scheduled delivery and on the day of delivery. Also notify when FedEx updates the scheduled delivery date and/or time.
- Delivery has been made – Notify when a shipment has been delivered.
Business Rules
- Limit the number of tracking numbers in a single–track request to 30. This will decrease the size of the reply and reduce the transaction response time.
- Limit the number of times a package/order is tracked to what is necessary for business needs.
- For batch tracking, remove any packages/orders that have returned a track status of “delivered” from the batch.
- The most common cause for non–availability of tracking records is incorrect tracking/order number provided as input. It is advised to check with the sender if you are not sure about the tracking/order number. Besides, it takes up to 24 hours for a new package/order to show up in the system.
- Tracking information is available for 90 days after delivery for FedEx Express, FedEx Ground, and FedEx Custom Critical.
- Account number or destination postal code or country detail is mandatory to use track by reference.
- You will get the Estimated Delivery Date (EDD) only after the package is tendered to FedEx.
JSON API Collection
Response