Verify Response Messages
The Verify API will return a message object that will describe how well the given address has been matched. The purpose of this message is to help you communicate to the user if there is an issue with the address that's been passed.
This document will outline the messages that can be returned by the API, the unique ID for each and some examples.
Messages
Address Successfully Verified
ID: 1000
Message: "Address verified"
Severity: Information
Example: 8 Silver Birches, Millfarm, Dunboyne, Co. Meath A86 VC04
Address Successfully Verified with Changes
ID: 1010
Message: "Address verified, please note differences"
Severity: Information
Example: 25 Castle Park, Carrick on Suir, Co. Tipperary
Close Match – Review Minor Differences
ID: 2000
Message: "We found a close match, please note differences."
Severity: Warning
Example: 8 Silver Birches, Millfarm, Meath
Close Match – Review Major Differences
ID: 2010
Message: "To ensure timely delivery we suggest using this verified address."
Severity: Warning
Example: 8 Silver Birches, Millfarm, Dunkirk, Co. Meath
Close Match - Possible Building Number Mistyped
ID: 2020
Message: "Did you mistype the building number? We found a close match."
Severity: Warning
Example: 88 Silver Birches, Millfarm, Dunboyne, Co. Meath, A86 VC04
Close Match - Possible Street Name Mistyped
ID: 2030
Message: "Did you mistype the street name? We found a close match."
Severity: Warning
Example: 8 Silver Cloud, Millfarm, Dunboyne, Meath, A86 VC04
Address Does Not Match Eircode
ID: 2040
Message: "We changed the address to match Eircode."
Severity: Warning
Example: 8 Silver Cloud, Millfarm, Enniscorthy, Wexford, A86 VC04
Could Not Verify Address
ID: 3000
Message: "Could not verify this address. Are you sure it is correct?"
Severity: Warning
Example: 8 Delivermefrom Lane, Wallingfarm, Dunkirk, Wexford
Missing Unit or Apartment Number - Prompt
ID: 3010
Message: "Did you forget the unit or apartment number?"
Severity: Warning
Example: 82 Capel St, Dublin 1
Unmatched Address Element
ID: 3020
Message: "Could not find '{0}'. Please check the address is correct."
Severity: Warning
Example: Flat 66, 82 Capel St, Dublin 1
Missing Unit or Apartment Number - Confirmation
ID: 3030
Message: "Are you sure you haven't forgotten a unit or apartment number?"
Severity: Warning
Example: 52 Kennilworth Square South, Dublin 6
Street Name Not Found
ID: 3060
Message: "Could not find street name. Please check the address is correct."
Severity: Warning
Example: 52 Kennilworth Gardens, Dublin 6
Address Incomplete
ID: 3070
Message: "The address appears to be incomplete. Please check the address is correct."
Severity: Warning
Example: Silver Birches, Millfarm, Dunboyne, Co. Meath
Missing Eircode
ID: 3080
Message: "To ensure timely delivery we suggest providing your Eircode."
Severity: Warning
Example: Curelaim, Turlough, Castlebar, Co. Mayo
Delivery Not Possible
ID: 4000
Message: "We can't deliver to this address, please provide an alternative."
Severity: Error
Example: Location is not selected in Supported countries list in Integration settings
PO Box Not Deliverable
ID: 4010
Message: "We can't deliver to PO boxes. Please provide an alternative address."
Severity: Error
Example: Display PO Box addresses setting is turned off in Integration settings
