Get List of Addresses

GET https://api.subscriptiongenius.com/2/addresses/
Request Parameters
Paramater Description Required Default Data Type
subscriber_id Searches by subscriber. Yes Integer
city Filter by city name No String (50)
company Filter by company name No String (50)
country_name Filter by country name No String (50)
first_name Filter by first name on address No String (50)
last_name Filter by last name on address No String (50)
state Search by state. USA is abbreviated. No String (50)
zip_code Search by zip code. No String (12)
Response Parameters
Paramater Description Data Type
address Address line String (50)
addresses Array of addresses Array
address_id Unique address identifier Integer
city City on address String (50)
company Company name on address String (50)
country_abbreviation Country abbreviated on address String (5)
country_name Full name of country on address String (25)
first_name First name on address String (50)
last_name Last name on address String (50)
latitude Latitude coordinates of address Float
longitude Longitude coordinates of address Float
state State on address. USA states abbreviated to 2 letters String (25)
subscriber_id Unique reference id to subscriber Integer
verified Address has been validated by USPS Bool
zip_code Zip/Postal code or postal code on address String(15)
Example Request 
{
  "subscriber_id":9
}
Example Response 
{
  "addresses":[
    {
      "first_name":"Sarah",
      "last_name":"Halawani",
      "line1":"1653 OCEAN PKWY",
      "company":"",
      "city":"BROOKLYN",
      "state":"NY",
      "subscriber_id":null,
      "country_name":"United States",
      "country_abbreviation":"USA",
      "latitude":"40.6085",
      "longitude":"-73.9675",
      "verified":true
    },
    {
      "first_name":"Jean",
      "last_name":"Mizrahi",
      "line1":"1733 OCEAN PKWY",
      "company":"",
      "city":"BROOKLYN",
      "state":"NY",
      "subscriber_id":null,
      "country_name":"United States",
      "country_abbreviation":"USA",
      "latitude":"40.6065",
      "longitude":"-73.9671",
      "verified":true
    },
    {
      "first_name":"Karen",
      "last_name":"Mizrahi",
      "line1":"11 PLEASANT DR",
      "company":"",
      "city":"WEST LONG BRANCH",
      "state":"NJ",
      "subscriber_id":null,
      "country_name":"United States",
      "country_abbreviation":"USA",
      "latitude":"40.276",
      "longitude":"-74.0143",
      "verified":true
    }
  ]
}