View Fedex Services

FedEx Ship Tag API Virtual Sandbox

Virtual endpoint for generating and managing FedEx shipping tags.

This service provides a virtual environment for the FedEx Ship Tag API. Developers can use this to prototype the creation of shipping tags and the cancellation of existing shipment tags, ensuring integration logic handles request payloads and response structures correctly without hitting live FedEx infrastructure.

Use this hosted sandbox to simulate FedEx Ship Tag API 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 shipment tag generation workflows, verify request payload structures for label creation, test cancellation logic for specific shipment IDs, and handle API response error codes for invalid or duplicate tag requests.

FedEx Ship Tag API virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate FedEx Ship Tag API responses instantly.

https://fedex-ship-tag.mock.beeceptor.com



General(2 operations)

Header NameExample
x-customer-transaction-id"624deea6-b709-470c-8c39-4b5511281492"
content-type*"application/json"
x-locale"en_US"
authorization*"Bearer XXX"
Request Payload
{
  "accountNumber": {
    "value": "XXX561073"
  },
  "requestedShipment": {
    "blockInsightVisibility": false,
    "packagingType": "FEDEX_BOX",
    "pickupDetail": {
      "latestPickupDateTime": "2020-07-03T14:00:00Z",
      "readyPickupDateTime": "2020-07-03T09:00:00Z"
    },
    "pickupType": "CONTACT_FEDEX_TO_SCHEDULE",
    "recipients": [
      {
        "address": {
          "city": "Irving",
          "countryCode": "US",
          "postalCode": 75063,
          "stateOrProvinceCode": "TX",
          "streetLines": [
            "RECIPIENT STREET LINE 1"
          ]
        },
        "contact": {
          "personName": "RECEIPIENT NAME",
          "phoneNumber": 1234567890
        }
      }
    ],
    "requestedPackageLineItems": [
      {
        "weight": {
          "units": "LB",
          "value": 5
        }
      }
    ],
    "serviceType": "PRIORITY_OVERNIGHT",
    "shipDatestamp": "2020-07-03",
    "shipmentSpecialServices": {
      "returnShipmentDetail": {
        "returnType": "FEDEX_TAG"
      },
      "specialServiceTypes": [
        "RETURN_SHIPMENT"
      ]
    },
    "shipper": {
      "address": {
        "city": "Collierville",
        "countryCode": "US",
        "postalCode": 38017,
        "stateOrProvinceCode": "TN",
        "streetLines": [
          "SHIPPER STREET LINE 1"
        ]
      },
      "contact": {
        "personName": "SHIPPER NAME",
        "phoneNumber": 1234567890
      }
    },
    "shippingChargesPayment": {
      "paymentType": "SENDER",
      "payor": {
        "responsibleParty": {
          "accountNumber": {
            "value": "XXX561073"
          }
        }
      }
    }
  }
}
Response Payload
{
  "customerTransactionId": "clIc5CsBhd9oyxL",
  "output": {
    "alerts": [
      {
        "alertType": "NOTE",
        "code": "SHIPMENT.VALIDATION.SUCCESS",
        "message": "Tametsi defessus corporis cicuta curriculum abduco expedita."
      },
      {
        "alertType": "NOTE",
        "code": "SHIPMENT.VALIDATION.SUCCESS",
        "message": "Curiositas color patria tenuis aegrotatio vel turba caecus."
      },
      {
        "alertType": "NOTE",
        "code": "SHIPMENT.VALIDATION.SUCCESS",
        "message": "Amplus ars claustrum thema deserunt attonbitus cuppedia."
      },
      {
        "alertType": "NOTE",
        "code": "SHIPMENT.VALIDATION.SUCCESS",
        "message": "Decor veritatis soluta vestrum saepe."
      },
      {
        "alertType": "NOTE",
        "code": "SHIPMENT.VALIDATION.SUCCESS",
        "message": "Laboriosam certus credo desino."
      }
    ],
    "completedTagDetail": {
      "confirmationNumber": "6",
      "dispatchDate": "2025-08-30T00:00:00.0Z",
      "location": "DdcJ"
    },
    "masterTrackingNumber": "3",
    "serviceType": "GROUND_HOME_DELIVERY",
    "shipTimestamp": "2026-02-03T00:00:00.0Z"
  },
  "transactionId": "8d50dae0-7213-4427-9e4f-0e0784c56075"
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "errors": [
    {
      "code": "SHIPMENT.USER.UNAUTHORIZED",
      "message": "Requested user is not authorized to perform the operation."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "NOT.AUTHORIZED.ERROR",
      "message": "Access token expired. Please modify your request and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "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."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "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
x-customer-transaction-id"624deea6-b709-470c-8c39-4b5511281492"
content-type*"application/json"
x-locale"en_US"
authorization*"Bearer XXX"
Request Payload
{
  "accountNumber": {
    "value": "XXX561073"
  },
  "completedTagDetail": {
    "confirmationNumber": 1,
    "dispatchDate": "2020-07-03",
    "location": "NQAA"
  },
  "serviceType": "PRIORITY_OVERNIGHT",
  "trackingNumber": 301000024940
}
Response Payload
{
  "customerTransactionId": "XuEZzkTedjqmhpv",
  "output": {
    "cancelledTag": true,
    "successMessage": "success"
  },
  "transactionId": "cb6ba213-069f-4ba2-9c3b-7e9ee59929c1"
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "errors": [
    {
      "code": "SHIPMENT.USER.UNAUTHORIZED",
      "message": "Requested user is not authorized to perform the operation."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "NOT.AUTHORIZED.ERROR",
      "message": "Access token expired. Please modify your request and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "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."
    }
  ]
}
{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "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."
    }
  ]
}
Service Homepage: developer.fedex.com/api/en-us/catalog/ship/v1/docs.html
fedexshippinglogisticsshipmenttracking