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_order453648638",
"output": {
"countryDetails": {
"category": "Regulatory",
"countryCode": "HM",
"shipmentDetails": {
"commodityIndex": 2,
"level": "INFO",
"regulatoryCountryAdvisories": {
"messages": [
{
"code": "8",
"localizedText": "Exonération de droits non applicable",
"parameters": [
{
"id": "5",
"value": "Required"
},
{
"id": "9",
"value": "Exempt"
},
{
"id": "0",
"value": "Required"
},
{
"id": "4",
"value": "Exempt"
},
{
"id": "1",
"value": "Exempt"
}
],
"text": "Documentation Required"
},
{
"code": "9",
"localizedText": "Documentation requise",
"parameters": [
{
"id": "4",
"value": "Required"
},
{
"id": "1",
"value": "Exempt"
}
],
"text": "Documentation Required"
},
{
"code": "3",
"localizedText": "Exonération de droits non applicable",
"parameters": [
{
"id": "8",
"value": "Restricted"
},
{
"id": "6",
"value": "Required"
},
{
"id": "8",
"value": "Required"
}
],
"text": "Duty Exemption Not Applicable"
},
{
"code": "4",
"localizedText": "Documentation requise",
"parameters": [
{
"id": "3",
"value": "Restricted"
},
{
"id": "1",
"value": "Restricted"
},
{
"id": "0",
"value": "Required"
},
{
"id": "6",
"value": "Restricted"
}
],
"text": "Duty Exemption Not Applicable"
},
{
"code": "1",
"localizedText": "Exonération de droits non applicable",
"parameters": [
{
"id": "8",
"value": "Exempt"
}
],
"text": "Duty Exemption Not Applicable"
}
],
"types": "RESTRICTION"
},
"regulatoryDocuments": {
"agencyName": "Environmental Agency",
"agencyUrl": "https://warlike-citizen.biz",
"allowability": "PROHIBITED",
"documentType": "PACKING_LIST",
"documentUrl": "https://left-submitter.org/",
"fileName": "than_regarding_absentmindedly.[object Object]",
"id": "mztQSoC7Ks",
"localizedAttributes": {
"description": "Handmade Salad designed with Granite for supportive performance",
"localization": {
"localeCode": "fr",
"localization": "EN"
},
"name": "Tasty Cotton Car"
},
"supportType": "SAMPLE",
"userMessage": {
"code": "1",
"index": 38,
"localizedText": "La description de la marchandise est trop vague.",
"messageParameters": [
{
"id": "1",
"value": "Declaration of contents needed for customs clearance."
},
{
"id": "8",
"value": "Based on shipment information provided, only non-document/commodity type is permitted for this shipment"
},
{
"id": "4",
"value": "Shipment value must be provided for insurance coverage."
}
],
"text": "dolor"
}
},
"regulatoryStatements": {
"agencyName": "FDA",
"agencyUrl": "https://reflecting-sideboard.com",
"allowability": "PROHIBITED",
"completionType": "REQUIRES_COMPLETION",
"documentIds": [
"DOC008",
"DOC006",
"DOC004",
"DOC010"
],
"documentUrl": "https://rusty-pupil.info",
"fileName": "whose_as.[object Object]",
"id": "DV1Si49E7Xn",
"localizedAttributes": {
"description": "Experience the magenta brilliance of our Pants, perfect for pure environments",
"localization": {
"localeCode": "de",
"localization": "FR"
},
"name": "Soft Rubber Pants"
},
"statementUrl": "https://specific-pulse.info",
"supportType": "PRINT_ONLY",
"userMessage": {
"code": "0",
"index": 46,
"localizedText": "Selon les informations fournies sur l'envoi, seul le type de produit / document est autorisé pour cet envoi",
"messageParameters": [
{
"id": "4",
"value": "Based on shipment information provided, only non-document/commodity type is permitted for this shipment"
},
{
"id": "4",
"value": "Weight of commodity exceeds limits for standard shipping."
},
{
"id": "0",
"value": "Weight of commodity exceeds limits for standard shipping."
}
],
"text": "labore sit anim ut"
}
},
"requiredCommodityUnitsOfMeasure": [
"MTR",
"LIT"
]
}
},
"cxsalerts": [
{
"alertType": "NOTE",
"code": "ALERT_02",
"message": "Operational delay detected",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
},
{
"alertType": "WARNING",
"code": "ALERT_03",
"message": "Operational delay detected",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "TRUE"
}
]
},
{
"alertType": "NOTE",
"code": "ALERT_03",
"message": "Customs clearance notice",
"parameterList": [
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
}
]
}
],
"userMessages": [
{
"code": "5",
"index": 14,
"localizedText": "Les coordonnées du destinataire sont manquantes.",
"messageParameters": [
{
"id": "0",
"value": "Country of manufacture information is missing."
}
],
"text": "dolore tempor"
},
{
"code": "7",
"index": 7,
"localizedText": "Selon les informations fournies sur l'envoi, seul le type de produit / document est autorisé pour cet envoi",
"messageParameters": [
{
"id": "0",
"value": "Contact information for recipient is missing."
}
],
"text": "sed proident laborum ea"
},
{
"code": "4",
"index": 49,
"localizedText": "Déclaration du contenu nécessaire pour le dédouanement.",
"messageParameters": [
{
"id": "9",
"value": "Declaration of contents needed for customs clearance."
}
],
"text": "eu sed"
},
{
"code": "8",
"index": 21,
"localizedText": "Le code harmonisé est requis pour l'expédition internationale.",
"messageParameters": [
{
"id": "9",
"value": "Package dimensions required for freight calculation."
}
],
"text": "velit magna consectetur reprehenderit do"
}
]
},
"transactionId": "ee667a13-a471-4119-8d4c-68e57b180dfa"
}{
"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"
},
{
"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": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
}
]
},
{
"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"
}
]
},
{
"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"
}
]
}
],
"transactionId": "1b76e3ce-f79c-4cdd-810d-1979e2c6c77c"
}{
"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": "forceValidation",
"value": "FALSE"
},
{
"key": "ignoreWarnings",
"value": "TRUE"
},
{
"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"
}
]
},
{
"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"
}
]
},
{
"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": "ignoreWarnings",
"value": "TRUE"
},
{
"key": "forceValidation",
"value": "TRUE"
},
{
"key": "forceValidation",
"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": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
}
],
"transactionId": "39972361-821e-4b88-8236-bd03e725b29a"
}{
"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"
}
]
},
{
"code": "INVALID.INPUT.EXCEPTION",
"message": {
"description": "Validation failed for the object='shipmentRegulatoryDetailsInputVO'.Error count:1"
},
"parameterList": [
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
}
],
"transactionId": "16baf67d-43b1-44e5-b45d-3dd889116ffc"
}{
"customerTransactionId": "AnyCo_order748088056",
"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": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"value": "FALSE"
},
{
"key": "forceValidation",
"value": "FALSE"
},
{
"key": "forceValidation",
"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": "forceValidation",
"value": "TRUE"
},
{
"key": "ignoreWarnings",
"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"
},
{
"key": "forceValidation",
"value": "FALSE"
}
]
}
],
"transactionId": "531cd749-cba0-441a-9eca-b23faad16184"
}Service Homepage: developer.fedex.com/api/en-us/catalog/global-trade/v1/docs.html
fedexlogisticsshippingglobal-tradecustoms