Skip to main content

Address Validation

POST 
/compliance/address-validation

This endpoint performs address validation. It validates addresses for correctness, offers corrections, and standardizes and appends addresses.

The address validation is performed in two steps:

  1. Supporting the customer after entering place and street and sending the data by using "suggestion" mechanisms.
  2. Final check/validation of the address (incl. house number), i.e., "Is this address correct?"

The end customer can accept or ignore the suggested address. For this, a corresponding front-end feature should be implemented by the acceptance point / market place operator.

Request​

Header Parameters

    Content-Type stringrequired

    Must be application/json

    Accept-Language stringrequired

    Must be be en-US

    Origin stringrequired

    The origin of the request

    User-Agent stringrequired

    The client making the request

Body

required

    addressLine1 stringrequired

    Possible values: <= 127 characters

    The first line of the address.

    number stringrequired

    Possible values: <= 10 characters

    The house number of the address.

    postCode stringrequired

    Possible values: <= 10 characters

    The postal code of the address.

    city stringrequired

    Possible values: <= 64 characters

    The city of the address.

    countryCode stringrequired

    Possible values: <= 2 characters

    The country code of the address (ISO 3166-1 alpha-2 format).

Responses​

Successful response with address validation results.

Schema

    addressCheckData

    object

    archiveId string

    The archive ID of the address check.

    decision string

    Possible values: [HOUSE_CONFIRMED, STREET_CONFIRMED_HOUSE_NOT_IDENTIFIED, STREET_CONFIRMED_HOUSE_NOT_PROVIDED, CITY_CONFIRMED_STREET_NOT_IDENTIFIED, NOT_CONFIRMED]


    The decision made on the address validation. Possible values:

    • HOUSE_CONFIRMED: The address could be confirmed. Perfect match between provided address and foundAddress.
    • STREET_CONFIRMED_HOUSE_NOT_IDENTIFIED: The address could be confirmed all the way down to the street, but the provided house number could not be identified.
    • STREET_CONFIRMED_HOUSE_NOT_PROVIDED: The address could be confirmed all the way down to the street, but no house number was provided in the API request.
    • CITY_CONFIRMED_STREET_NOT_IDENTIFIED: The address could be confirmed all the way down to the city, but the provided street could not be identified.
    • NOT_CONFIRMED: The address could not be confirmed.
    postalCodeCorrect boolean

    Indicates if the postal code is correct.

    normalizedAddress

    object

    addressLine1 stringrequired

    Possible values: <= 60 characters

    Street name.

    addressLine2 string

    Possible values: <= 60 characters

    Apartment, suite, unit, building, floor or other secondary address information.

    addressLine3 string

    Possible values: <= 60 characters

    Specific delivery instructions, department names, or additional floor information.

    city stringrequired

    Possible values: <= 50 characters

    The city or localitly of the address.

    countryCode stringrequired

    Possible values: >= 3 characters and <= 3 characters

    ISO-3 code of the address country (e.g., DEU for Germany).

    number string

    Possible values: <= 10 characters

    The house or building number corresponding to the street address.

    postCode stringrequired

    Possible values: <= 10 characters

    The postal or ZIP code of the address.

    state string

    Possible values: <= 3 characters

    3-letter code of the address state. Mandatory when countryCode corresponds to Canada or USA.

    foundAddress

    object

    The foundAddress shows the best match found for the provided address information. The result of the address check is summarized in the response parameter decision.

    addressLine1 stringrequired

    Possible values: <= 60 characters

    Street name.

    addressLine2 string

    Possible values: <= 60 characters

    Apartment, suite, unit, building, floor or other secondary address information.

    addressLine3 string

    Possible values: <= 60 characters

    Specific delivery instructions, department names, or additional floor information.

    city stringrequired

    Possible values: <= 50 characters

    The city or localitly of the address.

    countryCode stringrequired

    Possible values: >= 3 characters and <= 3 characters

    ISO-3 code of the address country (e.g., DEU for Germany).

    number string

    Possible values: <= 10 characters

    The house or building number corresponding to the street address.

    postCode stringrequired

    Possible values: <= 10 characters

    The postal or ZIP code of the address.

    state string

    Possible values: <= 3 characters

    3-letter code of the address state. Mandatory when countryCode corresponds to Canada or USA.

    requestDateTime date-time

    The date and time of the request.

    responseCode string

    The response code of the request.

    responseDescription string

    Description of the response.

    additionalInformation

    object

    Contains diagnostic or tracking metadata returned with the API response. It is primarily used for support, logging and troubleshooting purposes.

    requestId string

    The unique request ID.

Loading...
 Imprint
|
Data protection and privacy
© 2025 J.P. Morgan Mobility Payments Systems GmbH. All rights reserved.