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_order607068105",
"output": {
"countryDetails": {
"category": "Documentation",
"countryCode": "TZ",
"shipmentDetails": {
"commodityIndex": 8,
"level": "ERROR",
"regulatoryCountryAdvisories": {
"messages": [
{
"code": "9",
"localizedText": "Exonération de droits non applicable",
"parameters": [
{
"id": "4",
"value": "Exempt"
},
{
"id": "8",
"value": "Exempt"
},
{
"id": "6",
"value": "Exempt"
}
],
"text": "Duty Exemption Not Applicable"
},
{
"code": "2",
"localizedText": "Documentation requise",
"parameters": [
{
"id": "0",
"value": "Required"
}
],
"text": "Duty Exemption Not Applicable"
}
],
"types": "RESTRICTION"
},
"regulatoryDocuments": {
"agencyName": "Customs",
"agencyUrl": "https://filthy-nectarine.info/",
"allowability": "REQUIRED",
"documentType": "CERTIFICATE_OF_ORIGIN",
"documentUrl": "https://crooked-giggle.name/",
"fileName": "drab_which_confused.[object Object]",
"id": "TwMnh5uzn-Dw",
"localizedAttributes": {
"description": "Professional-grade Mouse perfect for insidious training and recreational use",
"localization": {
"localeCode": "ca",
"localization": "ZH"
},
"name": "Practical Marble Pants"
},
"supportType": "FEDEX_GENERATED",
"userMessage": {
"code": "1",
"index": 13,
"localizedText": "Le poids de la marchandise dépasse les limites de l'expédition standard.",
"messageParameters": [
{
"id": "3",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "irure laboris tempor deserunt ex"
}
},
"regulatoryStatements": {
"agencyName": "Export Administration",
"agencyUrl": "https://lonely-trick.biz/",
"allowability": "REQUIRED",
"completionType": "REQUIRES_COMPLETION",
"documentIds": [
"DOC010",
"DOC003",
"DOC001"
],
"documentUrl": "https://trained-poetry.org",
"fileName": "shanghai.[object Object]",
"id": "YdK6-95U9W8T",
"localizedAttributes": {
"description": "The sleek and chubby Bike comes with yellow LED lighting for smart functionality",
"localization": {
"localeCode": "ca",
"localization": "FR"
},
"name": "Frozen Bamboo Bike"
},
"statementUrl": "https://married-switch.net",
"supportType": "FILLABLE",
"userMessage": {
"code": "0",
"index": 26,
"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": "5",
"value": "Country of manufacture information is missing."
}
],
"text": "eu"
}
},
"requiredCommodityUnitsOfMeasure": [
"LIT",
"MTR"
]
}
},
"cxsalerts": [
{
"alertType": "WARNING",
"code": "ALERT_01",
"message": "Customs clearance notice",
"parameterList": [
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
}
]
}
],
"userMessages": [
{
"code": "3",
"index": 19,
"localizedText": "La valeur de l'envoi doit être fournie pour la couverture d'assurance.",
"messageParameters": [
{
"id": "7",
"value": "Shipment value must be provided for insurance coverage."
},
{
"id": "5",
"value": "Declaration of contents needed for customs clearance."
},
{
"id": "0",
"value": "Country of manufacture information is missing."
},
{
"id": "9",
"value": "Country of manufacture information is missing."
},
{
"id": "6",
"value": "Shipping instructions unclear for perishable items."
}
],
"text": "eu"
},
{
"code": "1",
"index": 2,
"localizedText": "Le poids de la marchandise dépasse les limites de l'expédition standard.",
"messageParameters": [
{
"id": "4",
"value": "Weight of commodity exceeds limits for standard shipping."
},
{
"id": "2",
"value": "Weight of commodity exceeds limits for standard shipping."
}
],
"text": "veniam officia proident"
},
{
"code": "2",
"index": 16,
"localizedText": "Selon les informations fournies sur l'envoi, seul le type de produit / document est autorisé pour cet envoi",
"messageParameters": [
{
"id": "1",
"value": "Shipment value must be provided for insurance coverage."
},
{
"id": "0",
"value": "Harmonized code required for international shipping."
},
{
"id": "8",
"value": "Weight of commodity exceeds limits for standard shipping."
},
{
"id": "9",
"value": "Weight of commodity exceeds limits for standard shipping."
}
],
"text": "fugiat do elit"
}
]
},
"transactionId": "1b3a5ecc-75cf-485d-b03a-4a23ee345e89"
}{
"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": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
}
],
"transactionId": "947adfda-b231-44b7-9267-20b581aea6a7"
}{
"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": "ignoreWarnings",
"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": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"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": "FALSE"
}
]
}
],
"transactionId": "923fd5aa-2bb2-4833-b864-58627a0eb142"
}{
"errors": [
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
},
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
},
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
}
]
},
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
},
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
}
]
}
],
"transactionId": "ad2eef39-cafc-47db-817b-1d26fa78ed80"
}{
"customerTransactionId": "AnyCo_order164671713",
"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": "FALSE"
},
{
"key": "forceValidation",
"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": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"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": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"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": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"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": "forceValidation",
"value": "TRUE"
}
]
}
],
"transactionId": "3106b030-ee66-4a8e-994f-1584900bbee4"
}Service Homepage: developer.fedex.com/api/en-us/catalog/global-trade/v1/docs.html
fedexlogisticsshippingglobal-tradecustoms