api.locus.report

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "additionalProperties": {},
      "properties": {
        "annualTaxUsd": {
          "type": "number"
        },
        "assessedValueUsd": {
          "type": "number"
        },
        "caveats": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "citation": {
          "type": "string"
        },
        "effectiveRatePct": {
          "type": "number"
        },
        "fetchedAt": {
          "type": "string"
        },
        "jurisdiction": {
          "additionalProperties": false,
          "properties": {
            "county": {
              "type": "string"
            },
            "state": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "kind": {
          "const": "property_tax",
          "type": "string"
        },
        "property": {
          "additionalProperties": {},
          "properties": {},
          "type": "object"
        },
        "servedFromCache": {
          "type": "boolean"
        },
        "situsAddress": {
          "type": "string"
        },
        "source": {
          "const": "RentCast",
          "type": "string"
        },
        "taxHistory": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "annualTaxUsd": {
                "type": "number"
              },
              "assessedValueUsd": {
                "type": "number"
              },
              "year": {
                "type": "number"
              }
            },
            "required": [
              "year"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "taxYear": {
          "type": "number"
        },
        "transfer": {
          "additionalProperties": {},
          "properties": {
            "history": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "date": {
                    "type": "string"
                  },
                  "event": {
                    "enum": [
                      "sale",
                      "deed_transfer",
                      "refinance_or_lien",
                      "assessment",
                      "unknown_public_record_event"
                    ],
                    "type": "string"
                  },
                  "priceUsd": {
                    "type": "number"
                  }
                },
                "required": [
                  "date"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "lastSaleDate": {
              "type": "string"
            },
            "lastSalePriceUsd": {
              "type": "number"
            },
            "ownerOccupiedIndicator": {
              "type": "boolean"
            }
          },
          "type": "object"
        }
      },
      "required": [
        "kind",
        "source",
        "jurisdiction",
        "citation",
        "servedFromCache",
        "caveats"
      ],
      "type": "object"
    },
    {
      "additionalProperties": {},
      "properties": {
        "charged": {
          "const": false,
          "type": "boolean"
        },
        "kind": {
          "const": "property_tax_diagnostic",
          "type": "string"
        },
        "note": {
          "type": "string"
        },
        "ok": {
          "const": true,
          "type": "boolean"
        },
        "reason": {
          "type": "string"
        },
        "residentialOnly": {
          "const": true,
          "type": "boolean"
        }
      },
      "required": [
        "kind",
        "charged",
        "ok",
        "residentialOnly",
        "reason",
        "note"
      ],
      "type": "object"
    }
  ],
  "description": "A `kind`-discriminated union: `property_tax` (assessed value + actual annual tax + history + effective rate + PII-free deed/transfer history + owner-occupied homestead-proxy signal, cited to RentCast) for a residential hit, or `property_tax_diagnostic` (charged:false) for a miss/commercial/uncovered address."
}