v1

latestOpenAPI 3.1.02026-08-0666136.4 KB
Address Search

Search for Information on an Address

get/addresses

Query parameters

streetstring required

street and address

citystring required

city name

statestring required

US state; can be abbreviated

unitstring

unit number or letter

position_tokeninteger

page/position token of the address response

Response

OK

position_tokenstring

Example response

{
  "data": {
    "address": {
      "street_address": "123 Main St",
      "city": "Anytown",
      "county": "Los Angeles",
      "state": "CA",
      "latitude": 40.689247,
      "longitude": -74.0451471,
      "nearby_schools": [
        {
          "name": "MP Montessori School",
          "address": {
            "street_address": "123 Main St Ave",
            "city": "Anytown",
            "state": "CA"
          },
          "grades_served": "PK-KG",
          "type": "Private",
          "enrollment_count": 34,
          "rating": "B-",
          "district_name": "Los Angeles Unified"
        }
      ],
      "properties": [
        {
          "valuations": [
            {
              "confidence_score": 95,
              "date": "2021-11-24",
              "forecast_standard_deviation": 5,
              "market_value": 1327500,
              "market_value_max": 1393875,
              "market_value_min": 1261125
            }
          ],
          "residents": [
            {
              "names": [
                {
                  "full_name": "John James Smith",
                  "first_name": "John",
                  "middle_name": "James",
                  "last_name": "Smith",
                  "name_type": "main"
                }
              ],
              "age": 51,
              "dob_month": 8,
              "dob_year": 2023,
              "lives_at_property": true,
              "addresses": [
                {
                  "city": "Anytown",
                  "latitude": 40.689247,
                  "longitude": -74.0451471,
                  "street_address": "123 Main St Apt 8",
                  "country": "US",
                  "state": "CA",
                  "url_path": "/CA/Anytown/123-Anytown-St"
                }
              ],
              "relatives": [
                {
                  "names": [
                    {
                      "full_name": "Jane Doe"
                    }
                  ]
                }
              ],
              "phones": [
                {
                  "phones": {
                    "is_best": true
                  }
                }
              ],
              "emails": [
                {
                  "emails": {
                    "email": "jdoe@email.com",
                    "is_best": true
                  }
                }
              ],
              "phone_record_count": 3,
              "address_count": 2,
              "email_record_count": 1,
              "start_date": "2024-05-05",
              "end_date": "2024-05-05",
              "first_processed": "2024-05-05",
              "last_processed": "2024-05-05",
              "confidence_score": 1.8
            }
          ],
          "owners": [
            {
              "names": [
                {
                  "first_name": "John",
                  "last_name": "Doe",
                  "middle_name": "James",
                  "full_name": "John James Doe",
                  "name_type": "main"
                }
              ],
              "ownership_type": "Individual",
              "ownership_start_date": "1999-02-25",
              "ownership_end_date": "1999-02-25",
              "phones": [
                {
                  "phones": {
                    "is_best": true
                  }
                }
              ],
              "emails": [
                {
                  "emails": {
                    "email": "jdoe@email.com",
                    "is_best": true
                  }
                }
              ],
              "addresses": [
                {
                  "city": "Anytown",
                  "latitude": 40.689247,
                  "longitude": -74.0451471,
                  "street_address": "123 Main St Apt 8",
                  "country": "US",
                  "state": "CA",
                  "url_path": "CA/Anytown/123-Anytown-St"
                }
              ]
            }
          ],
          "property_info": {
            "zoned_use": "Single Family Residence",
            "living_area_sqft": 2652,
            "bath_count": 4.5,
            "bed_count": 3,
            "heating_type": "Central",
            "cooling_type": "Central",
            "garage_type": "Detached",
            "story_count": 2,
            "structure_style": "Bungalow",
            "view_type": "Beach",
            "pool_type": "Square",
            "fireplace": "None",
            "year_built": 1904,
            "lot_sqft": 15120,
            "unit_count": 1,
            "garage_sqft": 360,
            "type": "single_family",
            "carport_sqft": 280,
            "parking_space_count": 2,
            "use_type": "Residential",
            "foundation_type": "Concrete",
            "attic_sqft": 380,
            "has_attic": true,
            "basement_sqft": 280,
            "basement_sqft_finished": 280,
            "porch_type": "None",
            "roof_construction": "Pitched",
            "roof_material": "Shingles",
            "floor_material": "Concrete",
            "sewage_type": "Underground",
            "is_multi_floor": true,
            "parcel_number": 3254125856,
            "zoned_use_jurisdiction_code": "LAR1",
            "fence_type": "Picket",
            "area_fence": 280,
            "flood_zone_description": "This property is located in a minimal flood risk area"
          },
          "tax": {
            "assessor": {
              "last_sold_date": "1997-06-25",
              "last_sold_price": 192500,
              "last_sold_price_per_sqft": 72,
              "parties": [
                {
                  "names": [
                    {
                      "full_name": "John Doe",
                      "suffix": "Jr."
                    }
                  ]
                }
              ]
            },
            "history": [
              {
                "year": 2020,
                "billed_amount": 4525,
                "total_assessed_value": 371709,
                "improvement_value": 170674,
                "land_value": 201035
              }
            ]
          },
          "deed": {
            "buyers": [
              {
                "names": [
                  {
                    "full_name": "John Doe",
                    "suffix": "Jr."
                  }
                ]
              }
            ],
            "last_sale": {
              "price": 192500,
              "date": "1997-06-25",
              "price_per_sqft": 72
            }
          },
          "sellability": {
            "retail_score": 461,
            "retail_score_date": "2021-10-29",
            "wholesale_score": 10,
            "wholesale_score_date": "2021-10-29",
            "investor_score": 504,
            "investor_score_date": "2021-10-29"
          },
          "units": [
            {
              "designator": "5A",
              "bath_count": 2,
              "bed_count": 3,
              "zoned_use": "Residential",
              "living_sqft": 2000,
              "year_built": 1973,
              "residents": [
                {
                  "names": [
                    {
                      "full_name": "John M Doe"
                    }
                  ]
                }
              ]
            }
          ],
          "addresses": [
            {
              "city": "Anytown",
              "latitude": 40.689247,
              "longitude": -74.0445,
              "street_address": "123 Main St",
              "zip": "10001",
              "state": "CA",
              "county": "New York",
              "url_path": "/CA/Anytown/123-Main-St"
            }
          ]
        }
      ]
    }
  },
  "position_token": "Mg=="
}