Track API

簡介

追蹤號碼是每件包裹編配的獨有號碼，讓您掌握在不同國家/地區之間，甚至是同一個國家/地區內的包裹運輸狀況。FedEx 查詢選項可為您提供 FedEx Express^®、FedEx Ground^®、FedEx Home Delivery^®、FedEx Freight^® 及 FedEx Ground^® Economy (先前稱為 FedEx SmartPost^®) 貨件精準且即時的追蹤資訊。

追蹤應用程式開發介面 (API) 詳細資料

FedEx 貨件查詢可協助您取得貨件位置的相關詳細資訊。有了追蹤通知，您就能要求以電子郵件和行動裝置隨時取得各類型的貨件通知。

您也可以使用參考號碼追蹤貨件狀態，例如採購訂單 (PO) 編號、顧客參考號碼、發票、提單 (BOL)、零件編號或通航管制編號 (TCN)。若要以追蹤號碼以外的方式追蹤，也須包含寄件人帳號和安全追蹤內容。

利用貨件詳細資料：狀態更新、搜尋功能和其他有助於您管理貨件的工具。

查詢 FedEx Express、FedEx Ground、FedEx Home Delivery、FedEx Freight、FedEx Ground^® Economy 及 FedEx 服務站最多 30 筆貨件/訂單追蹤號碼的狀態。
傳送通知要求，並透過電子郵件接收貨件/訂單狀態通知。
在行事曆或清單視圖中檢視狀態更新，幫助您更有效地規劃。
以參考號碼、託運日期、公司名稱及其他變數來篩選。
檢視/列印或以電子郵件傳送 FedEx 簽收證明書。即使沒有提供簽名，您仍可以檢視/列印、以電子郵件和傳真形式傳送可用的交貨證明資訊。多個簽收證明請求無法使用傳真選項。
要求於 FedEx 服務站保留符合資格的包裹以待領取 (僅限美國)。
追蹤包裹遞送時程，也就是說，準時送達或預計提早送達，或是任何含有詳細資料的延誤狀況

FedEx 追蹤方式

為協助您安心運送，FedEx 為您提供多種可追蹤貨件大約位置的方式。

下方列出可用的追蹤方式：

依追蹤號碼追蹤

此選項適用於 FedEx Express、FedEx Ground 貨件及 FedEx Ground^® Economy (先前稱為 FedEx SmartPost^®) 貨件。您可以使用此查詢方式來追蹤任何交由 FedEx 託運的包裹。

您最多可以輸入 30 組 FedEx Express、FedEx Ground、FedEx Home Delivery、FedEx Ground^® Economy 或 FedEx Custom Critical^® 追蹤號碼。請確保每行僅輸入一組追蹤號碼。

注意︰FedEx Ground^® 服務僅適用於美國和加拿大。FedEx Home Delivery、FedEx Ground^® Economy 及 FedEx Custom Critical 服務僅適用於美國。

依快遞通知單號碼追蹤

此選項適用於 FedEx Express 及 FedEx Ground 美國和加拿大的貨件。此選項讓您能夠以 FedEx 快遞通知單號碼追蹤貨件狀態。若收件人未於指定地址收取包裹，將會於該地址留下一張快遞通知單。快遞通知單號碼會在 FedEx 系統中與包裹的原始追蹤號碼連結。

這項追蹤功能讓您僅使用快遞通知單號碼即可追蹤，無需使用關聯的追蹤號碼。若使用快遞通知單追蹤，即無需再使用其他搜尋條件。您可以輸入有效的快遞通知單號碼，以索取任何 FedEx 遞送包裹的追蹤掃描資訊。

快遞通知單號碼以字母「DT」開頭，後接 12 個數字。您可以在請求中輸入多組快遞通知單號碼，以取得更多詳細資料。您可以輸入任意組數的快遞通知單追蹤號碼，一次最多可輸入 30 組，每行輸入一組快遞通知單號碼。

依 FedEx Office 訂單號碼查詢

您一次最多可輸入 30 組 FedEx 服務站訂單號碼。每行僅能輸入一組 FedEx 服務站訂單號碼。請勿在服務站訂單號碼之間加入連字號及空白。

注意：FedEx 服務站訂單僅適用於美國。使用追蹤號碼以外的方式來查詢，即稱為依參考資料查詢。可能的參考號碼如下：採購訂單 (PO) 編號、顧客參考編號、發票/請款單、提單 (BOL) 或零件編號。此選項適用於 FedEx Express、FedEx Ground 及 FedEx Ground^® Economy。

注意︰快遞通知單僅適用於美國和加拿大。

依參考資料查詢

使用查詢號碼以外的方式來查詢，即稱為依參考資料查詢。可能的參考號碼如下：採購訂單 (PO) 編號、顧客參考編號、發票、提單 (BOL)、零件編號。此選項適用於 FedEx Express、FedEx Freight、FedEx Ground 及 FedEx Ground^® Economy。

依通航管制編號 (TCN) 追蹤

只需輸入通航管制編號 (TCN)，即可追蹤您的政府訂單。

注意：請勿在此編號前輸入任何空格或字母「TCN」。

請求簽收證明 (SPOD)

可在貨件送達後使用簽收證明選項取得收件人簽名的影像 (若有簽名)。簽收證明 (SPOD) 適用於自托運日期起 16 個月內的 FedEx Express 及 FedEx Ground 貨件。其中包括簽名影像以及關聯的貨件資料。並非所有國家/地區都會顯示簽名影像及其他收件人資訊，簽收證明 (SPOD) 會根據提供情況來加以說明。

簽收證明 (SPOD) 資訊將會以位元組陣列呈現，而非影像。位元組陣列為 base64 編碼字串，應經過解碼以取得 PDF 或 PNG 格式的最終簽名圖像檔。

依多包裹貨件 (MPS) 追蹤號碼來追蹤

此選項適用於 FedEx Express (美國) 和國際多件包裹貨件 (MPS)、FedEx Ground (美國) 和國際多件包裹貨件、FedEx Express 國際貨到收款 (C.O.D.) 多包裹貨件、FedEx Freight 及 FedEx 國際貨到收款 (C.O.D.) 多包裹貨件。

多件包裹貨件 (MPS) 追蹤讓您能夠以主貨件追蹤號碼，或以相關的其中一組子貨件追蹤序號來追蹤貨件狀況。

若以主貨件追蹤號碼追蹤，搜尋所有相關子貨件追蹤號碼的追蹤資料。
若以子貨件追蹤號碼追蹤，搜尋與該號碼相關包裹的詳細資料。

若要追蹤多包裹貨件 (MPS) 包裹，請使用主追蹤號碼並以 STANDARD_MPS 作為包裹識別碼類型值。

追蹤應用程式開發介面 (API) 的運作方式

追蹤應用程式開發介面 (API) 提供以下選項，用於主動追蹤您的貨件：

依追蹤號碼追蹤

您可以使用此選項，依各種託運服務的追蹤號碼、快遞通知單號碼或 FedEx Office 訂單號碼來追蹤包裹。

與此請求關聯的關鍵輸入資訊如下：

追蹤號碼 (最多可輸入 30 組追蹤號碼)
要包含的詳細掃描資訊 (True/False)

此請求結果會提供所有輸入追蹤號碼的追蹤結果並附上關鍵資訊，例如最新狀態、上次更新目的地/地點、目的地距離、任何特別處理詳細資料、掃描事件和回件資訊 (若有回件貨件)。

依參考資料追蹤

您可以使用此選項，依追蹤號碼之外的替代參考資料來追蹤包裹，如顧客參考號碼等。

與此請求關聯的關鍵輸入資訊如下：

參考類型和值 (提單、顧客參考號碼、發票、採購訂單)
FedEx 帳號
要包含的詳細掃描資訊 (True/False)

此請求結果會提供所有輸入參考號碼的追蹤結果並附上關鍵資訊，如詳細追蹤輸入資訊、最新狀態、上次更新目的地/地點、目的地距離、任何特別處理詳細資料、掃描事件和回件資訊 (若有回件貨件)。

依通航管制編號追蹤

您可以使用此選項依追蹤控制號碼追蹤包裹。

與此請求關聯的關鍵輸入資訊如下：

通航管制編號 (N552428361Y555XXX)：每個請求僅支援一組 TCN。
要包含的詳細掃描資訊 (True/False)

此請求結果會提供所有輸入追蹤控制號碼的追蹤結果並附上關鍵資訊，如詳細追蹤輸入資訊、最新狀態、上次更新目的地/地點、目的地距離、任何特別處理詳細資料、掃描事件和回件資訊 (若有回件貨件)。

追蹤多包裹貨件 (MPS)

您可以使用此選項來追蹤多包裹貨件、群組多包裹貨件 (MPS) 或是與回件貨件關聯的出口貨件。

與此請求關聯的關鍵輸入資訊如下：

主追蹤號碼
相關貨件類型：多包裹貨件 (MPS)，或是與回件貨件關聯的出口貨件 (例如：STANDARD_MPS)。
要包含的詳細掃描資訊 (True/False)

此請求結果會提供所有輸入主追蹤號碼的追蹤結果並附上關鍵資訊，如詳細追蹤輸入資訊、最新狀態、上次更新目的地/地點、目的地距離、任何特別處理詳細資料、掃描事件和回件資訊 (若有回件貨件)。

追蹤文件

您可以使用此選項索取下列任一文件：

簽收證明 (SPOD)
提單 (BOL)
Freight 帳單文件 (FBD)

與此請求關聯的關鍵輸入資訊如下：

文件類型 (SIGNATURE_PROOF_OF_DELIVERY、BILL_OF_LADING 或 FREIGHT_BILLING_DOCUMENT)
查詢號碼
文件格式 (PDF/PNG)

若選取簽收證明 (SPOD) 為文件類型，您會在貨件送達時，收到收件人簽名的影像 (如有提供此簽名)。
若選取提單為文件類型，您會收到一份包含貨件詳細資料的文件，以及一份載明條款與細則的託運法律合約。
若選擇 Freight 帳單文件為文件類型，您會收到貨件發票。

傳送通知

您可以使用此選項來設定並自訂要收到的貨件追蹤事件通知。

使用通知讓 FedEx 在發生重大貨件事件時 (如清關延遲、遞送嘗試、放行、預先通知)，以電子郵件自動通知您、您的顧客和/或其他第三方。

FedEx 會為正在建立的貨件、預估送達日期、已送交、任何例外和遞送提供電子郵件通知。

如需傳送電子郵件通知給收件人，您可於貨件請求指定收件人電子郵件，並使用任意或所有的通知類型。此通知支援 FedEx Express、FedEx Freight、FedEx Ground 及 FedEx Ground^® Economy。FedEx 也會為預估送達日期提供新的電子郵件通知，於遞送當日寄送電子郵件。

與此請求關聯的關鍵輸入資訊如下：

寄件人姓名
電子郵件
通知事件 (ON_DELIVERY、ON_ESTIMATED_DELIVERY、ON_EXCEPTION、ON_TENDER)
查詢號碼

此請求成功產出結果後，系統將會針對指定事件設定通知，並於事件發生時傳送電子郵件至指定的電子郵件地址。

追蹤摘要結果

一次追蹤多筆貨件時，摘要結果畫面會顯示日期/時間、狀態、FedEx 貨件目的地，及/或訂單號碼、訂單狀態、FedEx 服務站訂單的日期/時間。

若要取得貨件的詳細追蹤結果，請以追蹤號碼和/或 FedEx 訂單號碼傳入追蹤請求。

您還可以取得選定之所有 FedEx Express 及 FedEx Ground 已送達貨件的簽收證明電子郵件。請注意：簽收證明不適用於 FedEx Ground^® Economy 貨件。

追蹤遞送時程 (準時/延誤)

您可以取得單件/多包裹貨件 (MPS) 的即時遞送時程預估，例如遞送延誤、準時和提早送達。以追蹤號碼、參考資料或追蹤控制號碼 (TCN) 追蹤您的包裹時，即可使用此功能。

如果您的包裹準時送達，或是預計會提早送達，追蹤回應元素 trackResults\scanEvents\delayDetail\status 的值則會分別顯示為「ON_TIME」和「EARLY」。

如果您的包裹因任何原因而延誤，追蹤回應會提供必要的延誤詳細資料 (若有) 及其原因。在此情況下，追蹤回應元素 trackResults\scanEvents\delayDetail\status 的值會顯示為「DELAYED」並會提供延誤類別 (類型)，例如因為「WEATHER」，以及其他延誤類別 (子類型)，例如因為「SNOW」。

FedEx 預估送達時間範圍 (EDTW)

FedEx 預估送達時間範圍 (EDTW) 可根據相關地點的貨件遞送歷史記錄，提供貨件的預計送達時間範圍，方便收件人規劃自己的時程。

注意：預估送達時間可能因指定遞送地點而異。

EDTW 適用於下列區域和營運公司：

區域：目的地為以下國家/地區的包裹：
- 美國
- 加拿大
- 比利時
- 德國
- 荷蘭
營運公司：以下為提供 EDTW 功能的服務：
- FedEx Express
- FedEx Ground
- FedEx Home Delivery (FHD) 服務

注意：由於各種原因和包裹處理項目，系統未傳回所有追蹤號碼的 EDTW 詳細資料，例如 FHD 貨件的預約請求、指定日期或晚間送達，或更改遞送至 FedEx 由服務站保管 (HAL)，以在最近的 FedEx 授權託運中心 (FASC)、FedEx 派員駐守的託運中心 (僅限 Express 包裹)、FedEx Office 及 FedEx OnSite 服務站取件。請聯絡您的 FedEx 業務代表以取得詳細資訊。

EDTW 技術詳細資料：

不需要在追蹤請求中包含任何特定輸入，因為大部分的追蹤號碼都會根據貨件事件傳回 EDTW 資訊。

追蹤輸出/回應中的下方資訊可用於取得 EDTW：

您應該在 output/completeTrackResults/trackResults 底下，於追蹤回應中傳回的物件 estimatedDeliveryTimeWindow 中使用下方 EDTW 元素：

· window/begins – EDTW 開始日期/時間戳記範圍。例如：「2019-05-07T08:00:07」

· window/ends – EDTW 結束日期/時間戳記範圍。例如：「2019-05-15T15:00:07」

EDTW 優點：

以下為 EDTW 的優點：

納入 EDTW 可縮短花費在解決貨件延遲情形的時間。
節省以通話查詢包裹送達時間時的等候時間。
降低包裹損壞風險並縮小任何可能的遭竊範圍。

簽收證明

貨件成功遞送並取得簽名後，只要透過安全追蹤提出請求，簽名將與貨件一同傳回 (視簽名可用狀態而定)。僅適用於 FedEx Express 和 FedEx Ground 貨件。

若要確認貨件是否已簽收，您也可以使用我們的簽收證明選項於線上取得此證明書，將其列印出來、以電子郵件傳送或傳真。

以下提供一些有用的秘訣︰

追蹤與簽收證明之間的區別︰
您可以在貨件遞送期間和遞送後 90 天內隨時使用追蹤功能查詢貨件狀態。您可在貨件送達後使用簽收證明取得收件人簽名影像 (若有簽名)。
簽收證明資料有效性︰
FedEx Express 與 FedEx Ground 貨件的簽收證明最多可保留 16 個月。其中包括簽名影像以及關聯的貨件資訊。並非所有國家/地區都會顯示簽名影像及其他收件人資訊。簽收證明中會根據情況來加以指明。
多個簽收證明請求
您一次最多可以請求 30 份簽名簽收證明書。
- 多項簽收證明書請求可能需要數分鐘的時間來處理。
- 請注意，傳真選項不適用於多項簽收證明請求。
- 簽收證明書僅會針對已送達的貨件自動顯示。目前運送中貨件的簽收證明 (SPOD) 將在送達後顯示。

簽名類型

以下是 FedEx 貨件支援的簽名類型及功能：

須間接簽名
FedEx 貨件的簽收人員可以是遞送地址的某個人、鄰居、物業管理人員或居住於附近的人；或者，收件人也可以留下 FedEx 快遞通知單標籤以授權 FedEx 直接發放包裹，需無需任何人簽收。此選項僅適用於住宅遞送。
須直接簽名
FedEx 貨件的簽收人必須是遞送地址的某個人。如果此地址無人，我們將重新嘗試遞送。
須成人簽名
FedEx 貨件的簽收人必須是遞送地址的某個年滿 21 歲 (且持有政府核發之照片識別證件) 的成人。如果該地址無符合條件的收件人，我們將重新嘗試遞送。
不須簽名
即使沒有提供簽名，您仍可以檢視/列印、以電子郵件和傳真形式傳送可用的交貨證明資訊。如果七個工作日後仍沒有簽名，請致電顧客服務部。請注意，如果簽名已放行 (寄件人或收件人簽署了簽名放行合約)，便可能不會再提供簽名。
簽收證明摘要
您無需提供 9 位數 FedEx 託運人或付款人帳號，即可取得包含摘要資訊的簽收證明書。此證明包含有限的貨件資訊，例如寄件人與收件人所在的城市、州/省及國家/地區資訊。並非所有國家/地區都會顯示簽名影像。簽收證明中會根據情況來加以指明。
簽收證明詳細資料
您可以透過提供 9 位數 FedEx Express 帳號或登入 fedex.com 來取得包含詳細資訊的簽收證明書。如果帳號或登入資料與貨件寄件人或付款人相符，您將可以檢視詳細的簽收證明資訊，包括寄件人與收件人的完整聯絡人姓名、公司名稱、街道地址、城市、州/省、郵遞區號及國家/地區資訊 (如果有)。
注意：並非所有國家/地區都會顯示簽名影像及其他收件人資訊。簽收證明中會根據情況來加以指明。
收件人
您可將收件人資訊新增至簽收證明書中。
您的貨件備註
新增某個追蹤號碼特定的個人備註，以提醒您貨件的重要詳細資料。只有您會看見這些備註，並可在 FedEx 貨件查詢執行搜尋時加以使用。

依參考資料查詢

您可於運送處理期間依輸入的參考號碼來追蹤包裹。

此選項適用於 FedEx Express、FedEx Freight 及 FedEx Ground 貨件。您可於運送處理期間依輸入的參考號碼來追蹤包裹。

依參考號碼追蹤可使用下列任一來源：

寄件人/顧客參考編號
注意：在 FedEx Express、FedEx Freight 和 FedEx Ground 貨件中，顧客的參考號碼會被編碼為寄件人參考編號和顧客參考編號。
請款單號碼
訂單
部門 (不適用於 FedEx Ground^® Economy)
零件編號 (不適用於 FedEx Ground^® Economy)
退貨授權 (RMA) (不適用於 FedEx Freight^®)
TCN (不適用於 FedEx Freight 及 FedEx Ground^® Economy)
提單 (不適用於 FedEx Ground^® Economy)

附註：

如果您在此請求中輸入追蹤號碼，則追蹤號碼一律會優先於「參考資料」元素。因此若您輸入不含您所要求參考資料的貨件追蹤號碼，則傳回追蹤號碼時不會出現錯誤訊息。若要限制特定參考資料的追蹤回覆數量，您可以為此搜尋輸入日期範圍。

貨件帳號並非必要，但可以讓您更容易依參考資料追蹤。若未指定貨件帳號，則必須指定目的地郵遞區號和國家/地區代碼，以及託運日期範圍 (開始日期與結束日期)。

以帳號作為參考資料

您可以使用參考帳號進行追蹤。此請求必須包含的資訊有參考值、帳號、託運開始和結束日期。會顯示所有與該帳號及參考資料關聯的貨件。

不搭配帳號使用參考資料

您無需使用帳號也可以進行追蹤。此請求必須包含的資訊有參考值、目的地郵遞區號、目的地國家/地區代碼、託運開始和結束日期。請輸入託運日期 (+/– 15 天)、目的地國家/地區、以及目的地郵遞區號。並非所有國家/地區都支援郵遞區號。請先選取目的地國家/地區以判定是否符合郵遞區號需求。

注意：若在不使用帳號的情況下以參考資料進行追蹤時，系統只會顯示唯一相符的資料。如果相同的參考編號找到多筆結果，您必須先選取一項 FedEx 服務，才能按一下「全部重新送出」。如果找不到唯一的相符結果，系統將提示您輸入帳號。

查詢關聯的貨件

FedEx 為您提供簡便的多包裹貨件狀態追蹤資訊。多包裹貨件中的每件貨件均會視為相關聯的貨件相互連結 (亦即追蹤單一貨件的狀態，即可取得多包裹貨件中所有相關聯貨件的資訊)。

主追蹤號碼：多包裹貨件中的第一筆追蹤號碼，與該貨件中所有的追蹤號碼關聯。

批次追蹤

批次追蹤服務讓您能夠傳送多組追蹤號碼以追蹤貨件。請求及回覆元素會需要批次追蹤的其他批次資訊。

例如，在請求中可能會出現批次追蹤的多次「請求選擇詳細資料」元素。單一追蹤交易的包裹數量上限為 30 件。

新追蹤回覆的各層級通知如下所示：

回覆的「通知」元素會提供整體交易狀態
回覆的「已完成追蹤詳細資料>>通知」元素會提供個別追蹤請求狀態
回覆的「已完成追蹤詳細資料>>追蹤詳細資料>>通知」= 特定追蹤號碼狀態

附註：

若在方式層級出現失敗或錯誤通知，(回覆>>通知) 則忽略剩餘的回應/裝載。

若在個別回覆通知層級出現失敗或錯誤通知，則會忽略剩餘的回應/裝載。

國際包裹追蹤/溯源

您可以提出追蹤國際包裹的請求。您也可以使用參考號碼追蹤貨件狀態，例如採購訂單 (PO) 編號、顧客參考號碼、發票、提單 (BOL)、零件編號或通航管制編號 (TCN)。追蹤包裹時會使用承運人代碼、地理座標、營運公司、包裹識別碼等。

您可以使用下列方式追蹤國際包裹：

依追蹤號碼追蹤，可依據各種託運服務的追蹤號碼為顧客提供包裹追蹤資訊。
依追蹤控制號碼追蹤，系統會依據追蹤控制號碼傳回追蹤資訊。Opco：FedEx Cargo、Custom Critical、Express 和 Ground 貨件。
依多包裹貨件 (MPS) 追蹤號碼追蹤，讓您能夠以主追蹤號碼來進行追蹤，或以相關的其中一組追蹤序號來追蹤子包裹。若要追蹤多包裹貨件 (MPS) 包裹，請使用主追蹤號碼並使用 STANDARD_MPS 的 PackageIdentifier /Type 值。
依參考資料追蹤，會依據追蹤號碼之外的替代參考資料傳回追蹤資訊，例如顧客參考號碼等。需要使用 shipper.AccountNumber 或 Destination.countryCode (若為使用郵遞區號的國家/地區，則需要郵遞區號)。
「依文件追蹤」可索取下列任一文件：簽收證明、提單或 Freight 帳單文件。
依追蹤號碼追蹤，可依據各種託運服務的追蹤號碼為顧客提供包裹追蹤資訊。
依快遞通知單號碼追蹤，讓您可以依 FedEx 快遞通知單號碼追蹤貨件狀態。若收件人未於指定的收件地址收取包裹，將會於該地址留下一張快遞通知單。此選項適用於 FedEx Express 及 FedEx Ground 美國和加拿大的貨件。

附註：

若要以追蹤號碼以外的方式追蹤，須附上寄件人帳號和安全追蹤內容。
FedEx Express 貨件支援墨西哥境內託運的簽收證明 (SPOD)。
FedEx Express 和 FedEx Ground 的簽收證明 (SPOD) 自託運日期起 16 個月內可取得。

若要溯源您的包裹，在致電 FedEx 顧客服務部時須提供下列所有資訊。

空運提單號碼
託運日期
收件人名稱及地址
貨件中的包裹總數和總重量
貨件的內容和價值
您的姓名和電話號碼

請求通知

FedEx 為您提供方便的電子郵件通知 (純文字或 HTML)，您最多可設定 4 個電子郵件通知收件人。您亦可依據個人偏好新增個人訊息 (須使用英文字元)。通知類型包括︰

通知我目前狀態：通知目前的詳細追蹤結果。
FedEx 已收到包裏：當貨件交予 FedEx 時，送出通知。
發生遞送的例外狀況：在發生清關延遲和遞送的例外狀況 (可能干擾包裹運送的突發事件) 時送出通知。如果發生清關延遲，待國際貨件通過清關程序可順利放行後，系統會自動傳送其他通知。
預估送達日期已更新：在預定的送達日前一天及遞送當日傳送提醒。也會在 FedEx 更新預定送達日期和/或時間時傳送通知。
貨件已遞送：貨件送達後寄出通知。

商務規則

將單一追蹤請求中的追蹤號碼筆數限制為 30 筆。這將降低回覆量，並減少交易回應時間。
限制商業需求必要的單一包裹/訂單追蹤次數。
針對批次追蹤，從批次中移除任何已傳回「已遞送」追蹤狀態的包裹/訂單。
無法提供追蹤記錄最常見的原因，在於輸入的追蹤/訂單號碼不正確。如果您不清楚追蹤/訂單號碼，建議您與寄件人確認。另外，新的包裹/訂單可能需最多 24 小時才會出現在系統中。
FedEx Express、FedEx Ground 及 FedEx Custom Critical 貨件遞送後 90 天內可以查看追蹤資訊。
若要使用依參考資料追蹤，就必須提供帳號或目的地郵遞區號或國家/地區詳細資料。
只有在包裹已交付給 FedEx 後，您才會取得預估送達日期 (EDD) 資訊。

JSON 應用程式開發介面 (API) 集合

Track API (1.0.0)

Track Multiple Piece Shipment

This endpoint returns tracking information for multiplee piece shipments, Group MPS, or an outbounddd shipment which is linked to a return shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_Multiple_Piece_Shipment
Minimum_Payload_Track_Multiple_Piece_Shipment

includeDetailedScans	boolean Indicates if detailed scans are requested or not. Valid values are True, or False.
masterTrackingNumberInfo required	object (MasterTrackingInfo) The detailed master tracking details for the shipment to be tracked.
associatedType required	string Enum: "OUTBOUND_LINK_TO_RETURN" "STANDARD_MPS" "GROUP_MPS" The associated shipment type, such as MPS, Group MPS, or an outbound shipment which is linked to a return shipment. Example: STANDARD_MPS STANDARD_MPS: Single shipment with multiple packages, where tracking number got assigned to all pieces, one tracking number is treated as master tracking number while others are child tracking numbers. Group MPS: Behavior is just like standard MPS but it’s created differently. The shipper must be enrolled for this by a particular reference type like ‘PO’ (purchase order).Then any package order create on the same day going to the same place that has the reference number will get grouped into GMPS relationships. OUTBOUND_LINK_TO_RETURN: is an RTRN relationship.Same concept as an MPS.the OUTBOUND_LINK_TO_RETURN is the Master outbound package tracking number, that when tracked with this indicator you can get all the child return pieces.
pagingDetails	object (PagingDetails) The details about how to retrieve the subsequent pages when there is more than one page in the TrackReply.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/associatedshipments

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/associatedshipments

Production Server

https://apis.fedex.com/track/v1/associatedshipments

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"includeDetailedScans": true,
"associatedType": "STANDARD_MPS",
"masterTrackingNumberInfo":
{
- "shipDateEnd": "2018-11-03",
- "shipDateBegin": "2018-11-01",
- "trackingNumberInfo":
  {
  - "trackingNumberUniqueId": "245822~123456789012~FDEG",
  - "carrierCode": "FDXE",
  - "trackingNumber": "858488600850"
  }
},
"pagingDetails":
{
- "resultsPerPage": 56,
- "pagingToken": "38903279038"
}

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "completeTrackResults":
  [
  - {
    "trackingNumber": "123456789012",
    "trackResults":
    [
    {
    "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    },
    "additionalTrackingInfo":
    {
    "hasAssociatedShipments": false,
    "nickname": "shipment nickname",
    "packageIdentifiers":
    [
    {
    "type": "SHIPPER_REFERENCE",
    "value": "ASJFGVAS",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    }
    ],
    "shipmentNotes": "shipment notes"
    },
    "distanceToDestination":
    {
    "units": "KM",
    "value": 685.7
    },
    "consolidationDetail":
    [
    {
    "timeStamp": "2020-10-13T03:54:44-06:00",
    "consolidationID": "47936927",
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "packageCount": 25,
    "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
    }
    ],
    "meterNumber": "8468376",
    "returnDetail":
    {
    "authorizationName": "Sammy Smith",
    "reasonDetail":
    [
    {
    "description": "Wrong color",
    "type": "REJECTED"
    }
    ]
    },
    "serviceDetail":
    {
    "description": "FedEx Freight Economy.",
    "shortDescription": "FL",
    "type": "FEDEX_FREIGHT_ECONOMY"
    },
    "destinationLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "latestStatusDetail":
    {
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "code": "PU",
    "derivedCode": "PU",
    "ancillaryDetails":
    [
    {
    "reason": "15",
    "reasonDescription": "Customer not available or business closed",
    "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
    "actionDescription": "Customer not Available or Business Closed"
    }
    ],
    "statusByLocale": "Picked up",
    "description": "Picked up",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    },
    "serviceCommitMessage":
    {
    "message": "No scheduled delivery date available at this time.",
    "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
    },
    "informationNotes":
    [
    {
    "code": "CLEARANCE_ENTRY_FEE_APPLIES",
    "description": "this is an informational message"
    }
    ],
    "error":
    {
    "code": "TRACKING.TRACKINGNUMBER.EMPTY",
    "parameterList":
    [
    {
    "value": "value",
    "key": "key"
    }
    ],
    "message": "Please provide tracking number."
    },
    "specialHandlings":
    [
    {
    "description": "Deliver Weekday",
    "type": "DELIVER_WEEKDAY",
    "paymentType": "OTHER"
    }
    ],
    "availableImages":
    [
    {
    "size": "LARGE",
    "type": "BILL_OF_LADING"
    }
    ],
    "deliveryDetails":
    {
    "receivedByName": "Reciever",
    "destinationServiceArea": "EDDUNAVAILABLE",
    "destinationServiceAreaDescription": "Appointment required",
    "locationDescription": "Receptionist/Front Desk",
    "actualDeliveryAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "deliveryToday": false,
    "locationType": "APARTMENT_OFFICE",
    "signedByName": "Reciever",
    "officeOrderDeliveryMethod": "Courier",
    "deliveryAttempts": "0",
    "deliveryOptionEligibilityDetails":
    [
    {
    "option": "INDIRECT_SIGNATURE_RELEASE",
    "eligibility": "INELIGIBLE"
    }
    ]
    },
    "scanEvents":
    [
    {
    "date": "2018-02-02T12:01:00-07:00",
    "derivedStatus": "Picked Up",
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "locationId": "SEA",
    "locationType": "CUSTOMS_BROKER",
    "exceptionDescription": "Package available for clearance",
    "eventDescription": "Picked Up",
    "eventType": "PU",
    "derivedStatusCode": "PU",
    "exceptionCode": "A25",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    }
    ],
    "dateAndTimes":
    [
    {
    "dateTime": "2007-09-27T00:00:00",
    "type": "ACTUAL_DELIVERY"
    }
    ],
    "packageDetails":
    {
    "physicalPackagingType": "BARREL",
    "sequenceNumber": "45",
    "undeliveredCount": "7",
    "packagingDescription":
    {
    "description": "FedEx Pak",
    "type": "FEDEX_PAK"
    },
    "count": "1",
    "weightAndDimensions":
    {
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "dimensions":
    [
    {
    "length": 100,
    "width": 50,
    "height": 30,
    "units": "CM"
    }
    ]
    },
    "packageContent":
    [
    "wire hangers",
    "buttons"
    ],
    "contentPieceCount": "100",
    "declaredValue":
    {
    "currency": "USD",
    "value": 56.8
    }
    },
    "goodsClassificationCode": "goodsClassificationCode",
    "holdAtLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "customDeliveryOptions":
    [
    {
    "requestedAppointmentDetail":
    {
    "date": "2019-05-07",
    "window":
    [
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    }
    ]
    },
    "description": "Redirect the package to the hold location.",
    "type": "REDIRECT_TO_HOLD_AT_LOCATION",
    "status": "HELD"
    }
    ],
    "estimatedDeliveryTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "pieceCounts":
    [
    {
    "count": "35",
    "description": "picec count description",
    "type": "ORIGIN"
    }
    ],
    "originLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    },
    "recipientInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "standardTransitTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "shipmentDetails":
    {
    "contents":
    [
    {
    "itemNumber": "RZ5678",
    "receivedQuantity": "13",
    "description": "pulyurethane rope",
    "partNumber": "RK1345"
    }
    ],
    "beforePossessionStatus": false,
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "contentPieceCount": "3333",
    "splitShipments":
    [
    {
    "pieceCount": "10",
    "statusDescription": "status",
    "timestamp": "2019-05-07T08:00:07",
    "statusCode": "statuscode"
    }
    ]
    },
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "availableNotifications":
    [
    "ON_DELIVERY",
    "ON_EXCEPTION"
    ],
    "shipperInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "lastUpdatedDestinationAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    ]
    }
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
}

}

Send Notification

This endpoint helps you setup up, customize the tracking event notifications to be received for a shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_Notification
Send_Shipment_Notifications

senderContactName required	string Placeholder for Sender contact name. Example: Sam Smith
senderEMailAddress required	string Email address of the sender from which the shipment notification will be sent. Example: LSR123@gmail.com
trackingEventNotificationDetail required	object (TrackingEventNotificationDetail) Object for holding tracking event Notification details.
trackingNumberInfo required	object (TrackingNumberInfo) Information uniquely identifying a shipment such as Tracking number, ShipDate, and Tracking number uniqueId.
shipDateBegin	string ShipDateBegin and ShipDateEnd are recommended to narrow the search, reduce lookup time, and avoid duplicates when searching for a specific tracking number in a specific time range. Format: YYYY-MM-DD example:'2019-10-13'
shipDateEnd	string ShipDateBegin and ShipDateEnd are recommended to narrow the search, reduce lookup time, and avoid duplicates when searching for a specific tracking number in a specific time range. Format: YYYY-MM-DD example:'2019-10-13'

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/notifications

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/notifications

Production Server

https://apis.fedex.com/track/v1/notifications

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"senderContactName": "Sam Smith",
"senderEMailAddress": "Lsr1234@gmail.com",
"trackingEventNotificationDetail":
{
- "trackingNotifications":
  [
  - {
    "notificationDetail":
    {
    "localization":
    {
    "languageCode": "en",
    "localeCode": "US"
    },
    "emailDetail":
    {
    "emailAddress": "p1@fedex.com",
    "name": "Preethi"
    },
    "notificationType": "HTML"
    },
    "role": "SHIPPER",
    "notificationEventTypes":
    [
    "ON_DELIVERY",
    "ON_EXCEPTION",
    "ON_ESTIMATED_DELIVERY"
    ],
    "currentResultRequestedFlag": true
    }
  ],
- "personalMessage": "Personal message content",
- "supportHTML": null
},
"trackingNumberInfo":
{
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
},
"shipDateBegin": "2019-10-13",
"shipDateEnd": "2019-10-31"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "TrackingNumberInfo":
  {
  - "trackingNumber": "128667043726",
  - "carrierCode": "FDXE",
  - "trackingNumberUniqueId": "245822~123456789012~FDEG"
  },
- "destinationAddress":
  {
  - "classification": "BUSINESS",
  - "residential": false,
  - "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
  - "city": "SEATTLE",
  - "stateOrProvinceCode": "WA",
  - "postalCode": "98101",
  - "countryCode": "US",
  - "countryName": "United States"
  },
- "recipientDetails":
  [
  - [
    "[\"ON_ESTIMATED_DELIVERY\"]"
    ]
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
}

}

Track by References

This endpoint returns tracking information based on alternate references other than Tracking Number such as Customer reference numbers, etc.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_Tracking_References
Track_by_References_using_accountNumber
Track_by_References_using_destination

referencesInformation

required

object (ReferenceInformation)

Specifies the reference details for the tracked shipment. The following rules apply
- Either shipper.AccountNumber or Destination.countryCode(and postal for postal aware countries) are required
- If ShipDateRangeBegin and End are not present, shipDateRangeBegin will be set to the current date minus 30 days, and shipDdateRangeEnd will default to current date plus one day.

includeDetailedScans

boolean

Indicates if the detailed scans are being requested or not. If true, the detailed scans will be included in the response returned.
Valid values are True or False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/referencenumbers

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/referencenumbers

Production Server

https://apis.fedex.com/track/v1/referencenumbers

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"referencesInformation":
{
- "type": "BILL_OF_LADING",
- "value": "56754674567546754",
- "accountNumber": "XXX61073",
- "carrierCode": "FDXE",
- "shipDateBegin": "2019-02-13",
- "shipDateEnd": "2019-02-13",
- "destinationCountryCode": "US",
- "destinationPostalCode": "75063"
},
"includeDetailedScans": "true"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "cxsErrors":
  [
  - {
    "code": "TRACKING.TRACKINGNUMBER.EMPTY",
    "parameterList":
    [
    {
    "value": "value",
    "key": "key"
    }
    ],
    "message": "Please provide tracking number."
    }
  ],
- "completeTrackResults":
  [
  - {
    "trackingNumber": "123456789012",
    "trackResults":
    [
    {
    "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    },
    "additionalTrackingInfo":
    {
    "hasAssociatedShipments": false,
    "nickname": "shipment nickname",
    "packageIdentifiers":
    [
    {
    "type": "SHIPPER_REFERENCE",
    "value": "ASJFGVAS",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    }
    ],
    "shipmentNotes": "shipment notes"
    },
    "distanceToDestination":
    {
    "units": "KM",
    "value": 685.7
    },
    "consolidationDetail":
    [
    {
    "timeStamp": "2020-10-13T03:54:44-06:00",
    "consolidationID": "47936927",
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "packageCount": 25,
    "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
    }
    ],
    "meterNumber": "8468376",
    "returnDetail":
    {
    "authorizationName": "Sammy Smith",
    "reasonDetail":
    [
    {
    "description": "Wrong color",
    "type": "REJECTED"
    }
    ]
    },
    "serviceDetail":
    {
    "description": "FedEx Freight Economy.",
    "shortDescription": "FL",
    "type": "FEDEX_FREIGHT_ECONOMY"
    },
    "destinationLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "latestStatusDetail":
    {
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "code": "PU",
    "derivedCode": "PU",
    "ancillaryDetails":
    [
    {
    "reason": "15",
    "reasonDescription": "Customer not available or business closed",
    "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
    "actionDescription": "Customer not Available or Business Closed"
    }
    ],
    "statusByLocale": "Picked up",
    "description": "Picked up",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    },
    "serviceCommitMessage":
    {
    "message": "No scheduled delivery date available at this time.",
    "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
    },
    "informationNotes":
    [
    {
    "code": "CLEARANCE_ENTRY_FEE_APPLIES",
    "description": "this is an informational message"
    }
    ],
    "error":
    {
    "code": "TRACKING.TRACKINGNUMBER.EMPTY",
    "parameterList":
    [
    {
    "value": "value",
    "key": "key"
    }
    ],
    "message": "Please provide tracking number."
    },
    "specialHandlings":
    [
    {
    "description": "Deliver Weekday",
    "type": "DELIVER_WEEKDAY",
    "paymentType": "OTHER"
    }
    ],
    "availableImages":
    [
    {
    "size": "LARGE",
    "type": "BILL_OF_LADING"
    }
    ],
    "deliveryDetails":
    {
    "receivedByName": "Reciever",
    "destinationServiceArea": "EDDUNAVAILABLE",
    "destinationServiceAreaDescription": "Appointment required",
    "locationDescription": "Receptionist/Front Desk",
    "actualDeliveryAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "deliveryToday": false,
    "locationType": "APARTMENT_OFFICE",
    "signedByName": "Reciever",
    "officeOrderDeliveryMethod": "Courier",
    "deliveryAttempts": "0",
    "deliveryOptionEligibilityDetails":
    [
    {
    "option": "INDIRECT_SIGNATURE_RELEASE",
    "eligibility": "INELIGIBLE"
    }
    ]
    },
    "scanEvents":
    [
    {
    "date": "2018-02-02T12:01:00-07:00",
    "derivedStatus": "Picked Up",
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "locationId": "SEA",
    "locationType": "CUSTOMS_BROKER",
    "exceptionDescription": "Package available for clearance",
    "eventDescription": "Picked Up",
    "eventType": "PU",
    "derivedStatusCode": "PU",
    "exceptionCode": "A25",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    }
    ],
    "dateAndTimes":
    [
    {
    "dateTime": "2007-09-27T00:00:00",
    "type": "ACTUAL_DELIVERY"
    }
    ],
    "packageDetails":
    {
    "physicalPackagingType": "BARREL",
    "sequenceNumber": "45",
    "undeliveredCount": "7",
    "packagingDescription":
    {
    "description": "FedEx Pak",
    "type": "FEDEX_PAK"
    },
    "count": "1",
    "weightAndDimensions":
    {
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "dimensions":
    [
    {
    "length": 100,
    "width": 50,
    "height": 30,
    "units": "CM"
    }
    ]
    },
    "packageContent":
    [
    "wire hangers",
    "buttons"
    ],
    "contentPieceCount": "100",
    "declaredValue":
    {
    "currency": "USD",
    "value": 56.8
    }
    },
    "goodsClassificationCode": "goodsClassificationCode",
    "holdAtLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "customDeliveryOptions":
    [
    {
    "requestedAppointmentDetail":
    {
    "date": "2019-05-07",
    "window":
    [
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    }
    ]
    },
    "description": "Redirect the package to the hold location.",
    "type": "REDIRECT_TO_HOLD_AT_LOCATION",
    "status": "HELD"
    }
    ],
    "estimatedDeliveryTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "pieceCounts":
    [
    {
    "count": "35",
    "description": "picec count description",
    "type": "ORIGIN"
    }
    ],
    "originLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    },
    "recipientInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "standardTransitTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "shipmentDetails":
    {
    "contents":
    [
    {
    "itemNumber": "RZ5678",
    "receivedQuantity": "13",
    "description": "pulyurethane rope",
    "partNumber": "RK1345"
    }
    ],
    "beforePossessionStatus": false,
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "contentPieceCount": "3333",
    "splitShipments":
    [
    {
    "pieceCount": "10",
    "statusDescription": "status",
    "timestamp": "2019-05-07T08:00:07",
    "statusCode": "statuscode"
    }
    ]
    },
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "availableNotifications":
    [
    "ON_DELIVERY",
    "ON_EXCEPTION"
    ],
    "shipperInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "lastUpdatedDestinationAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    ]
    }
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable",
- "successful": true
}

}

Track by Tracking Control Number

Use this endpoint to return tracking information based on a Tracking Control Number.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_TCN
Minimum_Payload_Track_By_Tracking_Control_Number

tcnInfo required	object The information associated with the transportation control number. Only 1 TCN is supported per request.
includeDetailedScans	boolean Indicates if detailed scans are requested or not. Valid values are True, or False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/tcn

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/tcn

Production Server

https://apis.fedex.com/track/v1/tcn

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"tcnInfo":
{
- "value": "N552428361Y555XXX",
- "carrierCode": "FDXE",
- "shipDateBegin": "2019-02-13",
- "shipDateEnd": "2019-02-13"
},
"includeDetailedScans": true

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "completeTrackResults":
  [
  - {
    "trackingNumber": "123456789012",
    "trackResults":
    [
    {
    "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    },
    "additionalTrackingInfo":
    {
    "hasAssociatedShipments": false,
    "nickname": "shipment nickname",
    "packageIdentifiers":
    [
    {
    "type": "SHIPPER_REFERENCE",
    "value": "ASJFGVAS",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    }
    ],
    "shipmentNotes": "shipment notes"
    },
    "distanceToDestination":
    {
    "units": "KM",
    "value": 685.7
    },
    "consolidationDetail":
    [
    {
    "timeStamp": "2020-10-13T03:54:44-06:00",
    "consolidationID": "47936927",
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "packageCount": 25,
    "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
    }
    ],
    "meterNumber": "8468376",
    "returnDetail":
    {
    "authorizationName": "Sammy Smith",
    "reasonDetail":
    [
    {
    "description": "Wrong color",
    "type": "REJECTED"
    }
    ]
    },
    "serviceDetail":
    {
    "description": "FedEx Freight Economy.",
    "shortDescription": "FL",
    "type": "FEDEX_FREIGHT_ECONOMY"
    },
    "destinationLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "latestStatusDetail":
    {
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "code": "PU",
    "derivedCode": "PU",
    "ancillaryDetails":
    [
    {
    "reason": "15",
    "reasonDescription": "Customer not available or business closed",
    "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
    "actionDescription": "Customer not Available or Business Closed"
    }
    ],
    "statusByLocale": "Picked up",
    "description": "Picked up",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    },
    "serviceCommitMessage":
    {
    "message": "No scheduled delivery date available at this time.",
    "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
    },
    "informationNotes":
    [
    {
    "code": "CLEARANCE_ENTRY_FEE_APPLIES",
    "description": "this is an informational message"
    }
    ],
    "error":
    {
    "code": "TRACKING.TRACKINGNUMBER.EMPTY",
    "parameterList":
    [
    {
    "value": "value",
    "key": "key"
    }
    ],
    "message": "Please provide tracking number."
    },
    "specialHandlings":
    [
    {
    "description": "Deliver Weekday",
    "type": "DELIVER_WEEKDAY",
    "paymentType": "OTHER"
    }
    ],
    "availableImages":
    [
    {
    "size": "LARGE",
    "type": "BILL_OF_LADING"
    }
    ],
    "deliveryDetails":
    {
    "receivedByName": "Reciever",
    "destinationServiceArea": "EDDUNAVAILABLE",
    "destinationServiceAreaDescription": "Appointment required",
    "locationDescription": "Receptionist/Front Desk",
    "actualDeliveryAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "deliveryToday": false,
    "locationType": "APARTMENT_OFFICE",
    "signedByName": "Reciever",
    "officeOrderDeliveryMethod": "Courier",
    "deliveryAttempts": "0",
    "deliveryOptionEligibilityDetails":
    [
    {
    "option": "INDIRECT_SIGNATURE_RELEASE",
    "eligibility": "INELIGIBLE"
    }
    ]
    },
    "scanEvents":
    [
    {
    "date": "2018-02-02T12:01:00-07:00",
    "derivedStatus": "Picked Up",
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "locationId": "SEA",
    "locationType": "CUSTOMS_BROKER",
    "exceptionDescription": "Package available for clearance",
    "eventDescription": "Picked Up",
    "eventType": "PU",
    "derivedStatusCode": "PU",
    "exceptionCode": "A25",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    }
    ],
    "dateAndTimes":
    [
    {
    "dateTime": "2007-09-27T00:00:00",
    "type": "ACTUAL_DELIVERY"
    }
    ],
    "packageDetails":
    {
    "physicalPackagingType": "BARREL",
    "sequenceNumber": "45",
    "undeliveredCount": "7",
    "packagingDescription":
    {
    "description": "FedEx Pak",
    "type": "FEDEX_PAK"
    },
    "count": "1",
    "weightAndDimensions":
    {
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "dimensions":
    [
    {
    "length": 100,
    "width": 50,
    "height": 30,
    "units": "CM"
    }
    ]
    },
    "packageContent":
    [
    "wire hangers",
    "buttons"
    ],
    "contentPieceCount": "100",
    "declaredValue":
    {
    "currency": "USD",
    "value": 56.8
    }
    },
    "goodsClassificationCode": "goodsClassificationCode",
    "holdAtLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "customDeliveryOptions":
    [
    {
    "requestedAppointmentDetail":
    {
    "date": "2019-05-07",
    "window":
    [
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    }
    ]
    },
    "description": "Redirect the package to the hold location.",
    "type": "REDIRECT_TO_HOLD_AT_LOCATION",
    "status": "HELD"
    }
    ],
    "estimatedDeliveryTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "pieceCounts":
    [
    {
    "count": "35",
    "description": "picec count description",
    "type": "ORIGIN"
    }
    ],
    "originLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    },
    "recipientInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "standardTransitTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "shipmentDetails":
    {
    "contents":
    [
    {
    "itemNumber": "RZ5678",
    "receivedQuantity": "13",
    "description": "pulyurethane rope",
    "partNumber": "RK1345"
    }
    ],
    "beforePossessionStatus": false,
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "contentPieceCount": "3333",
    "splitShipments":
    [
    {
    "pieceCount": "10",
    "statusDescription": "status",
    "timestamp": "2019-05-07T08:00:07",
    "statusCode": "statuscode"
    }
    ]
    },
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "availableNotifications":
    [
    "ON_DELIVERY",
    "ON_EXCEPTION"
    ],
    "shipperInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "lastUpdatedDestinationAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    ]
    }
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
}

}

Track Document

This endpoint helps you to request a letter that includes the recipient's signature as a proof of delivery.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_SPOD
Minimum_Payload_Track_Document
Minimum_Sample_Payload_BOL
Minimum_Sample_Payload_FBD

trackDocumentDetail required	object This object specifies the tracking document details such as types of documents, for example, SIGNATURE_PROOF_OF_DELIVERY and also the format of tracking document. Supported values are PDF and PNG. Default is PDF.
trackDocumentSpecification required	Array of objects (TrackDocumentSpecification) This is the placeholder for document specification details required to identify the shipment being tracked. This includes tracking information such as tracking qualifier, carrier code, and tracking number. At least one trackDocumentSpecification is required. Maximum limit is 30.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/trackingdocuments

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/trackingdocuments

Production Server

https://apis.fedex.com/track/v1/trackingdocuments

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"trackDocumentDetail":
{
- "documentType": "SIGNATURE_PROOF_OF_DELIVERY",
- "documentFormat": "PNG"
},
"trackDocumentSpecification":
[
- {
  - "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    },
  - "shipDateBegin": "2020-03-29",
  - "shipDateEnd": "2020-04-01",
  - "accountNumber": "XXX61073"
  }
]

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "localization":
  {
  - "languageCode": "en",
  - "localeCode": "US"
  },
- "documentType": "string",
- "documentFormat": "PNG",
- "document":
  [
  - "string"
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
}

}

Track by Tracking Number

This endpoint provides customers package tracking information based on a tracking number for various shipping services.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

Full_Schema_Tracking_Numbers
Track_by_Tracking_Number

includeDetailedScans required	boolean Indicates if detailed scans are requested or not. Valid values are True, or False.
trackingInfo required	Array of objects (TrackingInfo) The tracking information of the shipment to be tracked. At least one occurrence of TrackingInfo is required. Maximum limit is 30.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/trackingnumbers

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/trackingnumbers

Production Server

https://apis.fedex.com/track/v1/trackingnumbers

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"includeDetailedScans": true,
"trackingInfo":
[
- {
  - "shipDateBegin": "2020-03-29",
  - "shipDateEnd": "2020-04-01",
  - "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    }
  }
]

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"output":
{
- "completeTrackResults":
  [
  - {
    "trackingNumber": "123456789012",
    "trackResults":
    [
    {
    "trackingNumberInfo":
    {
    "trackingNumber": "128667043726",
    "carrierCode": "FDXE",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    },
    "additionalTrackingInfo":
    {
    "hasAssociatedShipments": false,
    "nickname": "shipment nickname",
    "packageIdentifiers":
    [
    {
    "type": "SHIPPER_REFERENCE",
    "value": "ASJFGVAS",
    "trackingNumberUniqueId": "245822~123456789012~FDEG"
    }
    ],
    "shipmentNotes": "shipment notes"
    },
    "distanceToDestination":
    {
    "units": "KM",
    "value": 685.7
    },
    "consolidationDetail":
    [
    {
    "timeStamp": "2020-10-13T03:54:44-06:00",
    "consolidationID": "47936927",
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "packageCount": 25,
    "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
    }
    ],
    "meterNumber": "8468376",
    "returnDetail":
    {
    "authorizationName": "Sammy Smith",
    "reasonDetail":
    [
    {
    "description": "Wrong color",
    "type": "REJECTED"
    }
    ]
    },
    "serviceDetail":
    {
    "description": "FedEx Freight Economy.",
    "shortDescription": "FL",
    "type": "FEDEX_FREIGHT_ECONOMY"
    },
    "destinationLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "latestStatusDetail":
    {
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "code": "PU",
    "derivedCode": "PU",
    "ancillaryDetails":
    [
    {
    "reason": "15",
    "reasonDescription": "Customer not available or business closed",
    "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
    "actionDescription": "Customer not Available or Business Closed"
    }
    ],
    "statusByLocale": "Picked up",
    "description": "Picked up",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    },
    "serviceCommitMessage":
    {
    "message": "No scheduled delivery date available at this time.",
    "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
    },
    "informationNotes":
    [
    {
    "code": "CLEARANCE_ENTRY_FEE_APPLIES",
    "description": "this is an informational message"
    }
    ],
    "error":
    {
    "code": "TRACKING.TRACKINGNUMBER.EMPTY",
    "parameterList":
    [
    {
    "value": "value",
    "key": "key"
    }
    ],
    "message": "Please provide tracking number."
    },
    "specialHandlings":
    [
    {
    "description": "Deliver Weekday",
    "type": "DELIVER_WEEKDAY",
    "paymentType": "OTHER"
    }
    ],
    "availableImages":
    [
    {
    "size": "LARGE",
    "type": "BILL_OF_LADING"
    }
    ],
    "deliveryDetails":
    {
    "receivedByName": "Reciever",
    "destinationServiceArea": "EDDUNAVAILABLE",
    "destinationServiceAreaDescription": "Appointment required",
    "locationDescription": "Receptionist/Front Desk",
    "actualDeliveryAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "deliveryToday": false,
    "locationType": "APARTMENT_OFFICE",
    "signedByName": "Reciever",
    "officeOrderDeliveryMethod": "Courier",
    "deliveryAttempts": "0",
    "deliveryOptionEligibilityDetails":
    [
    {
    "option": "INDIRECT_SIGNATURE_RELEASE",
    "eligibility": "INELIGIBLE"
    }
    ]
    },
    "scanEvents":
    [
    {
    "date": "2018-02-02T12:01:00-07:00",
    "derivedStatus": "Picked Up",
    "scanLocation":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    },
    "locationId": "SEA",
    "locationType": "CUSTOMS_BROKER",
    "exceptionDescription": "Package available for clearance",
    "eventDescription": "Picked Up",
    "eventType": "PU",
    "derivedStatusCode": "PU",
    "exceptionCode": "A25",
    "delayDetail":
    {
    "type": "WEATHER",
    "subType": "SNOW",
    "status": "DELAYED"
    }
    }
    ],
    "dateAndTimes":
    [
    {
    "dateTime": "2007-09-27T00:00:00",
    "type": "ACTUAL_DELIVERY"
    }
    ],
    "packageDetails":
    {
    "physicalPackagingType": "BARREL",
    "sequenceNumber": "45",
    "undeliveredCount": "7",
    "packagingDescription":
    {
    "description": "FedEx Pak",
    "type": "FEDEX_PAK"
    },
    "count": "1",
    "weightAndDimensions":
    {
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "dimensions":
    [
    {
    "length": 100,
    "width": 50,
    "height": 30,
    "units": "CM"
    }
    ]
    },
    "packageContent":
    [
    "wire hangers",
    "buttons"
    ],
    "contentPieceCount": "100",
    "declaredValue":
    {
    "currency": "USD",
    "value": 56.8
    }
    },
    "goodsClassificationCode": "goodsClassificationCode",
    "holdAtLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "locationType": "FEDEX_SHIPSITE"
    },
    "customDeliveryOptions":
    [
    {
    "requestedAppointmentDetail":
    {
    "date": "2019-05-07",
    "window":
    [
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    }
    ]
    },
    "description": "Redirect the package to the hold location.",
    "type": "REDIRECT_TO_HOLD_AT_LOCATION",
    "status": "HELD"
    }
    ],
    "estimatedDeliveryTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "pieceCounts":
    [
    {
    "count": "35",
    "description": "picec count description",
    "type": "ORIGIN"
    }
    ],
    "originLocation":
    {
    "locationId": "SEA",
    "locationContactAndAddress":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    },
    "recipientInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "standardTransitTimeWindow":
    {
    "description": "Description field",
    "window":
    {
    "begins": "2021-10-01T08:00:00",
    "ends": "2021-10-15T00:00:00-06:00"
    },
    "type": "ESTIMATED_DELIVERY"
    },
    "shipmentDetails":
    {
    "contents":
    [
    {
    "itemNumber": "RZ5678",
    "receivedQuantity": "13",
    "description": "pulyurethane rope",
    "partNumber": "RK1345"
    }
    ],
    "beforePossessionStatus": false,
    "weight":
    [
    {
    "unit": "LB",
    "value": "22222.0"
    }
    ],
    "contentPieceCount": "3333",
    "splitShipments":
    [
    {
    "pieceCount": "10",
    "statusDescription": "status",
    "timestamp": "2019-05-07T08:00:07",
    "statusCode": "statuscode"
    }
    ]
    },
    "reasonDetail":
    {
    "description": "Wrong color",
    "type": "REJECTED"
    },
    "availableNotifications":
    [
    "ON_DELIVERY",
    "ON_EXCEPTION"
    ],
    "shipperInformation":
    {
    "address":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    },
    "lastUpdatedDestinationAddress":
    {
    "addressClassification": "BUSINESS",
    "residential": false,
    "streetLines":
    [
    "1043 North Easy Street",
    "Suite 999"
    ],
    "city": "SEATTLE",
    "stateOrProvinceCode": "WA",
    "postalCode": "98101",
    "countryCode": "US",
    "countryName": "United States"
    }
    }
    ]
    }
  ],
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
}

}

Request
Response

Response

Copy

Developer Portal

Track API

簡介

追蹤應用程式開發介面 (API) 詳細資料

FedEx 追蹤方式

追蹤應用程式開發介面 (API) 的運作方式

追蹤摘要結果

追蹤遞送時程 (準時/延誤)

FedEx 預估送達時間範圍 (EDTW)

簽收證明

依參考資料查詢

批次追蹤

國際包裹追蹤/溯源

請求通知

商務規則

JSON 應用程式開發介面 (API) 集合

Track API (1.0.0)

Track Multiple Piece Shipment

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Send Notification

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Track by References

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Track by Tracking Control Number

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Track Document

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Track by Tracking Number

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Enter your user ID and password to log in