ValidateAddress

Summary

Check of the delivered customer addresses as well as a phonetic and associative identification of duplicates. Additionally, checks of client specific negative or positive lists can be processed. Usually, the AddressCheck is used for the pure verification of the address data e.g. for registration processes.

Resource URL /api/v3/validate/address
HTTP method POST
Content type application/json; text/json;

Input parameters

Parameter name Location Type / Model Description
request body ValidateAddressRequest required

Responses

HTTP status code Model Comment
OK(200) ValidateAddressResponse Validate Address Response
BadRequest (400) array of ResponseMessage Request failed. Check response model for list of Errors.
Unauthorized (401) API user is unauthorized. Make sure X-Auth-Key header is sent.
InternalServerError (500) Request failed due internal error. Retry request later.

Examples

{
  "customer": {
    "customerNumber": "CUSTOMER1000",
    "identificationNumber": "SSN198411090111",
    "salutation": "Mr",
    "firstName": "Santa",
    "lastName": "Claus",
    "email": "santa.claus@northpole.com",
    "phone": "+3725551234",
    "mobilePhone": "06669874",
    "birthDate": "1954-12-24T00:00:00Z",
    "customerCategory": "Person",
    "address": {
      "street": "Ice road",
      "streetNumber": "55",
      "streetNumberAdditional": "a",
      "postalCode": "10088",
      "postalPlace": "North pole",
      "countryCode": "NO"
    }
  }
}
{
  "isValid": true,
  "correctedAddress": {
    "street": "Ice road",
    "streetNumber": "55",
    "streetNumberAdditional": "a",
    "postalCode": "10088",
    "postalPlace": "North pole",
    "countryCode": "NO"
  }
}