View Fedex Services

FedEx Postal Code Validation Virtual Sandbox

Validate postal codes and country-specific address formats for shipping accuracy.

The FedEx Postal Code Validation API allows developers to verify the accuracy of postal codes against country-specific requirements. This service ensures that shipping addresses are correctly formatted and valid before processing labels or calculating transit times, reducing delivery exceptions and shipping errors.

Use this hosted sandbox to simulate FedEx Postal Code Validation 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 postal code formats, verify country-specific address requirements, test error handling for invalid or unsupported postal codes, and ensure address data integrity before submitting shipping requests to FedEx systems.

FedEx Postal Code Validation virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate FedEx Postal Code Validation responses instantly.

https://fedex-postal-code.mock.beeceptor.com



General

Header NameExample
x-customer-transaction-id"624deea6-b709-470c-8c39-4b5511281492"
content-type*"application/json"
x-locale"en_US"
authorization*"Bearer XXX"
Request Payload
{
  "carrierCode": "FDXE",
  "countryCode": "US",
  "postalCode": "38017",
  "shipDate": "2016-09-13",
  "stateOrProvinceCode": "TN"
}
Response Payload
{
  "customerTransactionId": "TCo0DD-hgssNF4G",
  "output": {
    "alerts": [
      {
        "alertType": "NOTE",
        "code": "STATE.MISMATCH",
        "message": "Invalid state or province code provided.",
        "parameterList": [
          {
            "key": "severity",
            "value": "y3JsA2R6"
          }
        ]
      }
    ],
    "cityFirstInitials": "C",
    "cleanedPostalCode": "41763-0094",
    "countryCode": "PE",
    "locationDescriptions": [
      {
        "airportId": "[object Object]",
        "locationId": "YFA0b",
        "locationNumber": "8",
        "serviceArea": "CC"
      },
      {
        "airportId": "[object Object]",
        "locationId": "dAmkn",
        "locationNumber": "1",
        "serviceArea": "BB"
      },
      {
        "airportId": "[object Object]",
        "locationId": "nwL6T",
        "locationNumber": "9",
        "serviceArea": "AA"
      },
      {
        "airportId": "[object Object]",
        "locationId": "YNZuO",
        "locationNumber": "6",
        "serviceArea": "AA"
      }
    ],
    "stateOrProvinceCode": "VT"
  },
  "transactionId": "387cb092-a433-4213-9e79-2f73d6cb7001"
}
{
  "transactionId": "35fa49ec-1e8a-4334-abc5-7e640ac807ac",
  "customerTransactionId": "AnyCo_order123456789",
  "errors": [
    {
      "code": "CITYNAME.POSTALCODE.REQUIRED",
      "message": "City Name or Postal Code is required."
    }
  ]
}
{
  "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."
    }
  ]
}
Service Homepage: developer.fedex.com/api/en-us/catalog/postal-code/v1/docs.html
fedexlogisticsshippingaddress-validationpostal-code