{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://realtor.com/schemas/realtor/lead.json",
  "title": "Realtor.com Lead",
  "description": "Schema representing a real estate lead delivered from Realtor.com to a CRM system via the Connections Plus or Lead Delivery API. Captures buyer and seller lead contact information, associated property details, financial qualification data, and transaction likelihood scores.",
  "type": "object",
  "required": ["lead_id", "role", "contact", "timestamp"],
  "properties": {
    "lead_id": {
      "type": "string",
      "description": "Unique identifier for the lead assigned by Realtor.com."
    },
    "role": {
      "type": "string",
      "description": "Role of the lead indicating whether they are a buyer or seller.",
      "enum": ["buyer", "seller"]
    },
    "contact": {
      "$ref": "#/$defs/Contact"
    },
    "property": {
      "$ref": "#/$defs/Property"
    },
    "finance_info": {
      "$ref": "#/$defs/FinanceInfo"
    },
    "listing_agent": {
      "$ref": "#/$defs/ListingAgent"
    },
    "source": {
      "type": "string",
      "description": "Source of the lead on Realtor.com such as listing page, search results, or recommendation."
    },
    "message": {
      "type": "string",
      "description": "Optional message from the consumer expressing their interest or asking questions."
    },
    "is_likely_to_transact": {
      "type": "boolean",
      "description": "Indicator of whether the lead is likely to complete a real estate transaction."
    },
    "probability_to_transact": {
      "type": "number",
      "description": "Probability score from 0 to 1 indicating how likely the lead is to complete a transaction.",
      "minimum": 0,
      "maximum": 1
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp when the lead was generated."
    },
    "digital_signature": {
      "type": "string",
      "description": "Optional digital signature for verifying the authenticity and integrity of the lead data."
    }
  },
  "$defs": {
    "Contact": {
      "type": "object",
      "description": "Contact information for the lead.",
      "required": ["email"],
      "properties": {
        "first_name": {
          "type": "string",
          "description": "First name of the lead.",
          "maxLength": 100
        },
        "last_name": {
          "type": "string",
          "description": "Last name of the lead.",
          "maxLength": 100
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "Email address of the lead."
        },
        "phone": {
          "type": "string",
          "description": "Phone number of the lead.",
          "pattern": "^[+]?[0-9\\-\\s()]+$"
        }
      }
    },
    "Property": {
      "type": "object",
      "description": "Property information associated with the lead.",
      "properties": {
        "listing_url": {
          "type": "string",
          "format": "uri",
          "description": "URL of the property listing on Realtor.com."
        },
        "address": {
          "type": "string",
          "description": "Full street address of the property."
        },
        "city": {
          "type": "string",
          "description": "City where the property is located."
        },
        "state": {
          "type": "string",
          "description": "Two-letter state abbreviation.",
          "pattern": "^[A-Z]{2}$",
          "minLength": 2,
          "maxLength": 2
        },
        "zip_code": {
          "type": "string",
          "description": "Five-digit ZIP code of the property.",
          "pattern": "^[0-9]{5}$"
        },
        "latitude": {
          "type": "number",
          "description": "Latitude coordinate of the property.",
          "minimum": -90,
          "maximum": 90
        },
        "longitude": {
          "type": "number",
          "description": "Longitude coordinate of the property.",
          "minimum": -180,
          "maximum": 180
        },
        "mls_id": {
          "type": "string",
          "description": "MLS listing identifier."
        },
        "mls_name": {
          "type": "string",
          "description": "Name of the MLS that holds the listing."
        },
        "listing_status": {
          "type": "string",
          "description": "Current listing status.",
          "enum": ["active", "pending", "sold", "off_market"]
        },
        "list_price": {
          "type": "number",
          "description": "Listing price in dollars.",
          "minimum": 0
        },
        "beds": {
          "type": "integer",
          "description": "Number of bedrooms.",
          "minimum": 0
        },
        "baths": {
          "type": "integer",
          "description": "Number of bathrooms.",
          "minimum": 0
        },
        "sqft": {
          "type": "integer",
          "description": "Interior square footage.",
          "minimum": 0
        },
        "property_type": {
          "type": "string",
          "description": "Type of property.",
          "enum": ["single_family", "multi_family", "condo", "townhome", "mobile", "land", "farm"]
        },
        "active_days_on_market": {
          "type": "integer",
          "description": "Number of days the property has been actively listed.",
          "minimum": 0
        }
      }
    },
    "FinanceInfo": {
      "type": "object",
      "description": "Financial qualification information provided by the buyer.",
      "properties": {
        "pre_approved": {
          "type": "boolean",
          "description": "Whether the buyer is pre-approved for a mortgage."
        },
        "budget_min": {
          "type": "number",
          "description": "Minimum budget in dollars.",
          "minimum": 0
        },
        "budget_max": {
          "type": "number",
          "description": "Maximum budget in dollars.",
          "minimum": 0
        },
        "financing_type": {
          "type": "string",
          "description": "Type of financing intended such as conventional, FHA, VA, or cash.",
          "enum": ["conventional", "fha", "va", "cash", "other"]
        }
      }
    },
    "ListingAgent": {
      "type": "object",
      "description": "Listing agent contact information associated with the property.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Full name of the listing agent."
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "Email address of the listing agent."
        },
        "phone": {
          "type": "string",
          "description": "Phone number of the listing agent."
        }
      }
    }
  }
}