Anti Aging

This is an upcoming feature that is not yet available.

The Anti-Aging feature helps you keep your address data up to date – fast and cost-effective. It checks only for renamings (for example, street or house number changes) and skips more complex validations when no renaming is found.

This feature is available only for batch processing and only in the countries Germany (DE), Austria (AT), and Switzerland (CH).

It is especially useful if your addresses were already validated before and you now want to check only for official changes, such as street renamings or municipality mergers.

In Germany alone, every year there are approximately:

4,000 municipality or locality renamings
4,000 new streets
10,000 street renamings
120,000 house number reorganizations

To use Anti Aging, you must include the following option in your request:

"validationMode": ["renamings-only"]

Optionally, you can add a since parameter to define how far back renamings should be checked. If not set, the default is 6 months.

If no change is found, the API returns no result and uses status code 230. If a renaming is found, the updated address is returned.

Example: no renaming

Request

{
  "country": "DE",
  "postalCode": "75179",
  "locality": "Pforzheim",
  "street": "Rastatter Str.",
  "houseNumber": "13",
  "_options": {
    "addressTypes": ["major-customer", "po-box"],
    "validationMode": ["renamings-only"],
    "since": "1992-05-25"
  }
}

Response

{}

Example: renaming found

Request

{
  "country": "DE",
  "postalCode": "39539",
  "locality": "Havelberg",
  "street": "Otto-Grotewohl-Ring",
  "houseNumber": "12",
  "_options": {
    "addressTypes": ["major-customer", "po-box"],
    "validationMode": ["renamings-only"],
    "since": "1992-05-25"
  }
}

Response

{
  "resultClass": "B",
  "results": [
    {
      "addressType": "delivery",
      "country": "DE",
      "postalCode": "39539",
      "locality": "Havelberg",
      "localityAbbreviation": "Havelberg",
      "subLocality": "Havelberg",
      "subLocalityAbbreviation": "Havelberg",
      "street": "Mühlenweg",
      "streetAbbreviation": "Mühlenweg",
      "houseNumber": "16"
    }
  ]
}