{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/housedata-uk/json-schema/housedata-uk-score-request-schema.json",
  "title": "ScoreRequest",
  "description": "Provide a postcode or a UPRN (or both).",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/housedata-uk-openapi.json#/components/schemas/ScoreRequest",
  "type": "object",
  "anyOf": [
    {
      "required": [
        "postcode"
      ]
    },
    {
      "required": [
        "uprn"
      ]
    }
  ],
  "properties": {
    "postcode": {
      "type": "string",
      "description": "UK postcode, any spacing."
    },
    "uprn": {
      "type": "string",
      "description": "Unique Property Reference Number. Strongly recommended."
    },
    "lat": {
      "type": "number"
    },
    "lon": {
      "type": "number"
    },
    "address": {
      "type": "string"
    },
    "property_type": {
      "type": "string",
      "description": "e.g. detached, semi-detached, terraced, flat."
    },
    "skip_cache": {
      "type": "boolean",
      "default": false,
      "description": "Force a fresh score (single-property endpoint only)."
    }
  }
}