FedEx Global Trade Virtual Sandbox
Virtual API for managing international shipping regulatory details and trade documentation.
The FedEx Global Trade API provides tools to retrieve regulatory details for international shipments. This virtual endpoint allows developers to prototype workflows for customs documentation, commodity classification, and trade compliance checks without hitting production systems.
Use this hosted sandbox to simulate FedEx Global Trade 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 international shipment regulatory payloads, verify commodity-specific documentation requirements, test customs data mapping, and handle error responses for invalid trade codes or missing shipment details.
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" |
{
"carrierCode": "FDXE",
"customsClearanceDetail": {
"commodities": [
{
"harmonizedCode": "580122"
}
],
"customsValue": {
"amount": "",
"currency": ""
}
},
"destinationAddress": {
"countryCode": "CA"
},
"originAddress": {
"countryCode": "IN"
}
}{
"customerTransactionId": "AnyCo_order862316098",
"output": {
"countryDetails": {
"category": "Documentation",
"countryCode": "ZW",
"shipmentDetails": {
"commodityIndex": 3,
"level": "INFO",
"regulatoryCountryAdvisories": {
"messages": [
{
"code": "3",
"localizedText": "Exonération de droits non applicable",
"parameters": [
{
"id": "6",
"value": "Exempt"
},
{
"id": "3",
"value": "Required"
},
{
"id": "5",
"value": "Restricted"
},
{
"id": "5",
"value": "Restricted"
},
{
"id": "7",
"value": "Required"
}
],
"text": "Duty Exemption Not Applicable"
},
{
"code": "8",
"localizedText": "Les restrictions d'importation s'appliquent",
"parameters": [
{
"id": "4",
"value": "Exempt"
},
{
"id": "7",
"value": "Restricted"
},
{
"id": "6",
"value": "Restricted"
},
{
"id": "5",
"value": "Required"
},
{
"id": "5",
"value": "Restricted"
}
],
"text": "Duty Exemption Not Applicable"
}
],
"types": "RESTRICTION"
},
"regulatoryDocuments": {
"agencyName": "Environmental Agency",
"agencyUrl": "https://informal-lifestyle.org/",
"allowability": "PROHIBITED",
"documentType": "EEI_FILING",
"documentUrl": "https://qualified-excess.name",
"fileName": "tentacle_candid_electric.[object Object]",
"id": "MznMOVPxHM",
"localizedAttributes": {
"description": "Innovative Chicken featuring imaginative technology and Cotton construction",
"localization": {
"localeCode": "fr",
"localization": "ES"
},
"name": "Sleek Rubber Keyboard"
},
"supportType": "FILLABLE",
"userMessage": {
"code": "3",
"index": 9,
"localizedText": "Selon les informations fournies sur l'envoi, seul le type de produit / document est autorisé pour cet envoi",
"messageParameters": [
{
"id": "9",
"value": "Based on shipment information provided, only non-document/commodity type is permitted for this shipment"
},
{
"id": "7",
"value": "Shipment value must be provided for insurance coverage."
},
{
"id": "3",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "laborum magna"
}
},
"regulatoryStatements": {
"agencyName": "Export Administration",
"agencyUrl": "https://blank-creator.org/",
"allowability": "OPTIONAL",
"completionType": "REQUIRES_COMPLETION",
"documentIds": [
"DOC004",
"DOC008",
"DOC005",
"DOC003",
"DOC002"
],
"documentUrl": "https://hospitable-humor.com",
"fileName": "qualified.[object Object]",
"id": "ukdfxzUnwt",
"localizedAttributes": {
"description": "Our koala-friendly Chicken ensures triangular comfort for your pets",
"localization": {
"localeCode": "ca",
"localization": "IT"
},
"name": "Tasty Plastic Sausages"
},
"statementUrl": "https://self-assured-moment.info",
"supportType": "SAMPLE",
"userMessage": {
"code": "3",
"index": 24,
"localizedText": "Selon les informations fournies sur l'envoi, seul le type de produit / document est autorisé pour cet envoi",
"messageParameters": [
{
"id": "8",
"value": "Contact information for recipient is missing."
},
{
"id": "2",
"value": "Weight of commodity exceeds limits for standard shipping."
},
{
"id": "7",
"value": "Harmonized code required for international shipping."
},
{
"id": "8",
"value": "Country of manufacture information is missing."
},
{
"id": "7",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "labore veniam"
}
},
"requiredCommodityUnitsOfMeasure": [
"PCS",
"DZN",
"MTR",
"LIT"
]
}
},
"cxsalerts": [
{
"alertType": "WARNING",
"code": "ALERT_02",
"message": "Service maintenance alert",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"alertType": "NOTE",
"code": "ALERT_03",
"message": "Customs clearance notice",
"parameterList": [
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"alertType": "NOTE",
"code": "ALERT_01",
"message": "Service maintenance alert",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"alertType": "WARNING",
"code": "ALERT_02",
"message": "Customs clearance notice",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
}
],
"userMessages": [
{
"code": "9",
"index": 31,
"localizedText": "Le code harmonisé est requis pour l'expédition internationale.",
"messageParameters": [
{
"id": "6",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "sunt fugiat proident ad"
},
{
"code": "6",
"index": 34,
"localizedText": "Le code harmonisé est requis pour l'expédition internationale.",
"messageParameters": [
{
"id": "4",
"value": "Based on shipment information provided, only non-document/commodity type is permitted for this shipment"
},
{
"id": "9",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "magna consequat dolore proident ex"
},
{
"code": "7",
"index": 33,
"localizedText": "Les informations sur le pays de fabrication sont manquantes.",
"messageParameters": [
{
"id": "8",
"value": "Package dimensions required for freight calculation."
}
],
"text": "est nisi proident pariatur consectetur"
}
]
},
"transactionId": "21816902-38fd-422b-83b9-ae9c04c02ad9"
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"customerTransactionId": "AnyCo_order123456789",
"errors": [
{
"code": "SYSTEM.GENERAL.ERROR",
"message": "We are unable to process this request for the moment. Try again later or contact FedEx Customer Service."
}
]
}{
"errors": [
{
"code": "NOT.AUTHORIZED.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: Access token expired. Please modify your request and try again."
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"code": "NOT.AUTHORIZED.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: Access token expired. Please modify your request and try again."
},
"parameterList": [
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
},
{
"code": "NOT.AUTHORIZED.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: Access token expired. Please modify your request and try again."
},
"parameterList": [
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
},
{
"code": "NOT.AUTHORIZED.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: Access token expired. Please modify your request and try again."
},
"parameterList": [
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
}
],
"transactionId": "33cd1648-6878-4d5c-8fdd-a7a78e1d521e"
}{
"errors": [
{
"code": "NOT.FOUND.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: The resource you requested is no longer available. Please modify your request and try again."
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
},
{
"code": "NOT.FOUND.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: The resource you requested is no longer available. Please modify your request and try again."
},
"parameterList": [
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
}
]
}
],
"transactionId": "8e6cb853-94aa-4f43-8976-5e02fe1105f5"
}{
"errors": [
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
}
],
"transactionId": "d11ee430-3a1b-4513-9d7c-2d4a35d00715"
}{
"customerTransactionId": "AnyCo_order355359737",
"errors": [
{
"code": "INTERNAL.SERVER.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
},
{
"code": "INTERNAL.SERVER.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"code": "INTERNAL.SERVER.ERROR",
"message": {
"description": "Indicates the description of API error alert message.<br>Example: We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
}
],
"transactionId": "71efc8d3-94a2-4d16-a414-16af1e328a11"
}Service Homepage: developer.fedex.com/api/en-us/catalog/global-trade/v1/docs.html
fedexlogisticsshippingglobal-tradecustoms