PropertyAnalysisRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bountyapi-com/json-schema/bountyapi-com-property-analysis-request-schema.json",
  "title": "PropertyAnalysisRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/bountyapi-com-api-openapi.json#/components/schemas/PropertyAnalysisRequest",
  "properties": {
    "region": {
      "$ref": "#/$defs/Region",
      "description": "Region/country code. SG supported now; HK/AE/AU/JP planned.",
      "default": "SG"
    },
    "property_type": {
      "$ref": "#/$defs/apis__property_analysis__PropertyType",
      "description": "HDB or private property",
      "default": "hdb"
    },
    "property_price": {
      "type": "number",
      "exclusiveMinimum": 0.0,
      "title": "Property Price",
      "description": "Property price / asking price in SGD"
    },
    "town": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Town",
      "description": "HDB town (e.g. 'TAMPINES'). Required for HDB."
    },
    "flat_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Flat Type",
      "description": "HDB flat type (e.g. '4 ROOM')"
    },
    "postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Postal Code",
      "description": "Postal code for location intelligence"
    },
    "monthly_rent": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Monthly Rent",
      "description": "Expected monthly rent in SGD"
    },
    "buyer_profile": {
      "$ref": "#/$defs/apis__property_analysis__BuyerProfile",
      "description": "Buyer profile for stamp duty",
      "default": "SC"
    },
    "property_count": {
      "type": "integer",
      "minimum": 1.0,
      "title": "Property Count",
      "description": "Number of properties owned including this one",
      "default": 1
    },
    "monthly_income": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Monthly Income",
      "description": "Gross monthly income for affordability check"
    },
    "existing_monthly_debt": {
      "type": "number",
      "minimum": 0.0,
      "title": "Existing Monthly Debt",
      "description": "Existing monthly debt obligations",
      "default": 0
    },
    "loan_tenure_years": {
      "type": "integer",
      "maximum": 35.0,
      "minimum": 1.0,
      "title": "Loan Tenure Years",
      "default": 30
    },
    "borrower_age": {
      "type": "integer",
      "maximum": 75.0,
      "minimum": 21.0,
      "title": "Borrower Age",
      "default": 35
    }
  },
  "type": "object",
  "required": [
    "property_price"
  ],
  "$defs": {
    "Region": {
      "type": "string",
      "enum": [
        "SG",
        "HK",
        "AE",
        "AU",
        "JP"
      ],
      "title": "Region"
    },
    "apis__property_analysis__BuyerProfile": {
      "type": "string",
      "enum": [
        "SC",
        "SPR",
        "FR",
        "entity"
      ],
      "title": "BuyerProfile"
    },
    "apis__property_analysis__PropertyType": {
      "type": "string",
      "enum": [
        "hdb",
        "private"
      ],
      "title": "PropertyType"
    }
  }
}