FedEx Trade Documents Upload Virtual Sandbox

Upload and manage international trade documents for FedEx shipments.

The FedEx Trade Documents Upload API allows developers to programmatically upload electronic trade documents (ETDs) and shipping images. This service supports multi-part uploads and encoded document handling, enabling seamless integration of customs documentation into shipping workflows.

Use this hosted sandbox to simulate FedEx Trade Documents Upload 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 document upload payloads, test multi-file attachment workflows, verify base64-encoded document transmission, and handle API response codes for successful document ingestion or validation errors before integrating with production customs systems.

FedEx Trade Documents Upload virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate FedEx Trade Documents Upload responses instantly.

https://fedex-trade-docs.mock.beeceptor.com



General(4 operations)

Header NameExample
Content-Type*"incididunt fugiat enim cupidatat"
Authorization*"consectetur magna dolore et"
x-customer-transaction-id"771407-1"
document: {"workflowName":"ETDPreshipment","carrierCode":"FDXE","name":"file.txt","contentType":"text/plain","meta":{"shipDocumentType":"COMMERCIAL_INVOICE","formCode":"USMCA","trackingNumber":"794791292805","shipmentDate":"2021-02-17T00:00:00","originLocationCode":"GVTKK","originCountryCode":"US","destinationLocationCode":"DEL","destinationCountryCode":"IN"}}
attachment: file.txt
{
  "customerTransactionId": "d28aa746-c870-4cee-b643-d32329c1b67d",
  "output": {
    "meta": {
      "docId": "0Cgo3O7LCRReXulb",
      "documentType": "AWB",
      "folderId": "f5OTFp0JMsetLST7"
    }
  }
}
{
  "errors": [
    {
      "code": "1001",
      "message": "Invalid request: invalid input : Invalid document details"
    }
  ]
}
{
  "errors": [
    {
      "code": "AUTHENTICATION.TOKEN.INVALID",
      "message": "Invalid token passed in the request"
    }
  ]
}
{
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}
{
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again."
    }
  ]
}
{
  "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."
    }
  ]
}
{
  "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."
    }
  ]
}
Header NameExample
Authorization*"Bearer XXX"
x-customer-transaction-id"771407-1"
document: {"document": {"referenceId": "1234", "name": "LH2.PNG",    "contentType": "image/png",    "meta": { "imageType": "SIGNATURE","imageIndex": "IMAGE_1"}},"rules": {"workflowName": "LetterheadSignature" }}
attachment: file.PNG
{
  "customerTransactionId": "b828543e-d6d1-4ea6-81b2-b9c5d72300f4",
  "output": {
    "documentReferenceId": "5",
    "meta": {
      "imageIndex": "IMAGE_1",
      "imageType": "LETTERHEAD"
    },
    "status": "SUCCESS"
  }
}
{
  "errors": [
    {
      "code": "1002",
      "message": "Invalid request: no file information."
    }
  ]
}
{
  "errors": [
    {
      "code": "NOT.AUTHORIZED.ERROR",
      "message": "Access token expired. Please modify your request and try again."
    }
  ]
}
{
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again"
    }
  ]
}
{
  "error": "NOT.FOUND.ERROR",
  "error_detail": "The resource you requested is no longer available. Please modify your request and try again."
}
{
  "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."
    }
  ]
}
{
  "errors": [
    {
      "code": "SERVICE.UNAVAILABLE",
      "message": null
    }
  ]
}
Header NameExample
Content-Type*"multipart/form-data"
Authorization*"Bearer XXXXXX"
x-customer-transaction-id*"624deea6-b709-470c-8c39-4b5511281492"
documentInformation: {"workflowName": "ETDPreshipment","carrierCode": "FDXE","originCountryCode": "US","destinationCountryCode": "CA","shipmentDate": "2021-10-21T00:00:00","trackingNumber": "782514212510","metaData": [{"fileName":"file1.png","fileReferenceId":"inv_file1_ctx_02132021_5","contentType": "image/png","formCode": "USMCA","shipDocumentType":"COMMERCIAL_INVOICE"},{"fileName":"file2.txt", "fileReferenceId":"PI_2", "contentType":"text/plain", "formCode": "USMCA", "shipDocumentType":"PRO_FORMA_INVOICE"},{"fileName":"file3.txt", "fileReferenceId":"PI_2", "contentType":"text/plain", "formCode": "USMCA", "shipDocumentType":"PRO_FORMA_INVOICE"},{"fileName":"file4.txt", "fileReferenceId":"PI_2", "contentType":"text/plain", "formCode": "USMCA", "shipDocumentType":"PRO_FORMA_INVOICE"},{"file5.txt", "fileReferenceId":"PI_2", "contentType":"text/plain", "formCode": "USMCA", "shipDocumentType":"PRO_FORMA_INVOICE"}]
fileAttachments: 'file1.png'
fileAttachments: 'file2.txt'
fileAttachments: 'file3.txt'
fileAttachments: 'file4.txt'
fileAttachments: 'file5.txt'
{
  "customerTransactionId": "f7876796-c01b-4f6d-a57d-0be582e56cf5",
  "output": {
    "documentResponses": [
      {
        "fileReferenceId": "PI_2",
        "metaData": {
          "docId": "kgr9lgjU3juqxyhf",
          "documentType": "PRO",
          "formCode": "USMCA"
        }
      },
      {
        "fileReferenceId": "CI_1",
        "metaData": {
          "docId": "CPK8nMAkD5Ngw0vK",
          "documentType": "CI",
          "formCode": "USMCA"
        }
      }
    ]
  },
  "transactionId": "d2f8cf83-27b2-4699-a355-bc2c24d69f54"
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "output": {
    "documentResponses": {
      "alerts": [
        {
          "code": "1024",
          "message": "ETD shipment validation failure : Invalid destination country code"
        }
      ]
    }
  },
  "errors": [
    {
      "code": "1001",
      "message": "Invalid request: invalid input : Could not upload files. Check the alerts or errors in documentResponses"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "errors": [
    {
      "code": "AUTHENTICATION.TOKEN.INVALID",
      "message": "Invalid token passed in the request"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}
{
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "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."
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "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."
    }
  ]
}
Header NameExample
Content-Type*"application/json"
Authorization*"Bearer XXXXXX"
x-customer-transaction-id*"624deea6-b709-470c-8c39-4b5511281492"
{
  "workflowName": "ETDPreshipment",
  "carrierCode": "FDXE",
  "originCountryCode": "US",
  "destinationCountryCode": "CA",
  "shipmentDate": "2024-01-06T00:00:00",
  "trackingNumber": "782514212510",
  "metaData": [
    {
      "fileReferenceId": "inv_file1_ctx_02132021_1",
      "contentType": "image/png",
      "shipDocumentType": "ETD_LABEL",
      "formCode": "USMCA",
      "fileContentBase64": "iVBORw0KGgoAAAANSUhEUgAAABEAAAAOCAMAAAD+MweGAAADAFBMVEUAAAAAAFUAAKoAAP8AJAAAJFUAJKoAJP8ASQAASVUASaoASf8AbQAAbVUAbaoAbf8AkgAAklUAkqoAkv8AtgAAtlUAtqoAtv8A2wAA21UA26oA2/8A/wAA/1UA/6oA//8kAAAkAFUkAKokAP8kJAAkJFUkJKokJP8kSQAkSVUkSaokSf8kbQAkbVUkbaokbf8kkgAkklUkkqokkv8ktgAktlUktqoktv8k2wAk21Uk26ok2/8k/wAk/1Uk/6ok//9JAABJAFVJAKpJAP9JJABJJFVJJKpJJP9JSQBJSVVJSapJSf9JbQBJbVVJbapJbf9JkgBJklVJkqpJkv9JtgBJtlVJtqpJtv9J2wBJ21VJ26pJ2/9J/wBJ/1VJ/6pJ//9tAABtAFVtAKptAP9tJABtJFVtJKptJP9tSQBtSVVtSaptSf9tbQBtbVVtbaptbf9tkgBtklVtkqptkv9ttgBttlVttqpttv9t2wBt21Vt26pt2/9t/wBt/1Vt/6pt//+SAACSAFWSAKqSAP+SJACSJFWSJKqSJP+SSQCSSVWSSaqSSf+SbQCSbVWSbaqSbf+SkgCSklWSkqqSkv+StgCStlWStqqStv+S2wCS21WS26qS2/+S/wCS/1WS/6qS//+2AAC2AFW2AKq2AP+2JAC2JFW2JKq2JP+2SQC2SVW2Saq2Sf+2bQC2bVW2baq2bf+2kgC2klW2kqq2kv+2tgC2tlW2tqq2tv+22wC221W226q22/+2/wC2/1W2/6q2///bAADbAFXbAKrbAP/bJADbJFXbJKrbJP/bSQDbSVXbSarbSf/bbQDbbVXbbarbbf/bkgDbklXbkqrbkv/btgDbtlXbtqrbtv/b2wDb21Xb26rb2//b/wDb/1Xb/6rb////AAD/AFX/AKr/AP//JAD/JFX/JKr/JP//SQD/SVX/Sar/Sf//bQD/bVX/bar/bf//kgD/klX/kqr/kv//tgD/tlX/tqr/tv//2wD/21X/26r/2////wD//1X//6r////qm24uAAAA1ElEQVR42h1PMW4CQQwc73mlFJGCQChFIp0Rh0RBGV5AFUXKC/KPfCFdqryEgoJ8IX0KEF64q0PPnow3jT2WxzNj+gAgAGfvvDdCQIHoSnGYcGDE2nH92DoRqTYJ2bTcsKgqhIi47VdgAWNmwFSFA1UAAT2sSFcnq8a3x/zkkJrhaHT3N+hD3aH7ZuabGHX7bsSMhxwTJLr3evf1e0nBVcwmqcTZuatKoJaB7dSHjTZdM0G1HBTWefly//q2EB7/BEvk5vmzeQaJ7/xKPImpzv8/s4grhAxHl0DsqGUAAAAASUVORK5CYII="
    },
    {
      "fileReferenceId": "inv_file1_ctx_02132021_2",
      "contentType": "text/plain",
      "shipDocumentType": "ETD_LABEL",
      "formCode": "USMCA",
      "fileContentBase64": "dGVzdGluZyBmb3IgbXVsdGlmaWxlIHVwbG9hZCB0ZXN0LWExDQp0ZXN0aW5nIGZvciBtdWx0aWZpbGUgdXBsb2FkIHRlc3QtYTENCkphbmFyZGhhbiBTaGluZ2FkZQ"
    },
    {
      "fileReferenceId": "inv_file1_ctx_02132021_3",
      "contentType": "image/png",
      "shipDocumentType": "ETD_LABEL",
      "formCode": "USMCA",
      "fileContentBase64": "iVBORw0KGgoAAAANSUhEUgAAABEAAAAOCAMAAAD+MweGAAADAFBMVEUAAAAAAFUAAKoAAP8AJAAAJFUAJKoAJP8ASQAASVUASaoASf8AbQAAbVUAbaoAbf8AkgAAklUAkqoAkv8AtgAAtlUAtqoAtv8A2wAA21UA26oA2/8A/wAA/1UA/6oA//8kAAAkAFUkAKokAP8kJAAkJFUkJKokJP8kSQAkSVUkSaokSf8kbQAkbVUkbaokbf8kkgAkklUkkqokkv8ktgAktlUktqoktv8k2wAk21Uk26ok2/8k/wAk/1Uk/6ok//9JAABJAFVJAKpJAP9JJABJJFVJJKpJJP9JSQBJSVVJSapJSf9JbQBJbVVJbapJbf9JkgBJklVJkqpJkv9JtgBJtlVJtqpJtv9J2wBJ21VJ26pJ2/9J/wBJ/1VJ/6pJ//9tAABtAFVtAKptAP9tJABtJFVtJKptJP9tSQBtSVVtSaptSf9tbQBtbVVtbaptbf9tkgBtklVtkqptkv9ttgBttlVttqpttv9t2wBt21Vt26pt2/9t/wBt/1Vt/6pt//+SAACSAFWSAKqSAP+SJACSJFWSJKqSJP+SSQCSSVWSSaqSSf+SbQCSbVWSbaqSbf+SkgCSklWSkqqSkv+StgCStlWStqqStv+S2wCS21WS26qS2/+S/wCS/1WS/6qS//+2AAC2AFW2AKq2AP+2JAC2JFW2JKq2JP+2SQC2SVW2Saq2Sf+2bQC2bVW2baq2bf+2kgC2klW2kqq2kv+2tgC2tlW2tqq2tv+22wC221W226q22/+2/wC2/1W2/6q2///bAADbAFXbAKrbAP/bJADbJFXbJKrbJP/bSQDbSVXbSarbSf/bbQDbbVXbbarbbf/bkgDbklXbkqrbkv/btgDbtlXbtqrbtv/b2wDb21Xb26rb2//b/wDb/1Xb/6rb////AAD/AFX/AKr/AP//JAD/JFX/JKr/JP//SQD/SVX/Sar/Sf//bQD/bVX/bar/bf//kgD/klX/kqr/kv//tgD/tlX/tqr/tv//2wD/21X/26r/2////wD//1X//6r////qm24uAAAA1ElEQVR42h1PMW4CQQwc73mlFJGCQChFIp0Rh0RBGV5AFUXKC/KPfCFdqryEgoJ8IX0KEF64q0PPnow3jT2WxzNj+gAgAGfvvDdCQIHoSnGYcGDE2nH92DoRqTYJ2bTcsKgqhIi47VdgAWNmwFSFA1UAAT2sSFcnq8a3x/zkkJrhaHT3N+hD3aH7ZuabGHX7bsSMhxwTJLr3evf1e0nBVcwmqcTZuatKoJaB7dSHjTZdM0G1HBTWefly//q2EB7/BEvk5vmzeQaJ7/xKPImpzv8/s4grhAxHl0DsqGUAAAAASUVORK5CYII="
    },
    {
      "fileReferenceId": "inv_file1_ctx_02132021_4",
      "contentType": "text/plain",
      "shipDocumentType": "ETD_LABEL",
      "formCode": "USMCA",
      "fileContentBase64": "dGVzdGluZyBmb3IgbXVsdGlmaWxlIHVwbG9hZCB0ZXN0LWExDQp0ZXN0aW5nIGZvciBtdWx0aWZpbGUgdXBsb2FkIHRlc3QtYTENCkphbmFyZGhhbiBTaGluZ2FkZQ"
    },
    {
      "fileReferenceId": "inv_file1_ctx_02132021_5",
      "contentType": "image/png",
      "shipDocumentType": "ETD_LABEL",
      "formCode": "USMCA",
      "fileContentBase64": "iVBORw0KGgoAAAANSUhEUgAAABEAAAAOCAMAAAD+MweGAAADAFBMVEUAAAAAAFUAAKoAAP8AJAAAJFUAJKoAJP8ASQAASVUASaoASf8AbQAAbVUAbaoAbf8AkgAAklUAkqoAkv8AtgAAtlUAtqoAtv8A2wAA21UA26oA2/8A/wAA/1UA/6oA//8kAAAkAFUkAKokAP8kJAAkJFUkJKokJP8kSQAkSVUkSaokSf8kbQAkbVUkbaokbf8kkgAkklUkkqokkv8ktgAktlUktqoktv8k2wAk21Uk26ok2/8k/wAk/1Uk/6ok//9JAABJAFVJAKpJAP9JJABJJFVJJKpJJP9JSQBJSVVJSapJSf9JbQBJbVVJbapJbf9JkgBJklVJkqpJkv9JtgBJtlVJtqpJtv9J2wBJ21VJ26pJ2/9J/wBJ/1VJ/6pJ//9tAABtAFVtAKptAP9tJABtJFVtJKptJP9tSQBtSVVtSaptSf9tbQBtbVVtbaptbf9tkgBtklVtkqptkv9ttgBttlVttqpttv9t2wBt21Vt26pt2/9t/wBt/1Vt/6pt//+SAACSAFWSAKqSAP+SJACSJFWSJKqSJP+SSQCSSVWSSaqSSf+SbQCSbVWSbaqSbf+SkgCSklWSkqqSkv+StgCStlWStqqStv+S2wCS21WS26qS2/+S/wCS/1WS/6qS//+2AAC2AFW2AKq2AP+2JAC2JFW2JKq2JP+2SQC2SVW2Saq2Sf+2bQC2bVW2baq2bf+2kgC2klW2kqq2kv+2tgC2tlW2tqq2tv+22wC221W226q22/+2/wC2/1W2/6q2///bAADbAFXbAKrbAP/bJADbJFXbJKrbJP/bSQDbSVXbSarbSf/bbQDbbVXbbarbbf/bkgDbklXbkqrbkv/btgDbtlXbtqrbtv/b2wDb21Xb26rb2//b/wDb/1Xb/6rb////AAD/AFX/AKr/AP//JAD/JFX/JKr/JP//SQD/SVX/Sar/Sf//bQD/bVX/bar/bf//kgD/klX/kqr/kv//tgD/tlX/tqr/tv//2wD/21X/26r/2////wD//1X//6r////qm24uAAAA1ElEQVR42h1PMW4CQQwc73mlFJGCQChFIp0Rh0RBGV5AFUXKC/KPfCFdqryEgoJ8IX0KEF64q0PPnow3jT2WxzNj+gAgAGfvvDdCQIHoSnGYcGDE2nH92DoRqTYJ2bTcsKgqhIi47VdgAWNmwFSFA1UAAT2sSFcnq8a3x/zkkJrhaHT3N+hD3aH7ZuabGHX7bsSMhxwTJLr3evf1e0nBVcwmqcTZuatKoJaB7dSHjTZdM0G1HBTWefly//q2EB7/BEvk5vmzeQaJ7/xKPImpzv8/s4grhAxHl0DsqGUAAAAASUVORK5CYII="
    }
  ]
}
{
  "customerTransactionId": "ce0705b4-151f-4bd4-959b-4674f6c2e773",
  "output": {
    "documentResponses": [
      {
        "fileReferenceId": "inv_file1_ctx_02132021_1",
        "metaData": {
          "docId": "bZjLPP5HlvIxachz",
          "documentType": "AWB",
          "formCode": "USMCA"
        }
      },
      {
        "fileReferenceId": "inv_file1_ctx_02132021_2",
        "metaData": {
          "docId": "yMImwFHuxtVpkkCg",
          "documentType": "AWB",
          "formCode": "USMCA"
        }
      },
      {
        "fileReferenceId": "inv_file1_ctx_02132021_3",
        "metaData": {
          "docId": "JviFICNTz1bv7ivr",
          "documentType": "AWB",
          "formCode": "USMCA"
        }
      },
      {
        "fileReferenceId": "inv_file1_ctx_02132021_4",
        "metaData": {
          "docId": "rIVoRd4J9PqogpPq",
          "documentType": "AWB",
          "formCode": "USMCA"
        }
      },
      {
        "fileReferenceId": "inv_file1_ctx_02132021_5",
        "metaData": {
          "docId": "07LbbwUzi2z0XCwL",
          "documentType": "AWB",
          "formCode": "USMCA"
        }
      }
    ]
  },
  "transactionId": "fdc3aca8-ba6b-4c45-8f53-77d14145a812"
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "output": {
    "documentResponses": {
      "alerts": [
        {
          "code": "1024",
          "message": "ETD shipment validation failure : Invalid destination country code"
        }
      ]
    }
  },
  "errors": [
    {
      "code": "1001",
      "message": "Invalid request: invalid input : Could not upload files. Check the alerts or errors in documentResponses"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "errors": [
    {
      "code": "AUTHENTICATION.TOKEN.INVALID",
      "message": "Invalid token passed in the request"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}
{
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again"
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "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."
    }
  ]
}
{
  "customerTransactionId": "5678b975-ev0e-420b-8d7b-aa6ce65ec48n",
  "transactionId": "407eb778-eb0e-420b-8d7b-aa6ce65ec38a",
  "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."
    }
  ]
}
fedexlogisticsshippingtrade-documentscustoms