Changelog

18.12.2024

Technical improvements

Upgrade of our tech stack to remove security issues

25.11.2024

Features

New input option "Address-Info"

In the new input option "address-info" we return speciall information according to the country. Currently, this is only available in Portugal for "Freguesi-Code" and "Freguesi-Name".

13.11.2024

Features

Address-Validation

In some countries it is not guaranted that the region information is the official ISO-3133-2 naming, so we return that information in seperate fields.

Autocompletion

If a customer wants to start an autocompletion session for a country that is not supported, the system will return a message that will tell the customer that the country is not supported.

16.09.2024

Fixed Bugs

Return HouseNumberChoices

If you recieve a ResultClass E it now includes also the HouseNumberChoices.

Wrong Error Message

If there was a mistake in the input of the Request there was an HTTP 503 returned, now we return an HTTP 400 and a clear error message.

08.08.2024

Features

Reverse Geocoding

A walkthrough of the Reverse Geocoding

For further information go to: Reverse Geocode

Default Postalcodes

If you have an address with an unidentified street and postalcode and a Result Class F and the location has more than one postalcode, we will return a default postalcode.

POST /location/v1/validate
Content-Type: application/json
Authorization: Bearer <your-api-key-here>

{
    "street": "Uniserv Str.",
    "postalCode": "12345",
    "locality": "Pforzheim",
    "country": "DE"
    }
}

Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "resultClass": "F",
  "results": [
    {
      "country": "DE",
      "locality": "Pforzheim",
      "street": "Uniserv Str.",
      "postalcode": "75172" --> default postalcode, smalest number in the list
    }
  ]
}

Fixed Bugs

If you want to validate an address in a department of France and set the country to "FR" the autocompletion and validation will now work correctly.

03.07.2024

Fixed Bugs

In FR we now return the offical spelling from La Poste.

29.04.2024

Features

Better validation of Result Class C

Result Class C addresses are examined more closely, to make sure they are actually type C.

Improving identification of postalcodes

The improvments done in the last release were further improved to get better results.

Fixed Bugs

  • Alphanumeric housenumbers are now better recognized, in the search with AddressLine

  • Postbox keywords are better scored and recognized, in the search with AddressLine

13.03.2024

Features

Better identification of postalcodes

We now also recognise postcodes that contain errors in the last digits.

Field Input Result

Country

DE

DE

PostalCode

01722

01737

Locality

Darandt, Stadt

Kurort Hartha

Street

Am Rehpark

Am Rehpark

HouseNumber

3

3

16.01.2024

Features

Better identification of major-customer-addresses

Improve valdidation for major customer addresses if the postalcode is ambiguous. If the postalcode is ambiguous the address-type is decided by the locality. If the locality is not an IDENTIFIED, then the delivery-address will be returned otherwise the major-customer-address.

User input Validation result Description Addresstype

locality: Luzern 1
postalcode: 6000
street: Bahnhofstrasse

locality: Luzern
postalcode: 6000
street: Bahnhofstrasse

In this case the locality didn’t match unambiguously a major-customer-address, so the delivery-address will be returned

delivery-address

locality: Luzern 16
postalcode: 6000
street: Bahnhofstrasse

locality: Luzern 16
postalcode: 6000
street: Bahnhofstrasse

In this case we match the locality of a major-customer-address, so the major-customer-address will be returned

major-customer-address

Fixed bugs

  • fixed concurrency issue in session-token-validation

Technical improvements

  • general internal improvements