Example: Addressing Verify JSON Request & Response

JSON Request

Using the Addressing API, the following is an example of a JSON request for the Verify Service. In this example, ADDRESS_CASING is enabled in customPreferences.

{
  "preferences": {
    "maxResults": 1,
    "returnAllInfo": true,
    "factoryDescription": {
      "label": "global_locator",
      "featureSpecific": {}
    },
    "customPreferences": {
     "ADDRESS_CASING": "UPPER"
   }
  },
  "addresses": [
    {
      "addressLines": [
        "Unit 1/10",
        "Enterprise Drive"
      ],
      "country": "GBR",
      "addressNumber": "",
      "admin1": "",
      "admin2": "",
      "city": "Westhill",
      "postalCode": "AB32 6TQ",
      "postalCodeExt": "",
      "placeName": "Elmar Services Ltd."
    }
  ]
}

JSON Response

The following shows the JSON response returned by the previous request.

{
  "responses": [
    {
      "status": "OK",
      "results": [
        {
          "score": 100,
          "address": {
            "formattedAddress": "ELMAR SERVICES LTD., ENTERPRISE DRIVE, WESTHILL, AB32 6TQ",
            "formattedStreetAddress": "ELMAR SERVICES LTD.ENTERPRISE DRIVE",
            "formattedLocationAddress": "WESTHILL AB32 6TQ",
            "country": {
              "name": "UNITED KINGDOM",
              "isoAlpha3Code": "GBR"
            },
            "admin1": {},
            "city": {
              "longName": "WESTHILL",
              "shortName": "WESTHILL"
            },
            "postalCode": "AB32 6TQ",
            "placeName": "ELMAR SERVICES LTD.",
            "street": "ENTERPRISE DRIVE"
          },
          "addressLines": [
            "ELMAR SERVICES LTD.",
            "UNIT 1/10",
            "ENTERPRISE DRIVE",
            "WESTHILL INDUSTRIAL ESTATE",
            "WESTHILL",
            "AB32 6TQ",
            "UNITED KINGDOM"
          ],
          "explanation": {
            "addressMatch": {
              "type": "STREET",
              "description": [
                {
                  "label": "placeName",
                  "matchType": "NONE"
                },
                {
                  "label": "addressNumber",
                  "matchType": "NONE"
                },
                {
                  "label": "admin1",
                  "matchType": "NONE"
                },
                {
                  "label": "admin2",
                  "matchType": "NONE"
                },
                {
                  "label": "city",
                  "matchType": "EXACT"
                },
                {
                  "label": "neighborhood",
                  "matchType": "ADDED",
                  "returnType": "PREFERRED"
                },
                {
                  "label": "suburb",
                  "matchType": "NONE"
                },
                {
                  "label": "street",
                  "matchType": "EXACT"
                },
                {
                  "label": "postalCode",
                  "matchType": "EXACT"
                },
                {
                  "label": "streetType",
                  "matchType": "NONE"
                },
                {
                  "label": "postalCodeExt",
                  "matchType": "NONE"
                },
                {
                  "label": "streetDirectional",
                  "matchType": "NONE"
                }
              ]
            },
            "source": {
             "label": "global_locator"
            }
          },
          "customFields": {
            "SUBBUILDING": "UNIT 1/10",
            "SUBCITY": "WESTHILL INDUSTRIAL ESTATE",
            "DATASTOREDATASET": "GBR",
            "ACR": "L4-P0S4A6T4R0Z4C4-100",
            "VALIDATIONRULE": "CoBoPoSeXoCeRoPe",
            "OUTERMATCHSCORE": "0",
            "CONFIDENCE": "100",
            "EXTENDEDACR": "L4-D0M2B0U4P0S4Q0X0A6T4E0R0W0Z4Y0C4-100",
            "VALIDATIONDATASET": "GBR",
            "PRECISION_CODE": "S4-PNTSCZA"
          }
        }
      ]
    }
  ]
}