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.
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" |
{
"addressesToValidate": [
{
"address": {
"city": "Roma",
"countryCode": "IT",
"postalCode": 187,
"streetLines": [
"Via Vittorio Veneto, 121"
]
}
}
]
}{
"customerTransactionId": "AnyCo_order962328041",
"output": {
"alerts": [
{
"alertType": "NOTE",
"code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
"message": "Address not found."
},
{
"alertType": "NOTE",
"code": "ADDRESS.NOT.FOUND",
"message": "Address not found."
},
{
"alertType": "NOTE",
"code": "ADDRESS.NOT.FOUND",
"message": "Address not found."
},
{
"alertType": "NOTE",
"code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
"message": "Recipient Postal-City Mismatch."
}
],
"resolvedAddresses": [
{
"attributes": {
"AddressPrecision": "StreetOrganization",
"AddressType": "RAW",
"CountrySupported": true,
"DataVintage": "September 2020",
"DPV": true,
"Inserted": false,
"InvalidSuiteNumber": "true",
"Matched": true,
"MatchSource": "Postal",
"MultipleMatches": true,
"MultiUnitBase": false,
"POBox": false,
"POBoxOnlyZIP": false,
"ResolutionInput": "RAW_ADDRESS",
"ResolutionMethod": "GENERIC_VALIDATE",
"Resolved": true,
"RRConversion": false,
"SplitZip": false,
"StreetAddress": false,
"SuiteRequiredButMissing": "false",
"UniqueZIP": true,
"ValidlyFormed": true,
"ValidMultiUnit": false,
"ZIP11Match": false,
"ZIP4Match": false
},
"city": "Fort Vaughntown",
"cityToken": [
"TOK-1X3256"
],
"classification": "BUSINESS",
"countryCode": "ME",
"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."
}
],
"generalDelivery": true,
"normalizedStatusNameDPV": true,
"parsedPostalCode": {
"addOn": "7",
"base": "52440",
"deliveryPoint": "5"
},
"postalCodeToken": {
"changed": true,
"value": "Burbank"
},
"postOfficeBox": false,
"resolutionMethodName": "GENERIC_VALIDATE",
"ruralRouteHighwayContract": false,
"standardizedStatusNameMatchSource": "Postal",
"stateOrProvinceCode": "PA",
"streetLinesToken": [
"7372 PARKRIDGE BLVD",
"APT 286"
]
},
{
"attributes": {
"AddressPrecision": "StreetBuilding",
"AddressType": "NORMALIZED",
"CountrySupported": false,
"DataVintage": "July 2020",
"DPV": false,
"Inserted": false,
"InvalidSuiteNumber": "true",
"Matched": true,
"MatchSource": "Postal",
"MultipleMatches": false,
"MultiUnitBase": false,
"POBox": false,
"POBoxOnlyZIP": false,
"ResolutionInput": "RAW_ADDRESS",
"ResolutionMethod": "NAVTEQ_GEO_VALIDATE",
"Resolved": true,
"RRConversion": true,
"SplitZip": false,
"StreetAddress": true,
"SuiteRequiredButMissing": "false",
"UniqueZIP": false,
"ValidlyFormed": false,
"ValidMultiUnit": true,
"ZIP11Match": true,
"ZIP4Match": false
},
"city": "Port Ayanacester",
"cityToken": [
"TOK-1X3256"
],
"classification": "BUSINESS",
"countryCode": "MS",
"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": false,
"parsedPostalCode": {
"addOn": "2",
"base": "91207-6673",
"deliveryPoint": "4"
},
"postalCodeToken": {
"changed": false,
"value": "New Clementton"
},
"postOfficeBox": true,
"resolutionMethodName": "GENERIC_VALIDATE",
"ruralRouteHighwayContract": false,
"standardizedStatusNameMatchSource": "Postal",
"stateOrProvinceCode": "GA",
"streetLinesToken": [
"7372 PARKRIDGE BLVD",
"APT 286"
]
},
{
"attributes": {
"AddressPrecision": "UNIQUE_ZIP",
"AddressType": "NORMALIZED",
"CountrySupported": true,
"DataVintage": "January 2021",
"DPV": true,
"Inserted": false,
"InvalidSuiteNumber": "false",
"Matched": true,
"MatchSource": "Map",
"MultipleMatches": false,
"MultiUnitBase": false,
"POBox": true,
"POBoxOnlyZIP": true,
"ResolutionInput": "RAW_ADDRESS",
"ResolutionMethod": "GENERIC_VALIDATE",
"Resolved": false,
"RRConversion": true,
"SplitZip": false,
"StreetAddress": true,
"SuiteRequiredButMissing": "false",
"UniqueZIP": false,
"ValidlyFormed": false,
"ValidMultiUnit": true,
"ZIP11Match": false,
"ZIP4Match": true
},
"city": "Janaton",
"cityToken": [
"TOK-1X3256"
],
"classification": "BUSINESS",
"countryCode": "SZ",
"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": false,
"normalizedStatusNameDPV": true,
"parsedPostalCode": {
"addOn": "4",
"base": "01027-3192",
"deliveryPoint": "4"
},
"postalCodeToken": {
"changed": false,
"value": "South Nickcester"
},
"postOfficeBox": false,
"resolutionMethodName": "NAVTEQ_GEO_VALIDATE",
"ruralRouteHighwayContract": false,
"standardizedStatusNameMatchSource": "Map",
"stateOrProvinceCode": "WA",
"streetLinesToken": [
"7372 PARKRIDGE BLVD",
"APT 286"
]
},
{
"attributes": {
"AddressPrecision": "StreetOrganization",
"AddressType": "NORMALIZED",
"CountrySupported": true,
"DataVintage": "August 2020",
"DPV": false,
"Inserted": true,
"InvalidSuiteNumber": "true",
"Matched": true,
"MatchSource": "Postal",
"MultipleMatches": false,
"MultiUnitBase": false,
"POBox": true,
"POBoxOnlyZIP": false,
"ResolutionInput": "RAW_ADDRESS",
"ResolutionMethod": "NAVTEQ_GEO_VALIDATE",
"Resolved": true,
"RRConversion": true,
"SplitZip": true,
"StreetAddress": true,
"SuiteRequiredButMissing": "false",
"UniqueZIP": true,
"ValidlyFormed": false,
"ValidMultiUnit": false,
"ZIP11Match": true,
"ZIP4Match": false
},
"city": "Caterinaborough",
"cityToken": [
"TOK-1X3256"
],
"classification": "BUSINESS",
"countryCode": "NP",
"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."
}
],
"generalDelivery": true,
"normalizedStatusNameDPV": true,
"parsedPostalCode": {
"addOn": "3",
"base": "68039",
"deliveryPoint": "6"
},
"postalCodeToken": {
"changed": true,
"value": "East Honolulu"
},
"postOfficeBox": false,
"resolutionMethodName": "TELEATLAS_GEO_VALIDATE",
"ruralRouteHighwayContract": false,
"standardizedStatusNameMatchSource": "Map",
"stateOrProvinceCode": "GA",
"streetLinesToken": [
"7372 PARKRIDGE BLVD",
"APT 286"
]
},
{
"attributes": {
"AddressPrecision": "StreetBuilding",
"AddressType": "RAW",
"CountrySupported": true,
"DataVintage": "August 2020",
"DPV": false,
"Inserted": false,
"InvalidSuiteNumber": "true",
"Matched": true,
"MatchSource": "Map",
"MultipleMatches": true,
"MultiUnitBase": false,
"POBox": true,
"POBoxOnlyZIP": false,
"ResolutionInput": "RAW_ADDRESS",
"ResolutionMethod": "USPS_VALIDATE",
"Resolved": true,
"RRConversion": true,
"SplitZip": true,
"StreetAddress": false,
"SuiteRequiredButMissing": "true",
"UniqueZIP": false,
"ValidlyFormed": true,
"ValidMultiUnit": true,
"ZIP11Match": true,
"ZIP4Match": false
},
"city": "West Caseystead",
"cityToken": [
"TOK-1X3256"
],
"classification": "BUSINESS",
"countryCode": "LR",
"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": true,
"parsedPostalCode": {
"addOn": "8",
"base": "24857-5462",
"deliveryPoint": "4"
},
"postalCodeToken": {
"changed": true,
"value": "Fort Berniece"
},
"postOfficeBox": true,
"resolutionMethodName": "USPS_VALIDATE",
"ruralRouteHighwayContract": true,
"standardizedStatusNameMatchSource": "Postal",
"stateOrProvinceCode": "TX",
"streetLinesToken": [
"7372 PARKRIDGE BLVD",
"APT 286"
]
}
]
},
"transactionId": "XXX_ORDERXXXX650"
}{
"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