{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/propraven-com/json-schema/propraven-com-full-search-result-schema.json",
  "title": "FullSearchResult",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/propraven-com-search-api-openapi.yml#/components/schemas/FullSearchResult",
  "type": "object",
  "required": [
    "results",
    "total",
    "totalCapped",
    "page",
    "pages",
    "hasMore",
    "nextCursor"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "parcel_id",
          "apn",
          "county_fips",
          "state_fips",
          "site_address",
          "city",
          "zip5",
          "owner_name",
          "total_value",
          "latitude",
          "longitude"
        ],
        "properties": {
          "parcel_id": {
            "type": "string",
            "description": "PropRaven parcel UUID (not the county APN; see `apn`). Pass it to GET /parcels/{id}."
          },
          "apn": {
            "type": [
              "string",
              "null"
            ]
          },
          "county_fips": {
            "type": "string"
          },
          "state_fips": {
            "type": "string"
          },
          "site_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "zip5": {
            "type": [
              "string",
              "null"
            ]
          },
          "owner_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "total_value": {
            "type": [
              "integer",
              "null"
            ]
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ]
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ]
          },
          "fanout": {
            "type": "object",
            "additionalProperties": true,
            "description": "Present only on a row that heads a NY-style fan-out family (one parcel filed under several county FIPS, #552). `record_basis` is `home_county` (the row's point lies in its own county box) or `possible_fanout_copy` (no home row was in the result; `likely_county` names the county the point falls in). `copies_suppressed`, their county FIPS and ids list every copy folded onto this row. Served county_fips and values are never rewritten; a copy's sale price equal to its assessed value is listed under `value_flags` with the raw value."
          }
        },
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer"
    },
    "totalCapped": {
      "type": "boolean"
    },
    "page": {
      "type": "integer"
    },
    "pages": {
      "type": "integer"
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "code",
          "param",
          "message"
        ],
        "properties": {
          "code": {
            "type": [
              "string",
              "null"
            ]
          },
          "param": {
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "total_is_capped": {
      "type": "boolean"
    },
    "fanout_collapse": {
      "type": "object",
      "additionalProperties": true,
      "description": "Present only when fan-out copies were collapsed (#552): the number of copies suppressed, the families and `complete`; `complete: false` with `copies_suppressed: null` when the check could not run (the totals then include any copies). The witness is the county extent table (county_bbox.json), never the served county_fips."
    }
  },
  "additionalProperties": false
}