Traffic Parrot FedEx Integration Guide
AUTHORIZATIONOAuth 2.0
POSTAPI Authorization
https://apis-sandbox.fedex.com/oauth/token
HEADERS
Content-Type
application/x-www-form-urlencoded
Bodyurlencoded
grant_type
client_credentials
client_id
•••••••
client_secret
•••••••
Example Request
API Authorization
curl
curl --location 'https://apis-sandbox.fedex.com/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=•••••••' \
--data-urlencode 'client_secret=•••••••'Example Response
No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers
POSTTrack By Tracking Number
https://apis-sandbox.fedex.com/track/v1/trackingnumbers
AUTHORIZATIONOAuth 2.0
This request is using OAuth 2.0 from collectionTraffic Parrot FedEx Integration Guide
HEADERS
x-customer-transaction-id
d1c3f495-f1a0-4e76-b6ae-13e9bc3fa056
x-locale
en_US
Content-Type
application/json; charset=utf-8
Bodyraw (json)
json
{
"trackingInfo": [
{
"trackingNumberInfo": {
"trackingNumber": "123456789012"
}
}
],
"includeDetailedScans": true
}Example Request
Successful tracking
curl
curl --location 'https://apis-sandbox.fedex.com/track/v1/trackingnumbers' \
--header 'x-customer-transaction-id: 290a9172-f5a3-4fdb-86db-1c8e70c82635' \
--header 'x-locale: en_US' \
--header 'Content-Type: application/json; charset=utf-8' \
--data '{
"trackingInfo": [
{
"trackingNumberInfo": {
"trackingNumber": "123456789012"
}
}
],
"includeDetailedScans": true
}'200 OK
Example Response
json
{
"transactionId": "41581e2f-7d24-4799-ac9c-fa6b6580b040",
"customerTransactionId": "b8da7f74-e594-41eb-9b59-dff09ee900f1",
"output": {
"completeTrackResults": [
{
"trackingNumber": "123456789012",
"trackResults": [
{
"trackingNumberInfo": {
"trackingNumber": "123456789012",
"trackingNumberUniqueId": "~123456789012~FDFR",
"carrierCode": "FXFR"
},
"additionalTrackingInfo": {
"nickname": "",
"packageIdentifiers": [
{
"type": "PURCHASE_ORDER",
"values": [
"54321"
],
"trackingNumberUniqueId": "",
"carrierCode": ""
}
],
"hasAssociatedShipments": false
},
"recipientInformation": {
"address": {
"residential": false
}
},
"latestStatusDetail": {
"code": "OC",
"derivedCode": "IN",
"statusByLocale": "Initiated",
"description": "Shipment information sent to FedEx",
"scanLocation": {
"residential": false
},
"ancillaryDetails": [
{
"reason": "IN001",
"reasonDescription": "Please check back later for shipment status or subscribe for e-mail notifications",
"action": "",
"actionDescription": ""
}
]
},
"availableImages": [
{
"type": "SIGNATURE_PROOF_OF_DELIVERY",
"size": "LARGE"
},
{
"type": "BILL_OF_LADING"
}
],
"packageDetails": {
"packagingDescription": {
"type": ""
},
"sequenceNumber": "1",
"count": "1",
"contentPieceCount": "10",
"weightAndDimensions": {
"weight": [
{
"value": "2000.0",
"unit": "LB"
},
{
"value": "907.18",
"unit": "KG"
}
]
},
"packageContent": []
},
"shipmentDetails": {
"possessionStatus": false,
"contentPieceCount": "1",
"weight": [
{
"value": "1.0",
"unit": "LB"
},
{
"value": "0.45",
"unit": "KG"
}
]
},
"scanEvents": [
{
"date": "2019-12-09T07:50:11-06:00",
"eventType": "OC",
"eventDescription": "Shipment information sent to FedEx",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"residential": false
},
"locationType": "CUSTOMER",
"derivedStatusCode": "IN",
"derivedStatus": "Initiated"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION",
"ON_ESTIMATED_DELIVERY",
"ON_TENDER"
],
"deliveryDetails": {
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"option": "INDIRECT_SIGNATURE_RELEASE",
"eligibility": "INELIGIBLE"
},
{
"option": "REDIRECT_TO_HOLD_AT_LOCATION",
"eligibility": "INELIGIBLE"
},
{
"option": "REROUTE",
"eligibility": "INELIGIBLE"
},
{
"option": "RESCHEDULE",
"eligibility": "INELIGIBLE"
},
{
"option": "RETURN_TO_SHIPPER",
"eligibility": "INELIGIBLE"
},
{
"option": "DISPUTE_DELIVERY",
"eligibility": "INELIGIBLE"
},
{
"option": "SUPPLEMENT_ADDRESS",
"eligibility": "INELIGIBLE"
}
],
"destinationServiceAreaDescription": "Appointment required"
},
"serviceDetail": {
"type": "FEDEX_FREIGHT_PRIORITY",
"description": "",
"shortDescription": ""
},
"standardTransitTimeWindow": {
"window": {}
},
"estimatedDeliveryTimeWindow": {
"window": {}
},
"goodsClassificationCode": "",
"returnDetail": {}
},
{
"trackingNumberInfo": {
"trackingNumber": "123456789012",
"trackingNumberUniqueId": "12021~123456789012~FDEG",
"carrierCode": "FDXG"
},
"additionalTrackingInfo": {
"nickname": "",
"hasAssociatedShipments": false
},
"shipperInformation": {
"address": {
"city": "SAINT-LAURENT",
"stateOrProvinceCode": "PQ",
"countryCode": "CA",
"residential": false,
"countryName": "Canada"
}
},
"latestStatusDetail": {
"code": "FD",
"derivedCode": "IT",
"statusByLocale": "In transit",
"description": "At FedEx destination facility",
"scanLocation": {
"city": "LADSON",
"stateOrProvinceCode": "SC",
"countryCode": "US",
"residential": false,
"countryName": "United States"
},
"delayDetail": {
"status": "ON_TIME"
}
},
"availableImages": [],
"packageDetails": {
"packagingDescription": {
"type": "YOUR_PACKAGING",
"description": "Package"
},
"physicalPackagingType": "PACKAGE",
"sequenceNumber": "1",
"count": "1"
},
"shipmentDetails": {
"possessionStatus": true
},
"scanEvents": [
{
"date": "2021-09-15T03:56:00-04:00",
"eventType": "AR",
"eventDescription": "At local FedEx facility",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"city": "LADSON",
"stateOrProvinceCode": "SC",
"postalCode": "29456",
"countryCode": "US",
"residential": false,
"countryName": "United States"
},
"locationId": "0294",
"locationType": "DESTINATION_FEDEX_FACILITY",
"derivedStatusCode": "IT",
"derivedStatus": "In transit"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION",
"ON_ESTIMATED_DELIVERY"
],
"deliveryDetails": {
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"option": "INDIRECT_SIGNATURE_RELEASE",
"eligibility": "INELIGIBLE"
},
{
"option": "REDIRECT_TO_HOLD_AT_LOCATION",
"eligibility": "INELIGIBLE"
},
{
"option": "REROUTE",
"eligibility": "INELIGIBLE"
},
{
"option": "RESCHEDULE",
"eligibility": "INELIGIBLE"
},
{
"option": "RETURN_TO_SHIPPER",
"eligibility": "INELIGIBLE"
},
{
"option": "DISPUTE_DELIVERY",
"eligibility": "INELIGIBLE"
},
{
"option": "SUPPLEMENT_ADDRESS",
"eligibility": "INELIGIBLE"
}
],
"destinationServiceArea": "EDDUNAVAILABLE"
},
"serviceCommitMessage": {
"message": "No scheduled delivery date available at this time.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"type": "GROUND_HOME_DELIVERY",
"description": "FedEx Home Delivery",
"shortDescription": "HD"
},
"standardTransitTimeWindow": {
"window": {}
},
"estimatedDeliveryTimeWindow": {
"window": {}
},
"goodsClassificationCode": "",
"returnDetail": {}
},
{
"trackingNumberInfo": {
"trackingNumber": "123456789012",
"trackingNumberUniqueId": "12023~123456789012~FDEG",
"carrierCode": "FDXG"
},
"additionalTrackingInfo": {
"nickname": "",
"hasAssociatedShipments": false
},
"shipperInformation": {
"address": {
"residential": false
}
},
"latestStatusDetail": {
"code": "FD",
"derivedCode": "IT",
"statusByLocale": "In transit",
"description": "At FedEx destination facility",
"scanLocation": {
"city": "BRIDGEPORT",
"stateOrProvinceCode": "WV",
"countryCode": "US",
"residential": false,
"countryName": "United States"
},
"delayDetail": {
"status": "ON_TIME"
}
},
"availableImages": [],
"packageDetails": {
"packagingDescription": {
"type": "YOUR_PACKAGING",
"description": "Package"
},
"physicalPackagingType": "PACKAGE",
"sequenceNumber": "1",
"count": "1"
},
"shipmentDetails": {
"possessionStatus": true
},
"scanEvents": [
{
"date": "2022-04-21T05:54:00-04:00",
"eventType": "AR",
"eventDescription": "At local FedEx facility",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"city": "BRIDGEPORT",
"stateOrProvinceCode": "WV",
"postalCode": "26330",
"countryCode": "US",
"residential": false,
"countryName": "United States"
},
"locationId": "0263",
"locationType": "DESTINATION_FEDEX_FACILITY",
"derivedStatusCode": "IT",
"derivedStatus": "In transit"
},
{
"date": "2022-04-12T05:40:00-04:00",
"eventType": "AR",
"eventDescription": "At local FedEx facility",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"city": "BRIDGEPORT",
"stateOrProvinceCode": "WV",
"postalCode": "26330",
"countryCode": "US",
"residential": false,
"countryName": "United States"
},
"locationId": "0263",
"locationType": "DESTINATION_FEDEX_FACILITY",
"derivedStatusCode": "IT",
"derivedStatus": "In transit"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION",
"ON_ESTIMATED_DELIVERY"
],
"deliveryDetails": {
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"option": "INDIRECT_SIGNATURE_RELEASE",
"eligibility": "INELIGIBLE"
},
{
"option": "REDIRECT_TO_HOLD_AT_LOCATION",
"eligibility": "INELIGIBLE"
},
{
"option": "REROUTE",
"eligibility": "INELIGIBLE"
},
{
"option": "RESCHEDULE",
"eligibility": "INELIGIBLE"
},
{
"option": "RETURN_TO_SHIPPER",
"eligibility": "INELIGIBLE"
},
{
"option": "DISPUTE_DELIVERY",
"eligibility": "INELIGIBLE"
},
{
"option": "SUPPLEMENT_ADDRESS",
"eligibility": "INELIGIBLE"
}
],
"destinationServiceArea": "EDDUNAVAILABLE"
},
"serviceCommitMessage": {
"message": "No scheduled delivery date available at this time.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"type": "SMART_POST",
"description": "FedEx SmartPost",
"shortDescription": "SP"
},
"standardTransitTimeWindow": {
"window": {}
},
"estimatedDeliveryTimeWindow": {
"window": {}
},
"goodsClassificationCode": "",
"returnDetail": {}
},
{
"trackingNumberInfo": {
"trackingNumber": "123456789012",
"trackingNumberUniqueId": "2459408000~123456789012~FX",
"carrierCode": "FDXE"
},
"additionalTrackingInfo": {
"nickname": "",
"hasAssociatedShipments": false
},
"shipperInformation": {
"address": {
"residential": false
}
},
"recipientInformation": {
"address": {
"residential": false
}
},
"latestStatusDetail": {
"code": "PU",
"derivedCode": "PU",
"statusByLocale": "Picked up",
"description": "Picked up",
"scanLocation": {
"city": "AHMEDABAD",
"stateOrProvinceCode": "GJ",
"countryCode": "IN",
"residential": false,
"countryName": "India"
},
"delayDetail": {
"status": "DELAYED"
}
},
"dateAndTimes": [
{
"type": "ACTUAL_PICKUP",
"dateTime": "2021-07-12T14:10:00+05:30"
},
{
"type": "SHIP",
"dateTime": "2021-07-12T00:00:00-06:00"
},
{
"type": "ACTUAL_TENDER",
"dateTime": "2021-07-12T14:10:00+05:30"
}
],
"availableImages": [],
"specialHandlings": [
{
"type": "DELIVER_WEEKDAY",
"description": "Deliver Weekday",
"paymentType": "OTHER"
}
],
"packageDetails": {
"packagingDescription": {
"type": "FEDEX_ENVELOPE",
"description": "FedEx Envelope"
}
},
"shipmentDetails": {
"possessionStatus": true
},
"scanEvents": [
{
"date": "2021-07-12T14:10:00+05:30",
"eventType": "PU",
"eventDescription": "Picked up",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"city": "AHMEDABAD",
"stateOrProvinceCode": "GJ",
"postalCode": "380059",
"countryCode": "IN",
"residential": false,
"countryName": "India"
},
"locationId": "AMDA",
"locationType": "PICKUP_LOCATION",
"derivedStatusCode": "PU",
"derivedStatus": "Picked up"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION",
"ON_ESTIMATED_DELIVERY"
],
"deliveryDetails": {
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"option": "INDIRECT_SIGNATURE_RELEASE",
"eligibility": "INELIGIBLE"
},
{
"option": "REDIRECT_TO_HOLD_AT_LOCATION",
"eligibility": "INELIGIBLE"
},
{
"option": "REROUTE",
"eligibility": "INELIGIBLE"
},
{
"option": "RESCHEDULE",
"eligibility": "INELIGIBLE"
},
{
"option": "RETURN_TO_SHIPPER",
"eligibility": "INELIGIBLE"
},
{
"option": "DISPUTE_DELIVERY",
"eligibility": "INELIGIBLE"
},
{
"option": "SUPPLEMENT_ADDRESS",
"eligibility": "INELIGIBLE"
}
],
"destinationServiceArea": "EDDUNAVAILABLE"
},
"originLocation": {
"locationContactAndAddress": {
"address": {
"city": "AHMEDABAD",
"stateOrProvinceCode": "GJ",
"countryCode": "IN",
"residential": false,
"countryName": "India"
}
},
"locationId": "AMDA"
},
"destinationLocation": {
"locationContactAndAddress": {
"address": {
"residential": false
}
},
"locationType": ""
},
"lastUpdatedDestinationAddress": {
"countryCode": "IN",
"residential": false,
"countryName": "India"
},
"serviceCommitMessage": {
"message": "No scheduled delivery date available at this time.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"type": "PRIORITY_OVERNIGHT",
"description": "FedEx Priority Overnight",
"shortDescription": "P-1"
},
"standardTransitTimeWindow": {
"window": {
"ends": "2021-07-13T20:00:00+05:30"
}
},
"estimatedDeliveryTimeWindow": {
"window": {}
},
"goodsClassificationCode": "",
"returnDetail": {}
},
{
"trackingNumberInfo": {
"trackingNumber": "123456789012",
"trackingNumberUniqueId": "2459689000~123456789012~FX",
"carrierCode": "FDXE"
},
"additionalTrackingInfo": {
"nickname": "",
"hasAssociatedShipments": false
},
"shipperInformation": {
"contact": {},
"address": {
"city": "Higashiyamato-Shi",
"countryCode": "JP",
"residential": false,
"countryName": "Japan"
}
},
"recipientInformation": {
"contact": {},
"address": {
"city": "Toronto",
"stateOrProvinceCode": "ON",
"countryCode": "CA",
"residential": false,
"countryName": "Canada"
}
},
"latestStatusDetail": {
"code": "DO",
"derivedCode": "DO",
"statusByLocale": "Dropped off",
"description": "Dropped Off",
"scanLocation": {
"city": "MILAN",
"countryCode": "IT",
"residential": false,
"countryName": "Italy"
},
"delayDetail": {
"status": "ON_TIME"
}
},
"dateAndTimes": [
{
"type": "ANTICIPATED_TENDER",
"dateTime": "2022-04-19T00:00:00-06:00"
}
],
"availableImages": [],
"specialHandlings": [
{
"type": "DELIVER_WEEKDAY",
"description": "Deliver Weekday",
"paymentType": "OTHER"
},
{
"type": "BROKER_SELECT_OPTION",
"description": "Broker Select Option",
"paymentType": "OTHER"
}
],
"packageDetails": {
"packagingDescription": {
"type": "YOUR_PACKAGING",
"description": "Your Packaging"
},
"sequenceNumber": "1",
"count": "1",
"weightAndDimensions": {
"weight": [
{
"value": "80.0",
"unit": "KG"
},
{
"value": "176.37",
"unit": "LB"
}
],
"dimensions": [
{
"length": 120,
"width": 60,
"height": 71,
"units": "CM"
},
{
"length": 47,
"width": 23,
"height": 27,
"units": "IN"
}
]
},
"packageContent": []
},
"shipmentDetails": {
"possessionStatus": true,
"weight": [
{
"value": "80.0",
"unit": "KG"
},
{
"value": "176.37",
"unit": "LB"
}
]
},
"scanEvents": [
{
"date": "2022-04-29T11:15:00+02:00",
"eventType": "DO",
"eventDescription": "Dropped off at FedEx OnSite",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"city": "MILAN",
"postalCode": "20124",
"countryCode": "IT",
"residential": false,
"countryName": "Italy"
},
"locationId": "MILYD",
"locationType": "NON_FEDEX_FACILITY",
"derivedStatusCode": "DO",
"derivedStatus": "Dropped off"
},
{
"date": "2022-04-18T20:35:54-05:00",
"eventType": "CA",
"eventDescription": "Shipment cancelled by sender",
"exceptionCode": "",
"exceptionDescription": "",
"scanLocation": {
"streetLines": [
""
],
"residential": false
},
"locationType": "CUSTOMER",
"derivedStatusCode": "CA",
"derivedStatus": "Cancelled"
}
],
"availableNotifications": [
"ON_DELIVERY",
"ON_EXCEPTION",
"ON_ESTIMATED_DELIVERY"
],
"deliveryDetails": {
"deliveryAttempts": "0",
"deliveryOptionEligibilityDetails": [
{
"option": "INDIRECT_SIGNATURE_RELEASE",
"eligibility": "INELIGIBLE"
},
{
"option": "REDIRECT_TO_HOLD_AT_LOCATION",
"eligibility": "INELIGIBLE"
},
{
"option": "REROUTE",
"eligibility": "INELIGIBLE"
},
{
"option": "RESCHEDULE",
"eligibility": "INELIGIBLE"
},
{
"option": "RETURN_TO_SHIPPER",
"eligibility": "INELIGIBLE"
},
{
"option": "DISPUTE_DELIVERY",
"eligibility": "INELIGIBLE"
},
{
"option": "SUPPLEMENT_ADDRESS",
"eligibility": "INELIGIBLE"
}
],
"destinationServiceArea": "EDDUNAVAILABLE"
},
"originLocation": {
"locationContactAndAddress": {
"address": {
"city": "FUCHU-SHI TOKYO",
"countryCode": "JP",
"residential": false,
"countryName": "Japan"
}
},
"locationId": "OKOA"
},
"destinationLocation": {
"locationContactAndAddress": {
"address": {
"city": "Toronto",
"stateOrProvinceCode": "ON",
"countryCode": "CA",
"residential": false,
"countryName": "Canada"
}
},
"locationType": ""
},
"lastUpdatedDestinationAddress": {
"city": "TORONTO",
"stateOrProvinceCode": "ON",
"countryCode": "CA",
"residential": false,
"countryName": "Canada"
},
"serviceCommitMessage": {
"message": "No scheduled delivery date available at this time.",
"type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
},
"serviceDetail": {
"type": "INTERNATIONAL_PRIORITY_FREIGHT",
"description": "FedEx International Priority Freight",
"shortDescription": "IPFS"
},
"standardTransitTimeWindow": {
"window": {}
},
"estimatedDeliveryTimeWindow": {
"window": {}
},
"goodsClassificationCode": "",
"returnDetail": {}
}
]
}
]
}
}X-API-Mode
Sandbox
Content-Encoding
gzip
Content-Type
application/json
Content-Length
2472
Server
Layer7-API-Gateway
Date
Wed, 04 May 2022 13:09:23 GMT
Connection
keep-alive
Vary
Accept-Encoding
Server-Timing
cdn-cache; desc=MISS
Server-Timing
edge; dur=51
Server-Timing
origin; dur=293