FedEx Track by Reference Virtual Sandbox
Track shipments using customer-provided reference numbers.
The FedEx Track by Reference API allows developers to retrieve shipment status and tracking details using internal customer reference numbers instead of standard tracking IDs. This service provides visibility into shipment progress, delivery status, and exception events for logistics workflows.
Use this hosted sandbox to simulate FedEx Track by Reference APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready.
This keeps your integration code consistent across local development, QA, demos, and production.
Use cases:
Use this sandbox to validate reference-based tracking requests, verify response mapping for various shipment statuses, test error handling for invalid reference numbers, and ensure proper parsing of tracking event objects in your logistics integration.
General
POST
| Header Name | Example |
|---|---|
x-customer-transaction-id | "624deea6-b709-470c-8c39-4b5511281492" |
content-type* | "application/json" |
x-locale | "en_US" |
authorization* | "Bearer XXX" |
{
"referencesInformation": {
"accountNumber": "XXX61073",
"shipDateBegin": "2020-08-15",
"shipDateEnd": "2020-08-15",
"value": "11716439 [4133589]"
}
}{
"customerTransactionId": "PVpyO8WWLaAtj47",
"output": {
"alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable",
"completeTrackResults": [
{
"trackingNumber": "7",
"trackResults": [
{
"additionalTrackingInfo": {
"hasAssociatedShipments": true,
"nickname": "Order 1",
"packageIdentifiers": [
{
"trackingNumberUniqueId": "327430~381844258277~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "058241~491397561543~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "565110~277941245201~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "536168~408647755451~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
}
],
"shipmentNotes": "Handle with care"
},
"availableImages": [
{
"size": "LARGE",
"type": "BILL_OF_LADING"
},
{
"size": "LARGE",
"type": "BILL_OF_LADING"
},
{
"size": "LARGE",
"type": "BILL_OF_LADING"
},
{
"size": "LARGE",
"type": "BILL_OF_LADING"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION"
],
"consolidationDetail": [
{
"consolidationID": "2",
"eventType": "PACKAGE_ADDED_TO_CONSOLIDATION",
"packageCount": 21,
"reasonDetail": {
"description": "Wrong color",
"type": "RETURNED"
},
"timeStamp": "2026-07-23T00:00:00.0Z"
},
{
"consolidationID": "9",
"eventType": "PACKAGE_REMOVED_FROM_CONSOLIDATION",
"packageCount": 6,
"reasonDetail": {
"description": "Customer request",
"type": "REJECTED"
},
"timeStamp": "2026-07-18T00:00:00.0Z"
},
{
"consolidationID": "4",
"eventType": "PACKAGE_ADDED_TO_CONSOLIDATION",
"packageCount": 36,
"reasonDetail": {
"description": "Wrong color",
"type": "REJECTED"
},
"timeStamp": "2026-07-19T00:00:00.0Z"
}
],
"customDeliveryOptions": [
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2027-06-25T00:00:00.0Z",
"window": [
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2026-11-10T00:00:00.0Z",
"window": [
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2027-06-16T00:00:00.0Z",
"window": [
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "PENDING",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2027-03-16T00:00:00.0Z",
"window": [
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
}
],
"dateAndTimes": [
{
"dateTime": "2026-07-22T00:00:00.0Z",
"type": "ACTUAL_DELIVERY"
}
],
"deliveryDetails": {
"actualDeliveryAddress": {
"city": "Stockton",
"classification": "BUSINESS",
"countryCode": "CN",
"countryName": "Colombia",
"postalCode": "04423",
"residential": false,
"stateOrProvinceCode": "CT",
"streetLines": [
"1043 North Easy Street",
"Suite 999"
]
},
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"eligibility": "INELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
},
{
"eligibility": "INELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
}
],
"deliveryToday": true,
"destinationServiceArea": "EN7R7",
"destinationServiceAreaDescription": "Standard delivery",
"locationDescription": "Receptionist",
"locationType": "FEDEX_OFFICE",
"officeOrderDeliveryMethod": "Pickup",
"receivedByName": "Felix Daugherty",
"signedByName": "Carol Streich"
},
"destinationLocation": {
"locationContactAndAddress": {
"address": {
"city": "New Britain",
"classification": "BUSINESS",
"countryCode": "NZ",
"postalCode": "82123",
"residential": false,
"stateOrProvinceCode": "CO",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "SEA",
"locationType": "PICKUP_LOCATION"
},
"distanceToDestination": {
"units": "KM",
"value": 1654.13
},
"error": {
"code": "TRACKING.NOT_FOUND",
"message": "Please provide tracking number.",
"parameterList": [
{
"key": "param1",
"value": "Q1vH2OeG"
},
{
"key": "param2",
"value": "Mmk6lFOH"
},
{
"key": "param2",
"value": "sQFOhh83"
}
]
},
"estimatedDeliveryTimeWindow": {
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
"goodsClassificationCode": "rN16Va",
"holdAtLocation": {
"locationContactAndAddress": {
"address": {
"city": "East Elwin",
"classification": "RESIDENTIAL",
"countryCode": "RS",
"countryName": "Armenia",
"postalCode": "69793",
"residential": false,
"stateOrProvinceCode": "TN",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "Hand, Pollich and Fay",
"personName": "Winston Becker-Hessel DDS",
"phoneNumber": "(793) 865-6632"
}
},
"locationId": "LAX",
"locationType": "PICKUP_LOCATION"
},
"informationNotes": [
{
"code": "CLEARANCE_ENTRY_FEE_APPLIES",
"description": "Package requires signature."
}
],
"lastUpdatedDestinationAddress": {
"city": "Jamarcuschester",
"classification": "RESIDENTIAL",
"countryCode": "PL",
"countryName": "United States of America",
"postalCode": "45397",
"residential": false,
"stateOrProvinceCode": "MO",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"latestStatusDetail": {
"ancillaryDetails": [
{
"action": "https://all-papa.name",
"actionDescription": "Reschedule delivery",
"reason": "2",
"reasonDescription": "Refused delivery"
},
{
"action": "https://candid-cork.info",
"actionDescription": "Reschedule delivery",
"reason": "3",
"reasonDescription": "Customer not available"
},
{
"action": "https://mammoth-markup.net/",
"actionDescription": "Reschedule delivery",
"reason": "3",
"reasonDescription": "Business closed"
},
{
"action": "https://immaculate-release.name/",
"actionDescription": "Contact us for support",
"reason": "3",
"reasonDescription": "Customer not available"
}
],
"code": "DL",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedCode": "IT",
"description": "Picked up",
"scanLocation": {
"city": "Gerholdport",
"classification": "RESIDENTIAL",
"countryCode": "CK",
"countryName": "Russian Federation",
"postalCode": "35740",
"residential": false,
"stateOrProvinceCode": "VA",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"statusByLocale": "In transit"
},
"meterNumber": "2",
"originLocation": {
"locationContactAndAddress": {
"address": {
"city": "Daughertyfort",
"classification": "BUSINESS",
"countryCode": "VI",
"postalCode": "49389-1240",
"residential": false,
"stateOrProvinceCode": "NM",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "ORD",
"locationType": "PICKUP_LOCATION"
},
"packageDetails": {
"contentPieceCount": "9",
"count": "5",
"declaredValue": {
"currency": "HTG",
"value": 276.11
},
"packageContent": [
"wire hangers",
"buttons"
],
"packagingDescription": {
"description": "FedEx Envelope",
"type": "FEDEX_PAK"
},
"physicalPackagingType": "BARREL",
"sequenceNumber": "9",
"undeliveredCount": "0",
"weightAndDimensions": {
"dimensions": [
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
},
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
}
],
"weight": [
{
"unit": "LB",
"value": "9"
}
]
}
},
"pieceCounts": [
{
"count": "8",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "0",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "1",
"description": "Piece count description",
"type": "ORIGIN"
}
],
"reasonDetail": {
"description": "Wrong color",
"type": "REJECTED"
},
"recipientInformation": {
"address": {
"city": "Goodwinbury",
"classification": "BUSINESS",
"countryCode": "SO",
"countryName": "Niue",
"postalCode": "44161",
"residential": false,
"stateOrProvinceCode": "SD",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "Cummerata, Sawayn and Olson",
"personName": "Tracy Larson",
"phoneNumber": "(780) 395-6748"
}
},
"returnDetail": {
"authorizationName": "Everett Leffler",
"reasonDetail": [
{
"description": "Incorrect address",
"type": "REJECTED"
},
{
"description": "Incorrect address",
"type": "CANCELLED"
},
{
"description": "Wrong color",
"type": "REJECTED"
}
]
},
"scanEvents": [
{
"date": "2026-07-22T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "In transit",
"derivedStatusCode": "PU",
"eventDescription": "Departed facility",
"eventType": "DP",
"exceptionCode": "A25",
"exceptionDescription": "Clearance delay",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "Portage",
"classification": "RESIDENTIAL",
"countryCode": "MY",
"postalCode": "77288",
"residential": false,
"stateOrProvinceCode": "WV",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "NYC",
"locationType": "PICKUP_LOCATION"
}
},
{
"date": "2026-07-22T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "In transit",
"derivedStatusCode": "DP",
"eventDescription": "Picked up",
"eventType": "DP",
"exceptionCode": "A25",
"exceptionDescription": "Clearance delay",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "Fort Yvonne",
"classification": "RESIDENTIAL",
"countryCode": "AD",
"postalCode": "58931-3688",
"residential": false,
"stateOrProvinceCode": "ID",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "SEA",
"locationType": "PICKUP_LOCATION"
}
},
{
"date": "2026-07-22T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "In transit",
"derivedStatusCode": "PU",
"eventDescription": "Picked up",
"eventType": "DP",
"exceptionCode": "A25",
"exceptionDescription": "None",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "East Eugeniaport",
"classification": "BUSINESS",
"countryCode": "MW",
"postalCode": "97527-5597",
"residential": false,
"stateOrProvinceCode": "KS",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "NYC",
"locationType": "PICKUP_LOCATION"
}
},
{
"date": "2026-07-21T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "Delivered",
"derivedStatusCode": "PU",
"eventDescription": "Picked up",
"eventType": "DP",
"exceptionCode": "B10",
"exceptionDescription": "Clearance delay",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "New Haven",
"classification": "BUSINESS",
"countryCode": "MK",
"postalCode": "57902-6353",
"residential": false,
"stateOrProvinceCode": "IL",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "LAX",
"locationType": "PICKUP_LOCATION"
}
}
],
"serviceCommitMessage": {
"message": "No scheduled delivery date available.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"description": "FedEx Freight Economy",
"shortDescription": "FG",
"type": "FEDEX_FREIGHT_ECONOMY"
},
"shipmentDetails": {
"beforePossessionStatus": true,
"contentPieceCount": "6",
"contents": [
{
"description": "Electronic parts",
"itemNumber": "QNUqHI",
"partNumber": "waNaxx",
"receivedQuantity": "4"
},
{
"description": "Office supplies",
"itemNumber": "XK8tAU",
"partNumber": "WgfldF",
"receivedQuantity": "4"
}
],
"splitShipments": [
{
"pieceCount": "6",
"statusCode": "YFcF",
"statusDescription": "Pending",
"timestamp": "2026-07-21T00:00:00.0Z"
},
{
"pieceCount": "5",
"statusCode": "YxPD",
"statusDescription": "Status OK",
"timestamp": "2026-07-23T00:00:00.0Z"
},
{
"pieceCount": "8",
"statusCode": "gFhO",
"statusDescription": "Status OK",
"timestamp": "2026-07-22T00:00:00.0Z"
},
{
"pieceCount": "6",
"statusCode": "Jt0Z",
"statusDescription": "Pending",
"timestamp": "2026-07-22T00:00:00.0Z"
}
],
"weight": [
{
"unit": "LB",
"value": "0"
},
{
"unit": "LB",
"value": "6"
},
{
"unit": "LB",
"value": "2"
}
]
},
"shipperInformation": {
"address": {
"city": "Reichelfort",
"classification": "RESIDENTIAL",
"countryCode": "ML",
"countryName": "Falkland Islands (Malvinas)",
"postalCode": "22081-0054",
"residential": false,
"stateOrProvinceCode": "TN",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "Fahey, Dibbert and Corwin",
"personName": "Raquel Gutmann",
"phoneNumber": "(496) 970-5983"
}
},
"specialHandlings": [
{
"description": "Deliver Weekday",
"paymentType": "BILL_SENDER",
"type": "DELIVER_WEEKDAY"
},
{
"description": "Saturday Delivery",
"paymentType": "OTHER",
"type": "SATURDAY_DELIVERY"
}
],
"standardTransitTimeWindow": {
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
"trackingNumberInfo": {
"carrierCode": "FDXE",
"trackingNumber": "9",
"trackingNumberUniqueId": "311931~984394654889~FDEG"
}
},
{
"additionalTrackingInfo": {
"hasAssociatedShipments": true,
"nickname": "Order 1",
"packageIdentifiers": [
{
"trackingNumberUniqueId": "535323~919129144806~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "470751~261420988619~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "125440~211004967985~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "779235~824714397322~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
},
{
"trackingNumberUniqueId": "330709~738781974054~FDEG",
"type": "SHIPPER_REFERENCE",
"value": "ASJFGVAS"
}
],
"shipmentNotes": "Do not ring bell"
},
"availableImages": [
{
"size": "LARGE",
"type": "BILL_OF_LADING"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION"
],
"consolidationDetail": [
{
"consolidationID": "4",
"eventType": "PACKAGE_ADDED_TO_CONSOLIDATION",
"packageCount": 18,
"reasonDetail": {
"description": "Incorrect address",
"type": "CANCELLED"
},
"timeStamp": "2026-07-20T00:00:00.0Z"
},
{
"consolidationID": "1",
"eventType": "PACKAGE_ADDED_TO_CONSOLIDATION",
"packageCount": 27,
"reasonDetail": {
"description": "Wrong color",
"type": "REJECTED"
},
"timeStamp": "2026-07-18T00:00:00.0Z"
},
{
"consolidationID": "3",
"eventType": "PACKAGE_REMOVED_FROM_CONSOLIDATION",
"packageCount": 31,
"reasonDetail": {
"description": "Wrong color",
"type": "CANCELLED"
},
"timeStamp": "2026-07-21T00:00:00.0Z"
},
{
"consolidationID": "7",
"eventType": "PACKAGE_REMOVED_FROM_CONSOLIDATION",
"packageCount": 5,
"reasonDetail": {
"description": "Incorrect address",
"type": "CANCELLED"
},
"timeStamp": "2026-07-22T00:00:00.0Z"
},
{
"consolidationID": "6",
"eventType": "PACKAGE_ADDED_TO_CONSOLIDATION",
"packageCount": 42,
"reasonDetail": {
"description": "Wrong color",
"type": "CANCELLED"
},
"timeStamp": "2026-07-23T00:00:00.0Z"
}
],
"customDeliveryOptions": [
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2027-03-28T00:00:00.0Z",
"window": [
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2027-02-11T00:00:00.0Z",
"window": [
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "PENDING",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Redirect to hold location",
"requestedAppointmentDetail": {
"date": "2026-08-23T00:00:00.0Z",
"window": [
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2026-10-29T00:00:00.0Z",
"window": [
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
}
]
},
"status": "PENDING",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
},
{
"description": "Signature requirement",
"requestedAppointmentDetail": {
"date": "2026-11-07T00:00:00.0Z",
"window": [
{
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
{
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
}
]
},
"status": "HELD",
"type": "REDIRECT_TO_HOLD_AT_LOCATION"
}
],
"dateAndTimes": [
{
"dateTime": "2026-07-21T00:00:00.0Z",
"type": "ACTUAL_DELIVERY"
},
{
"dateTime": "2026-07-23T00:00:00.0Z",
"type": "ACTUAL_DELIVERY"
},
{
"dateTime": "2026-07-23T00:00:00.0Z",
"type": "ACTUAL_DELIVERY"
},
{
"dateTime": "2026-07-21T00:00:00.0Z",
"type": "ACTUAL_DELIVERY"
}
],
"deliveryDetails": {
"actualDeliveryAddress": {
"city": "West Alanisberg",
"classification": "BUSINESS",
"countryCode": "NG",
"countryName": "Maldives",
"postalCode": "68649-5659",
"residential": false,
"stateOrProvinceCode": "OK",
"streetLines": [
"1043 North Easy Street",
"Suite 999"
]
},
"deliveryAttempts": "2",
"deliveryOptionEligibilityDetails": [
{
"eligibility": "INELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
},
{
"eligibility": "ELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
},
{
"eligibility": "INELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
},
{
"eligibility": "ELIGIBLE",
"option": "INDIRECT_SIGNATURE_RELEASE"
}
],
"deliveryToday": false,
"destinationServiceArea": "agwoA",
"destinationServiceAreaDescription": "Appointment required",
"locationDescription": "Front Desk",
"locationType": "FEDEX_EXPRESS_STATION",
"officeOrderDeliveryMethod": "Shipment",
"receivedByName": "Dr. Mary Glover",
"signedByName": "Daryl Kub"
},
"destinationLocation": {
"locationContactAndAddress": {
"address": {
"city": "West Rosanna",
"classification": "RESIDENTIAL",
"countryCode": "ES",
"postalCode": "14811-1676",
"residential": false,
"stateOrProvinceCode": "NC",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "ORD",
"locationType": "PICKUP_LOCATION"
},
"distanceToDestination": {
"units": "KM",
"value": 674.97
},
"error": {
"code": "TRACKING.TRACKINGNUMBER.EMPTY",
"message": "Please provide tracking number.",
"parameterList": [
{
"key": "identifier",
"value": "dqCkVmFT"
},
{
"key": "param2",
"value": "vc4TpFaB"
},
{
"key": "identifier",
"value": "2Nln6HPr"
},
{
"key": "param1",
"value": "BBeeVDwD"
},
{
"key": "identifier",
"value": "4Ui0AshI"
}
]
},
"estimatedDeliveryTimeWindow": {
"description": "Morning delivery",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-22T00:00:00.0Z",
"ends": "2026-07-23T00:00:00.0Z"
}
},
"goodsClassificationCode": "rES7JX",
"holdAtLocation": {
"locationContactAndAddress": {
"address": {
"city": "Jacobsonside",
"classification": "BUSINESS",
"countryCode": "DK",
"countryName": "Norway",
"postalCode": "55712-4483",
"residential": false,
"stateOrProvinceCode": "HI",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "Stehr - Hegmann",
"personName": "Max Hackett",
"phoneNumber": "(378) 844-7805"
}
},
"locationId": "LAX",
"locationType": "PICKUP_LOCATION"
},
"informationNotes": [
{
"code": "SIGNATURE_REQUIRED",
"description": "Entry fee applies."
},
{
"code": "CLEARANCE_ENTRY_FEE_APPLIES",
"description": "Package requires signature."
},
{
"code": "SIGNATURE_REQUIRED",
"description": "Entry fee applies."
},
{
"code": "SIGNATURE_REQUIRED",
"description": "Package requires signature."
}
],
"lastUpdatedDestinationAddress": {
"city": "Mobile",
"classification": "BUSINESS",
"countryCode": "DO",
"countryName": "Zimbabwe",
"postalCode": "50009-6169",
"residential": false,
"stateOrProvinceCode": "OH",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"latestStatusDetail": {
"ancillaryDetails": [
{
"action": "https://metallic-secret.biz/",
"actionDescription": "Reschedule delivery",
"reason": "1",
"reasonDescription": "Customer not available"
},
{
"action": "https://digital-depot.biz",
"actionDescription": "Reschedule delivery",
"reason": "1",
"reasonDescription": "Refused delivery"
},
{
"action": "https://nice-draft.info",
"actionDescription": "Reschedule delivery",
"reason": "3",
"reasonDescription": "Customer not available"
},
{
"action": "https://vain-programme.biz",
"actionDescription": "Contact us for support",
"reason": "0",
"reasonDescription": "Customer not available"
}
],
"code": "DL",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedCode": "PU",
"description": "In transit",
"scanLocation": {
"city": "Lake Nathanial",
"classification": "BUSINESS",
"countryCode": "TH",
"countryName": "Uruguay",
"postalCode": "33301-8182",
"residential": false,
"stateOrProvinceCode": "UT",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"statusByLocale": "Delivered"
},
"meterNumber": "4",
"originLocation": {
"locationContactAndAddress": {
"address": {
"city": "Greenfield",
"classification": "RESIDENTIAL",
"countryCode": "AZ",
"postalCode": "02266",
"residential": false,
"stateOrProvinceCode": "KS",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "ORD",
"locationType": "PICKUP_LOCATION"
},
"packageDetails": {
"contentPieceCount": "4",
"count": "7",
"declaredValue": {
"currency": "KHR",
"value": 32.92
},
"packageContent": [
"wire hangers",
"buttons"
],
"packagingDescription": {
"description": "FedEx Pak",
"type": "FEDEX_PAK"
},
"physicalPackagingType": "BOX",
"sequenceNumber": "3",
"undeliveredCount": "8",
"weightAndDimensions": {
"dimensions": [
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
},
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
},
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
},
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
},
{
"height": 30,
"length": 100,
"units": "CM",
"width": 50
}
],
"weight": [
{
"unit": "LB",
"value": "6"
},
{
"unit": "LB",
"value": "2"
},
{
"unit": "LB",
"value": "9"
},
{
"unit": "LB",
"value": "9"
},
{
"unit": "LB",
"value": "6"
}
]
}
},
"pieceCounts": [
{
"count": "3",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "8",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "4",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "0",
"description": "Piece count description",
"type": "ORIGIN"
},
{
"count": "7",
"description": "Piece count description",
"type": "ORIGIN"
}
],
"reasonDetail": {
"description": "Incorrect address",
"type": "REJECTED"
},
"recipientInformation": {
"address": {
"city": "South Thea",
"classification": "RESIDENTIAL",
"countryCode": "TF",
"countryName": "Afghanistan",
"postalCode": "87993",
"residential": false,
"stateOrProvinceCode": "OK",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "Swaniawski - Schultz",
"personName": "Jessie Bernier",
"phoneNumber": "(213) 222-1201"
}
},
"returnDetail": {
"authorizationName": "Alexander Daniel",
"reasonDetail": [
{
"description": "Customer request",
"type": "CANCELLED"
}
]
},
"scanEvents": [
{
"date": "2026-07-21T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "Picked up",
"derivedStatusCode": "PU",
"eventDescription": "Departed facility",
"eventType": "DP",
"exceptionCode": "A25",
"exceptionDescription": "None",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "South Aubree",
"classification": "BUSINESS",
"countryCode": "MO",
"postalCode": "18278-1857",
"residential": false,
"stateOrProvinceCode": "TX",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "SEA",
"locationType": "PICKUP_LOCATION"
}
},
{
"date": "2026-07-22T00:00:00.0Z",
"delayDetail": {
"status": "DELAYED",
"subType": "SNOW",
"type": "WEATHER"
},
"derivedStatus": "Picked up",
"derivedStatusCode": "DP",
"eventDescription": "Departed facility",
"eventType": "PU",
"exceptionCode": "A25",
"exceptionDescription": "Clearance delay",
"scanLocation": {
"locationContactAndAddress": {
"address": {
"city": "Beaverton",
"classification": "BUSINESS",
"countryCode": "CD",
"postalCode": "48810-1206",
"residential": false,
"stateOrProvinceCode": "FL",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
}
},
"locationId": "ORD",
"locationType": "PICKUP_LOCATION"
}
}
],
"serviceCommitMessage": {
"message": "No scheduled delivery date available.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"description": "FedEx Ground",
"shortDescription": "FL",
"type": "FEDEX_GROUND"
},
"shipmentDetails": {
"beforePossessionStatus": false,
"contentPieceCount": "8",
"contents": [
{
"description": "Office supplies",
"itemNumber": "zY8GQN",
"partNumber": "D65Ylv",
"receivedQuantity": "5"
},
{
"description": "Electronic parts",
"itemNumber": "ecyOKS",
"partNumber": "AbX9p1",
"receivedQuantity": "5"
},
{
"description": "Electronic parts",
"itemNumber": "fahcvs",
"partNumber": "NFUM9x",
"receivedQuantity": "9"
},
{
"description": "Polyurethane rope",
"itemNumber": "cdCHmH",
"partNumber": "zbVvsG",
"receivedQuantity": "8"
},
{
"description": "Polyurethane rope",
"itemNumber": "kzI6gZ",
"partNumber": "HNFMff",
"receivedQuantity": "2"
}
],
"splitShipments": [
{
"pieceCount": "0",
"statusCode": "cNBk",
"statusDescription": "Pending",
"timestamp": "2026-07-22T00:00:00.0Z"
},
{
"pieceCount": "1",
"statusCode": "lcYZ",
"statusDescription": "Pending",
"timestamp": "2026-07-21T00:00:00.0Z"
}
],
"weight": [
{
"unit": "LB",
"value": "8"
},
{
"unit": "LB",
"value": "2"
},
{
"unit": "LB",
"value": "4"
},
{
"unit": "LB",
"value": "7"
},
{
"unit": "LB",
"value": "0"
}
]
},
"shipperInformation": {
"address": {
"city": "Port Gregorio",
"classification": "RESIDENTIAL",
"countryCode": "MN",
"countryName": "Gambia",
"postalCode": "72134-0469",
"residential": false,
"stateOrProvinceCode": "TN",
"streetLines": {
"0": "1043 North Easy Street",
"1": "Suite 999"
}
},
"contact": {
"companyName": "McKenzie, Hegmann and Walsh",
"personName": "Fannie Schumm-O'Connell",
"phoneNumber": "(602) 735-7817"
}
},
"specialHandlings": [
{
"description": "Deliver Weekday",
"paymentType": "OTHER",
"type": "SATURDAY_DELIVERY"
}
],
"standardTransitTimeWindow": {
"description": "Afternoon window",
"type": "ESTIMATED_DELIVERY",
"window": {
"begins": "2026-07-23T00:00:00.0Z",
"ends": "2026-07-24T00:00:00.0Z"
}
},
"trackingNumberInfo": {
"carrierCode": "FDXE",
"trackingNumber": "7",
"trackingNumberUniqueId": "496259~905109937793~FDEG"
}
}
]
}
],
"cxsErrors": [
{
"code": "TRACKING.NOT_FOUND",
"message": "Tracking number not found.",
"parameterList": [
{
"key": "param1",
"value": "ZnDbkJFJ"
},
{
"key": "param1",
"value": "IdYVfLSC"
}
]
},
{
"code": "TRACKING.NOT_FOUND",
"message": "Please provide tracking number.",
"parameterList": [
{
"key": "param2",
"value": "5LXQlR3t"
},
{
"key": "identifier",
"value": "TkTHCweY"
},
{
"key": "param1",
"value": "N2HEkECP"
}
]
},
{
"code": "TRACKING.TRACKINGNUMBER.EMPTY",
"message": "Please provide tracking number.",
"parameterList": [
{
"key": "param2",
"value": "q9CDi8Vj"
}
]
},
{
"code": "TRACKING.AUTH.INVALID",
"message": "Tracking number not found.",
"parameterList": [
{
"key": "param2",
"value": "mNMRA8a2"
},
{
"key": "param1",
"value": "ua63pAgr"
}
]
}
],
"successful": false
},
"transactionId": "50c78b57-0d4b-4e1a-960e-71837fc728f6"
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"errors": [
{
"code": "TRACKING.TRACKINGNUMBER.EMPTY",
"message": "Please provide tracking number."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "NOT.AUTHORIZED.ERROR",
"message": "Access token expired. Please modify your request and try again."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "FORBIDDEN.ERROR",
"message": "We could not authorize your credentials. Please check your permissions and try again."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "NOT.FOUND.ERROR",
"message": "The resource you requested is no longer available. Please modify your request and try again."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"errors": [
{
"code": "INTERNAL.SERVER.ERROR",
"message": "We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"errors": [
{
"code": "SERVICE.UNAVAILABLE.ERROR",
"message": "The service is currently unavailable and we are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
}
]
}Service Homepage: developer.fedex.com/api/en-us/catalog/track/v1/docs.html
fedexlogisticstrackingshippingrest