# Get Lead Property Details

Endpoint: GET /api/v1/address-info
Version: 1.0.0

## Header parameters:

  - `Accept` (string)
    Example: "application/json"

  - `token` (string)
    Example: "{API Key}"

## Query parameters:

  - `streetNumber` (string, required)
    Lead's street number.

  - `streetAddress` (string, required)
    Lead's street address.

  - `city` (string, required)
    Lead’s city name.

  - `state` (string, required)
    Lead's state name (two-letter abbreviation, e.g., NY).

  - `zip` (string, required)
    Lead’s zip code (5 digit code).

## Response 200 fields (application/json):

  - `timestamp` (string)
    The timestamp when the response was returned. It is provided in ISO 8601 format.
    Example: "2024-08-20T14:30:00Z"

  - `primaryOwner` (string,null)
    Full name of the primary owner.
    Example: "John M Doe"

  - `secondaryOwner` (string,null)
    Full name of the secondary owner.
    Example: "Jane Doe"

  - `ownerOccupied` (boolean,null)
    Indicates whether the property is occupied by the owner.
    Example: true

  - `homeBuiltYear` (string,null)
    The year the primary structure was built.
    Example: "1990"

  - `yearsInHome` (string,null)
    The number of years the primary owner has owned the property.
    Example: "16"

  - `county` (string,null)
    County name.
    Example: "Douglas"

  - `subdivision` (string,null)
    Subdivision name.
    Example: "Castle Oaks"

  - `school` (string,null)
    School district name.
    Example: "Somerville"

  - `propertyType` (string,null)
    General property type description.
    Example: "Residential"

  - `areaBuildingSize` (string,null)
    Total square feet of all structures on the property.
    Example: "3023"

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad Request"

  - `statusCode` (integer)
    Example: 400

  - `message` (array)
    Example: ["state must be a string","state should not be empty"]

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Unauthorized"

  - `statusCode` (integer)
    Example: 401

  - `message` (string)
    Example: "Invalid API Key"

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Not Found"

  - `statusCode` (integer)
    Example: 404

  - `message` (string)
    Example: "Cannot GET /api/v1/address-info"

## Response 500 fields (application/json):

  - `error` (string)
    Example: "Internal Server Error"

  - `statusCode` (integer)
    Example: 500

  - `message` (string)
    Example: "Unexpected server error occurred. Please try again later."