Sample Request and Response

Following are the sample request & response:

Request Body:

{
    "preferences": {
        "maxCandidates": "20",
        "page": "1"
    },
    "geometry": {
        "type": "Polygon",
        "crs": {
            "type": "name",
            "properties": {
                "name": "epsg:4326"
            }
        },
        "coordinates": [
            [
                -74.4234467,
                40.7541435
            ],
            [
                -74.3904877,
                40.7489001
            ],
            [
                -74.380188,
                40.7587776
            ],
            [
                -74.3891144,
                40.7748904
            ],
            [
                -74.4179535,
                40.7790479
            ],
            [
                -74.4316864,
                40.7665746
            ],
            [
                -74.4241333,
                40.7566983
            ],
            [
                -74.4234467,
                40.7541435
            ]
        ]
    }
}

Response Body

{
    "page": "1",
    "candidates": "20",
    "addressList": [
        {
            "pbKey": "P0000FNZF6SG",
            "addressNumber": "93",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2803",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6UD",
            "addressNumber": "24",
            "streetName": "ELMWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2810",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6S4",
            "addressNumber": "78",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2822",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6UP",
            "addressNumber": "15",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6U8",
            "addressNumber": "34",
            "streetName": "ELMWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2810",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6ST",
            "addressNumber": "94",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2822",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6SE",
            "addressNumber": "89",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2803",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6UY",
            "addressNumber": "23",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6UB",
            "addressNumber": "28",
            "streetName": "ELMWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2810",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6S2",
            "addressNumber": "82",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2822",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6VH",
            "addressNumber": "47",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6UT",
            "addressNumber": "18",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2816",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6VY",
            "addressNumber": "52",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2816",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6SB",
            "addressNumber": "83",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2803",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6VE",
            "addressNumber": "41",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6V3",
            "addressNumber": "33",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P02",
                "description": "PARCEL CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6SD",
            "addressNumber": "87",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2803",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6S9",
            "addressNumber": "79",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P02",
                "description": "PARCEL CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2803",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6VS",
            "addressNumber": "59",
            "streetName": "SHERBROOKE DR",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2815",
            "country": "USA"
        },
        {
            "pbKey": "P0000FNZF6S1",
            "addressNumber": "84",
            "streetName": "BEECHWOOD RD",
            "unitType": "",
            "unitValue": "",
            "type": {
                "value": "P05",
                "description": "STRUCTURE CENTROID"
            },
            "areaName1": "NJ",
            "areaName3": "FLORHAM PARK",
            "postCode": "07932",
            "postCodeExt": "2822",
            "country": "USA"
        }
    ]
}