Address Check

Full address validation with automatic correction suggestions.

Method: addressCheck

API KeyNot set

Stored in localStorage — never sent to this site.

Parameters

Street format:

Country Code *ISO 3166-1 Alpha-2

Postal Code *

City Name *

Street + Number (combined)

Language

Optional fields:Address supplement additionalInfo(sends "" — API fills it back if found)State/Region subdivisionCode(sends "" to get it auto-filled by API)

House-number-first countries (78)

In the following countries the house number is placed before the street name (e.g. "10 Downing Street" rather than "Downing Street 10"):

AD, AM, AU, AZ, BD, BH, BL, BN, CA, CC, CD, CG, CI, CK, CN, CX, CY, DM, DZ, EG, FJ, FR, GA, GB, GE, GH, GI, GM, GP, GU, GY, HK, ID, IE, IL, IN, KH, KN, LA, LB, LU, MA, MC, MF, MM, MR, MS, MU, NA, NF, NG, NZ, OM, PH, PK, PR, PW, RE, RW, SA, SG, SH, SL, SN, TC, TG, TH, TM, TN, TT, TW, TZ, US, VM, WF, YE, ZM, ZW

Request Preview

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "addressCheck",
  "params": {}
}

Set an API key above to enable live requests.

Parameters

Field	Required	Type	Description
country	Yes	String	ISO 3166-1 Alpha-2 country code (e.g. DE)
postCode	Yes	String	Postal code
cityName	Yes	String	City name
streetFull	No*	String	Street + house number combined (e.g. Hauptstr. 22)
street	No*	String	Street name only
houseNumber	No*	String	House number only
additionalInfo	No	String	Address supplement. Send "" to include in response.
subdivisionCode	No	String	State/region code (e.g. DE-BY). Send "" to auto-fill.
language	No	String	Output language (e.g. de).

*Either streetFull or (street + houseNumber) is required.

Response

{
  "result": {
    "predictions": [
      {
        "country": "de",
        "postCode": "97232",
        "cityName": "Giebelstadt",
        "street": "Lindenstr.",
        "houseNumber": "28",
        "additionalInfo": "",
        "subdivisionCode": "DE-BY"
      }
    ],
    "status": [
      "address_needs_correction",
      "country_code_correct",
      "postal_code_correct",
      "locality_correct",
      "street_name_needs_correction",
      "street_name_minor_correction",
      "building_number_correct"
    ]
  }
}

Status Codes

Core Result

Code	Meaning	Action
address_correct	Address is correct	No action needed
address_needs_correction	Correction in predictions	Apply based on severity
address_multiple_variants	Multiple valid variants	Show to user for selection
address_not_found	Not in database	Manual review
address_of_not_supported_type	e.g. Packstation	Inform user

Severity (auto-adopt vs manual)

Code	Auto-adopt?	Meaning
address_minor_correction	Yes	Small fix, safe to apply automatically
address_major_correction	No	Critical change, user must confirm
[field]_minor_correction	Yes	Field-level minor fix
[field]_major_correction	No	Field-level critical change

Decision Logic

address_correct                      → no action
address_needs_correction
  + address_minor_correction only   → auto-adopt predictions
  + any _major_correction           → show user for confirmation
address_multiple_variants            → user picks one
address_not_found                    → manual review

Per-Field Codes

Each field returns a pair: [field]_correct or [field]_needs_correction.

Prefix	Field
country_code_	Country
postal_code_	Postal code
locality_	City name
street_name_	Street name
building_number_	House number
additional_info_	Address supplement
subdivision_code_	State/region

Examples

Street + number split

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "addressCheck",
  "params": {
    "country": "DE",
    "language": "de",
    "postCode": "97232",
    "cityName": "Giebelstadt",
    "street": "Lindenstraße",
    "houseNumber": "28"
  }
}

Combined street

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "addressCheck",
  "params": {
    "country": "DE",
    "language": "de",
    "postCode": "97232",
    "cityName": "Giebelstadt",
    "streetFull": "Lindenstraße 28"
  }
}

With subdivision code

Send subdivisionCode: "" to have the API auto-fill it:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "addressCheck",
  "params": {
    "country": "DE",
    "postCode": "97232",
    "cityName": "Giebelstadt",
    "street": "Lindenstraße",
    "houseNumber": "28",
    "subdivisionCode": ""
  }
}

The response will include subdivisionCode: "DE-BY" and status codes subdivision_code_needs_correction + subdivision_code_minor_correction — this is expected, not an error.