Fedex Address Validation Virtual Sandbox

Validate and standardize shipping addresses using the FedEx Address Validation API.

The FedEx Address Validation API allows developers to verify, standardize, and correct shipping addresses. This service helps ensure delivery accuracy by checking address validity against FedEx's internal database, providing suggestions for incomplete or incorrect entries to reduce shipping exceptions.

Use this hosted sandbox to simulate Fedex Address 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 endpoint to validate customer-provided shipping addresses, handle address correction suggestions, verify residential vs. commercial classification, and test error handling for invalid or ambiguous location data before integrating with live logistics workflows.

Fedex Address Validation virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate Fedex Address Validation responses instantly.

`https://fedex-address-validation.mock.beeceptor.com`

General

POST

/address/v1/addresses/resolve

Use this endpoint to get address resolution details. These details are the outcome of validation and resolution of the input address. An address is stated as resolved when the input address matches the known reference data.<br><i>Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS)

Header Name	Example
`x-customer-transaction-id`	`"624deea6-b709-470c-8c39-4b5511281492"`
`content-type`*	`"application/json"`
`x-locale`	`"en_US"`
`authorization`*	`"Bearer XXX"`

Request Payload

{
  "addressesToValidate": [
    {
      "address": {
        "city": "Roma",
        "countryCode": "IT",
        "postalCode": 187,
        "streetLines": [
          "Via Vittorio Veneto, 121"
        ]
      }
    }
  ]
}

Response Payload

{
  "customerTransactionId": "AnyCo_order614136735",
  "output": {
    "alerts": [
      {
        "alertType": "NOTE",
        "code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
        "message": "Recipient Postal-City Mismatch."
      },
      {
        "alertType": "NOTE",
        "code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
        "message": "Address not found."
      }
    ],
    "resolvedAddresses": [
      {
        "attributes": {
          "AddressPrecision": "STREET_ADDRESS",
          "AddressType": "NORMALIZED",
          "CountrySupported": true,
          "DataVintage": "September 2020",
          "DPV": true,
          "Inserted": true,
          "InvalidSuiteNumber": "true",
          "Matched": true,
          "MatchSource": "Map",
          "MultipleMatches": true,
          "MultiUnitBase": false,
          "POBox": true,
          "POBoxOnlyZIP": true,
          "ResolutionInput": "RAW_ADDRESS",
          "ResolutionMethod": "GENERIC_VALIDATE",
          "Resolved": false,
          "RRConversion": false,
          "SplitZip": true,
          "StreetAddress": false,
          "SuiteRequiredButMissing": "true",
          "UniqueZIP": false,
          "ValidlyFormed": false,
          "ValidMultiUnit": true,
          "ZIP11Match": false,
          "ZIP4Match": false
        },
        "city": "Lake Wainotown",
        "cityToken": [
          "TOK-1X3256"
        ],
        "classification": "BUSINESS",
        "countryCode": "PR",
        "customerMessage": [
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          },
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          },
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          },
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          }
        ],
        "generalDelivery": true,
        "normalizedStatusNameDPV": false,
        "parsedPostalCode": {
          "addOn": "9",
          "base": "78654",
          "deliveryPoint": "6"
        },
        "postalCodeToken": {
          "changed": true,
          "value": "Quitzonchester"
        },
        "postOfficeBox": false,
        "resolutionMethodName": "USPS_VALIDATE",
        "ruralRouteHighwayContract": true,
        "standardizedStatusNameMatchSource": "Postal",
        "stateOrProvinceCode": "NY",
        "streetLinesToken": [
          "7372 PARKRIDGE BLVD",
          "APT 286"
        ]
      },
      {
        "attributes": {
          "AddressPrecision": "PO_BOX",
          "AddressType": "RAW",
          "CountrySupported": true,
          "DataVintage": "January 2021",
          "DPV": false,
          "Inserted": false,
          "InvalidSuiteNumber": "true",
          "Matched": false,
          "MatchSource": "Postal",
          "MultipleMatches": false,
          "MultiUnitBase": false,
          "POBox": true,
          "POBoxOnlyZIP": true,
          "ResolutionInput": "RAW_ADDRESS",
          "ResolutionMethod": "RELEATLAS_GEO_VALIDATE",
          "Resolved": true,
          "RRConversion": false,
          "SplitZip": false,
          "StreetAddress": false,
          "SuiteRequiredButMissing": "true",
          "UniqueZIP": false,
          "ValidlyFormed": false,
          "ValidMultiUnit": false,
          "ZIP11Match": true,
          "ZIP4Match": true
        },
        "city": "Castle Rock",
        "cityToken": [
          "TOK-1X3256"
        ],
        "classification": "BUSINESS",
        "countryCode": "NE",
        "customerMessage": [
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          },
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          },
          {
            "description": "Returns messages pertaining to the resolved address indicating if any additional information is required."
          }
        ],
        "generalDelivery": true,
        "normalizedStatusNameDPV": true,
        "parsedPostalCode": {
          "addOn": "0",
          "base": "64060",
          "deliveryPoint": "1"
        },
        "postalCodeToken": {
          "changed": false,
          "value": "East Josieport"
        },
        "postOfficeBox": false,
        "resolutionMethodName": "CA_VALIDATE",
        "ruralRouteHighwayContract": true,
        "standardizedStatusNameMatchSource": "Map",
        "stateOrProvinceCode": "PA",
        "streetLinesToken": [
          "7372 PARKRIDGE BLVD",
          "APT 286"
        ]
      }
    ]
  },
  "transactionId": "XXX_ORDERXXXX426"
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "customerTransactionId": "AnyCo_order123456789",
  "errors": [
    {
      "code": "STANDARDIZED.ADDRESS.NOTFOUND",
      "message": "Standardized address is not found."
    }
  ]
}

{
  "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/address-validation/v1/docs.html

fedexlogisticsshippingaddress-validationrest