# CRE Layer property API reference Private development API. Bearer authentication is required for county and property data. Use /counties to check current coverage and limitations before querying. Amounts are integer USD cents. County assessments are not market-value estimates. Unknown filters are rejected. Keep filters and order unchanged when paging with nextCursor. A cursor_expired response requires restarting the query against the current dataset. ## OpenAPI contract ```json { "openapi": "3.1.0", "info": { "title": "CRE Layer property API", "version": "2026-09-13", "description": "Official county facts for commercial parcels with exact coverage, per-field availability and provenance. Read /llms.txt for the rules an agent must follow." }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "CRE Layer API key" } }, "schemas": {} }, "paths": { "/health": { "get": { "summary": "Liveness and the number of counties in the serving catalog", "tags": [ "Operations" ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "environment", "release", "catalogCounties" ], "properties": { "status": { "type": "string", "enum": [ "ok" ] }, "environment": { "type": "string" }, "release": { "type": "string" }, "catalogCounties": { "type": "integer" } } } } } } } } }, "/counties": { "get": { "summary": "Every served county with dataset, counts, field availability and caveats", "tags": [ "Coverage" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "counties": { "type": "array", "items": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "name": { "type": "string", "minLength": 1 }, "servedParcelCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "retainedParcelCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "assessment": { "anyOf": [ { "type": "object", "properties": { "taxYear": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "valueBasis": { "type": "string", "enum": [ "county_assessed", "county_full_cash", "county_market_labeled", "county_defined" ] }, "publicationStatus": { "anyOf": [ { "type": "string", "enum": [ "preliminary", "certified" ] }, { "type": "null" } ] } }, "required": [ "taxYear", "valueBasis", "publicationStatus" ], "additionalProperties": false }, { "type": "null" } ] }, "fields": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "coordinates", "landAreaSqFt", "structures", "grossBuildingAreaSqFt", "netBuildingAreaSqFt", "yearBuilt", "unitCount", "assessment", "sales", "zoning" ] }, "status": { "type": "string", "enum": [ "published", "partial", "not_published" ] }, "populatedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "field", "status", "populatedCount" ], "additionalProperties": false } }, "sourcePage": { "type": "string", "format": "uri" }, "sourceArtifacts": { "type": "array", "items": { "type": "object", "properties": { "artifactId": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "fetchedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "artifactId", "url", "sha256", "fetchedAt" ], "additionalProperties": false } }, "caveats": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "countyId", "state", "name", "servedParcelCount", "retainedParcelCount", "dataset", "assessment", "fields", "sourcePage", "sourceArtifacts", "caveats" ], "additionalProperties": false } } }, "required": [ "meta", "counties" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/counties/{countyId}": { "get": { "summary": "One county's coverage", "tags": [ "Coverage" ], "parameters": [ { "schema": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "in": "path", "name": "countyId", "required": true } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "county": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "name": { "type": "string", "minLength": 1 }, "servedParcelCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "retainedParcelCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "assessment": { "anyOf": [ { "type": "object", "properties": { "taxYear": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "valueBasis": { "type": "string", "enum": [ "county_assessed", "county_full_cash", "county_market_labeled", "county_defined" ] }, "publicationStatus": { "anyOf": [ { "type": "string", "enum": [ "preliminary", "certified" ] }, { "type": "null" } ] } }, "required": [ "taxYear", "valueBasis", "publicationStatus" ], "additionalProperties": false }, { "type": "null" } ] }, "fields": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "coordinates", "landAreaSqFt", "structures", "grossBuildingAreaSqFt", "netBuildingAreaSqFt", "yearBuilt", "unitCount", "assessment", "sales", "zoning" ] }, "status": { "type": "string", "enum": [ "published", "partial", "not_published" ] }, "populatedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "field", "status", "populatedCount" ], "additionalProperties": false } }, "sourcePage": { "type": "string", "format": "uri" }, "sourceArtifacts": { "type": "array", "items": { "type": "object", "properties": { "artifactId": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "fetchedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "artifactId", "url", "sha256", "fetchedAt" ], "additionalProperties": false } }, "caveats": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "countyId", "state", "name", "servedParcelCount", "retainedParcelCount", "dataset", "assessment", "fields", "sourcePage", "sourceArtifacts", "caveats" ], "additionalProperties": false } }, "required": [ "meta", "county" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/properties:query": { "post": { "summary": "Structured query over served parcels across counties", "tags": [ "Properties" ], "description": "Filters combine with AND; list-valued filters OR within the list. Results are deterministic under orderBy; totalMatches is exact across evaluated counties. Page with nextCursor and identical counties, filters and order. Each result row embeds a property-scoped context for that row's county, parcel and dataset; the context is additive and never drops, fails or reorders rows.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "countyIds": { "description": "Counties to search. Omit for every covered county.", "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" } }, "filters": { "default": {}, "type": "object", "properties": { "assetTypes": { "description": "OR within this list; AND with every other filter.", "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "enum": [ "industrial", "retail", "office", "multifamily", "hospitality", "land", "mixed_use", "special_purpose", "public_civic", "other_commercial" ] } }, "text": { "description": "Address fragment or parcel identifier prefix, matched against the county-reported situs.", "type": "string", "minLength": 2, "maxLength": 160 }, "situsCities": { "description": "County-reported situs city, matched case-insensitively; not a municipal boundary.", "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "situsPostalCodes": { "description": "First five digits of the county-reported situs ZIP.", "minItems": 1, "maxItems": 50, "type": "array", "items": { "type": "string", "pattern": "^[0-9]{5}$" } }, "countyUseCodes": { "description": "Exact source use-code strings, leading zeroes retained. Codes are county-specific; combine with a single county.", "minItems": 1, "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 32 } }, "landAreaSqFt": { "description": "Parcel land area. Parcels without a published land area never match.", "type": "object", "properties": { "gte": { "type": "number", "exclusiveMinimum": 0 }, "lte": { "type": "number", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "grossBuildingAreaSqFt": { "description": "Sum of gross building area across the parcel's structures; only parcels where every structure reports it can match.", "type": "object", "properties": { "gte": { "type": "number", "exclusiveMinimum": 0 }, "lte": { "type": "number", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "netBuildingAreaSqFt": { "description": "Sum of net building area across the parcel's structures; only parcels where every structure reports it can match.", "type": "object", "properties": { "gte": { "type": "number", "exclusiveMinimum": 0 }, "lte": { "type": "number", "exclusiveMinimum": 0 } }, "additionalProperties": false }, "yearBuilt": { "description": "Matches when any structure on the parcel was built in the range.", "type": "object", "properties": { "gte": { "type": "integer", "minimum": 1700, "maximum": 2200 }, "lte": { "type": "integer", "minimum": 1700, "maximum": 2200 } }, "additionalProperties": false }, "unitCount": { "description": "Sum of published unit counts across structures.", "type": "object", "properties": { "gte": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "lte": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "assessmentTotalCents": { "description": "County total assessed or market-labeled value in integer USD cents for the county's current roll. Never an asking price or estimate.", "type": "object", "properties": { "gte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "lastSalePriceCents": { "description": "Price of the most recent qualified sale in integer USD cents.", "type": "object", "properties": { "gte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "lastSaleDate": { "description": "Date of the most recent qualified sale, ISO calendar dates.", "type": "object", "properties": { "gte": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "lte": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "additionalProperties": false }, "hasCoordinates": { "description": "Require (or exclude) parcels with published coordinates.", "type": "boolean" } }, "additionalProperties": false }, "orderBy": { "default": "parcel", "description": "Deterministic ordering. Ties and null values fall back to county then parcel order; parcels lacking the ordering field sort last.", "type": "string", "enum": [ "parcel", "assessment_total_desc", "assessment_total_asc", "land_area_desc", "gross_building_area_desc", "last_sale_date_desc" ] }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "description": "Opaque page token from a previous response. It is bound to the datasets it was issued for.", "type": "string", "minLength": 1, "maxLength": 2048 } }, "additionalProperties": false } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "results": { "type": "array", "items": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 }, "parcelDisplayId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "situs": { "type": "object", "properties": { "line1": { "type": "string", "minLength": 1 }, "line2": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "city": { "type": "string", "minLength": 1 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "postalCode": { "type": "string", "pattern": "^\\d{5}(?:-\\d{4})?$" } }, "required": [ "line1", "line2", "city", "state", "postalCode" ], "additionalProperties": false }, "coordinates": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ] }, "assetType": { "type": "string", "enum": [ "industrial", "retail", "office", "multifamily", "hospitality", "land", "mixed_use", "special_purpose", "public_civic", "other_commercial" ] }, "countyUseCode": { "type": "string", "minLength": 1 }, "countyUseDescription": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "landAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "structureCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "grossBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "netBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "yearBuiltEarliest": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "yearBuiltLatest": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "unitCount": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "assessment": { "anyOf": [ { "type": "object", "properties": { "taxYear": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "totalCents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "valueBasis": { "type": "string", "enum": [ "county_assessed", "county_full_cash", "county_market_labeled", "county_defined" ] }, "publicationStatus": { "anyOf": [ { "type": "string", "enum": [ "preliminary", "certified" ] }, { "type": "null" } ] } }, "required": [ "taxYear", "totalCents", "valueBasis", "publicationStatus" ], "additionalProperties": false }, { "type": "null" } ] }, "lastQualifiedSale": { "anyOf": [ { "type": "object", "properties": { "saleDate": { "type": "string" }, "priceCents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "saleDate", "priceCents" ], "additionalProperties": false }, { "type": "null" } ] }, "context": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "available" ] }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "point": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "crs": { "type": "string", "enum": [ "EPSG:4326" ] } }, "required": [ "latitude", "longitude", "crs" ], "additionalProperties": false }, { "type": "null" } ] }, "freshness": { "type": "object", "properties": { "generatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "snapshotVersion": { "type": "string", "enum": [ "1.0.0" ] }, "cache": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "miss", "hit" ] }, "ttlSeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "ttlSeconds", "expiresAt" ], "additionalProperties": false } }, "required": [ "generatedAt", "dataAsOf", "snapshotVersion", "cache" ], "additionalProperties": false }, "modules": { "type": "object", "properties": { "naipImageryMetadata": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] }, "femaNfhl": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] } }, "required": [ "naipImageryMetadata", "femaNfhl" ], "additionalProperties": false } }, "required": [ "status", "property", "dataset", "point", "freshness", "modules" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "county_not_covered", "data_unavailable", "not_found", "out_of_scope", "timeout", "batch_row_limit", "batch_budget_exceeded", "enrichment_error" ] }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "anyOf": [ { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, { "type": "null" } ] }, "point": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "crs": { "type": "string", "enum": [ "EPSG:4326" ] } }, "required": [ "latitude", "longitude", "crs" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "status", "reason", "property", "dataset", "point" ], "additionalProperties": false } ], "description": "Property-scoped NAIP catalog metadata and FEMA NFHL point zone/panel facts for this row's stored coordinates, or an explicit unavailable reason. Missing coordinates are not_evaluable and are never geocoded." } }, "required": [ "countyId", "parcelId", "parcelDisplayId", "situs", "coordinates", "assetType", "countyUseCode", "countyUseDescription", "landAreaSqFt", "structureCount", "grossBuildingAreaSqFt", "netBuildingAreaSqFt", "yearBuiltEarliest", "yearBuiltLatest", "unitCount", "assessment", "lastQualifiedSale", "context" ], "additionalProperties": false } }, "totalMatches": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "nextCursor": { "type": [ "null", "string" ] }, "counties": { "type": "array", "items": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "status": { "type": "string", "enum": [ "evaluated", "not_evaluable", "not_covered" ] }, "reason": { "type": [ "null", "string" ] }, "matchCount": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "dataset": { "anyOf": [ { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "countyId", "status", "reason", "matchCount", "dataset" ], "additionalProperties": false } }, "contextSummary": { "type": "object", "properties": { "requestedRows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "attemptedRows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "availableRows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "unavailableRows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "notAttemptedRows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "budgetMs": { "type": "integer", "minimum": 500, "maximum": 30000 }, "maxRows": { "type": "integer", "minimum": 1, "maximum": 100 }, "concurrency": { "type": "integer", "minimum": 1, "maximum": 16 } }, "required": [ "requestedRows", "attemptedRows", "availableRows", "unavailableRows", "notAttemptedRows", "truncated", "budgetMs", "maxRows", "concurrency" ], "additionalProperties": false } }, "required": [ "meta", "results", "totalMatches", "nextCursor", "counties", "contextSummary" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/properties:resolve": { "post": { "summary": "Resolve a parcel identifier or an address to one served parcel", "tags": [ "Properties" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "by": { "type": "string", "enum": [ "parcel" ] }, "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "by", "countyId", "parcelId" ], "additionalProperties": false }, { "type": "object", "properties": { "by": { "type": "string", "enum": [ "address" ] }, "address": { "type": "object", "properties": { "line1": { "type": "string", "minLength": 1, "maxLength": 200 }, "city": { "type": "string", "minLength": 1, "maxLength": 100 }, "state": { "type": "string", "pattern": "^[A-Za-z]{2}$" }, "postalCode": { "type": "string", "pattern": "^\\d{5}(?:-\\d{4})?$" } }, "required": [ "line1" ], "additionalProperties": false }, "countyIds": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" } } }, "required": [ "by", "address" ], "additionalProperties": false } ] } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "status": { "type": "string", "enum": [ "resolved", "ambiguous", "out_of_scope", "not_found" ] }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 }, "parcelDisplayId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "situs": { "type": "object", "properties": { "line1": { "type": "string", "minLength": 1 }, "line2": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "city": { "type": "string", "minLength": 1 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "postalCode": { "type": "string", "pattern": "^\\d{5}(?:-\\d{4})?$" } }, "required": [ "line1", "line2", "city", "state", "postalCode" ], "additionalProperties": false }, "coordinates": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ] }, "assetType": { "type": "string", "enum": [ "industrial", "retail", "office", "multifamily", "hospitality", "land", "mixed_use", "special_purpose", "public_civic", "other_commercial" ] }, "countyUseCode": { "type": "string", "minLength": 1 }, "countyUseDescription": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "landAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "structureCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "grossBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "netBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "yearBuiltEarliest": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "yearBuiltLatest": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "unitCount": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "assessment": { "anyOf": [ { "type": "object", "properties": { "taxYear": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "totalCents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "valueBasis": { "type": "string", "enum": [ "county_assessed", "county_full_cash", "county_market_labeled", "county_defined" ] }, "publicationStatus": { "anyOf": [ { "type": "string", "enum": [ "preliminary", "certified" ] }, { "type": "null" } ] } }, "required": [ "taxYear", "totalCents", "valueBasis", "publicationStatus" ], "additionalProperties": false }, { "type": "null" } ] }, "lastQualifiedSale": { "anyOf": [ { "type": "object", "properties": { "saleDate": { "type": "string" }, "priceCents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "saleDate", "priceCents" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "countyId", "parcelId", "parcelDisplayId", "situs", "coordinates", "assetType", "countyUseCode", "countyUseDescription", "landAreaSqFt", "structureCount", "grossBuildingAreaSqFt", "netBuildingAreaSqFt", "yearBuiltEarliest", "yearBuiltLatest", "unitCount", "assessment", "lastQualifiedSale" ], "additionalProperties": false }, "matchedBy": { "type": "string", "enum": [ "parcel_id", "address_exact", "address_tokens" ] }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false } }, "required": [ "property", "matchedBy", "dataset" ], "additionalProperties": false } }, "outOfScope": { "anyOf": [ { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 }, "countyUseCode": { "type": "string", "minLength": 1 }, "countyUseDescription": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "situs": { "type": "object", "properties": { "line1": { "type": "string", "minLength": 1 }, "line2": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "city": { "type": "string", "minLength": 1 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "postalCode": { "type": "string", "pattern": "^\\d{5}(?:-\\d{4})?$" } }, "required": [ "line1", "line2", "city", "state", "postalCode" ], "additionalProperties": false } }, "required": [ "countyId", "parcelId", "countyUseCode", "countyUseDescription", "situs" ], "additionalProperties": false }, { "type": "null" } ] }, "message": { "type": "string", "minLength": 1 } }, "required": [ "meta", "status", "candidates", "outOfScope", "message" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/counties/{countyId}/properties/{parcelId}": { "get": { "summary": "Full facts for one served parcel, with an embedded property-scoped context", "tags": [ "Properties" ], "parameters": [ { "schema": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "in": "path", "name": "countyId", "required": true }, { "schema": { "type": "string", "minLength": 1, "maxLength": 100 }, "in": "path", "name": "parcelId", "required": true } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 }, "parcelDisplayId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "situs": { "type": "object", "properties": { "line1": { "type": "string", "minLength": 1 }, "line2": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "city": { "type": "string", "minLength": 1 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "postalCode": { "type": "string", "pattern": "^\\d{5}(?:-\\d{4})?$" } }, "required": [ "line1", "line2", "city", "state", "postalCode" ], "additionalProperties": false }, "coordinates": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ] }, "countyUseCode": { "type": "string", "minLength": 1 }, "countyUseDescription": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "assetType": { "type": "string", "enum": [ "industrial", "retail", "office", "multifamily", "hospitality", "land", "mixed_use", "special_purpose", "public_civic", "other_commercial" ] }, "landAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "structures": { "type": "array", "items": { "type": "object", "properties": { "sourceStructureId": { "type": "string", "minLength": 1 }, "yearBuilt": { "anyOf": [ { "type": "integer", "minimum": 1700, "maximum": 2200 }, { "type": "null" } ] }, "stories": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "grossBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "netBuildingAreaSqFt": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "unitCount": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "useCode": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "useDescription": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] } }, "required": [ "sourceStructureId", "yearBuilt", "stories", "grossBuildingAreaSqFt", "netBuildingAreaSqFt", "unitCount", "useCode", "useDescription" ], "additionalProperties": false } }, "assessment": { "anyOf": [ { "type": "object", "properties": { "taxYear": { "type": "integer", "minimum": 1800, "maximum": 2400 }, "landCents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "improvementCents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "totalCents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "valueBasis": { "type": "string", "enum": [ "county_assessed", "county_full_cash", "county_market_labeled", "county_defined" ] }, "publicationStatus": { "type": "string", "enum": [ "preliminary", "certified" ] } }, "required": [ "taxYear", "landCents", "improvementCents", "totalCents", "valueBasis" ], "additionalProperties": false }, { "type": "null" } ] }, "sales": { "type": "array", "items": { "type": "object", "properties": { "sourceSaleId": { "type": "string", "minLength": 1 }, "saleDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}(?:-\\d{2})?$" }, "priceCents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "instrument": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "qualification": { "type": "string", "enum": [ "qualified", "excluded", "unknown" ] }, "exclusionReasons": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "multiParcel": { "type": [ "null", "boolean" ] } }, "required": [ "sourceSaleId", "saleDate", "priceCents", "instrument", "qualification", "exclusionReasons", "multiParcel" ], "additionalProperties": false } }, "zoning": { "anyOf": [ { "type": "object", "properties": { "code": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] } }, "required": [ "code", "description" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "countyId", "parcelId", "parcelDisplayId", "situs", "coordinates", "countyUseCode", "countyUseDescription", "assetType", "landAreaSqFt", "structures", "assessment", "sales", "zoning" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "missingFields": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "links": { "type": "object", "properties": { "provenance": { "type": "string", "minLength": 1 } }, "required": [ "provenance" ], "additionalProperties": false }, "context": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "available" ] }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "point": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "crs": { "type": "string", "enum": [ "EPSG:4326" ] } }, "required": [ "latitude", "longitude", "crs" ], "additionalProperties": false }, { "type": "null" } ] }, "freshness": { "type": "object", "properties": { "generatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "snapshotVersion": { "type": "string", "enum": [ "1.0.0" ] }, "cache": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "miss", "hit" ] }, "ttlSeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "ttlSeconds", "expiresAt" ], "additionalProperties": false } }, "required": [ "generatedAt", "dataAsOf", "snapshotVersion", "cache" ], "additionalProperties": false }, "modules": { "type": "object", "properties": { "naipImageryMetadata": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] }, "femaNfhl": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] } }, "required": [ "naipImageryMetadata", "femaNfhl" ], "additionalProperties": false } }, "required": [ "status", "property", "dataset", "point", "freshness", "modules" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "county_not_covered", "data_unavailable", "not_found", "out_of_scope", "timeout", "batch_row_limit", "batch_budget_exceeded", "enrichment_error" ] }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "anyOf": [ { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, { "type": "null" } ] }, "point": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "crs": { "type": "string", "enum": [ "EPSG:4326" ] } }, "required": [ "latitude", "longitude", "crs" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "status", "reason", "property", "dataset", "point" ], "additionalProperties": false } ], "description": "Property-scoped NAIP catalog metadata and FEMA NFHL point zone/panel facts for this row's stored coordinates, or an explicit unavailable reason. Missing coordinates are not_evaluable and are never geocoded." } }, "required": [ "meta", "property", "dataset", "missingFields", "links", "context" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/counties/{countyId}/properties/{parcelId}/provenance": { "get": { "summary": "Source observations behind one served parcel", "tags": [ "Properties" ], "parameters": [ { "schema": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "in": "path", "name": "countyId", "required": true }, { "schema": { "type": "string", "minLength": 1, "maxLength": 100 }, "in": "path", "name": "parcelId", "required": true } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "key": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "recordSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "sourceArtifacts": { "type": "array", "items": { "type": "object", "properties": { "artifactId": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "fetchedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "artifactId", "url", "sha256", "fetchedAt" ], "additionalProperties": false } }, "observations": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "minLength": 1 }, "sourceId": { "type": "string", "minLength": 1 }, "artifactId": { "type": "string", "minLength": 1 }, "rowNumber": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sourceField": { "type": "string", "minLength": 1 }, "rawValue": { "type": "string" } }, "required": [ "field", "sourceId", "artifactId", "rowNumber", "sourceField", "rawValue" ], "additionalProperties": false } } }, "required": [ "meta", "key", "dataset", "recordSha256", "sourceIds", "sourceArtifacts", "observations" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } }, "/counties/{countyId}/properties/{parcelId}/context": { "get": { "summary": "Point-context NAIP catalog metadata and FEMA NFHL zone/panel facts for one served parcel", "tags": [ "Properties" ], "description": "Deterministic point-context facts for one served parcel. NAIP is catalog metadata only, never imagery, asset URLs, bytes, current condition, or property-condition evidence. FEMA NFHL is queried-point context only, never parcel-wide flood risk, insurance, safety, survey, engineering, or an official map determination; an empty result is not 'no flood risk'. States are observed, not_found (valid empty source response), not_evaluable (coordinates_not_published or geography_not_authorized), and unavailable (a bounded upstream transport or schema failure). No owner, mailing, tenant, party, solicitation or raw upstream fields are served.", "parameters": [ { "schema": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "in": "path", "name": "countyId", "required": true }, { "schema": { "type": "string", "minLength": 1, "maxLength": 100 }, "in": "path", "name": "parcelId", "required": true } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "property": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "parcelId": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "parcelId" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "countyId": { "type": "string", "pattern": "^us-[a-z]{2}-[a-z0-9-]+$" }, "datasetRunId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "transformationCodeVersion": { "type": "string", "minLength": 1 } }, "required": [ "countyId", "datasetRunId", "dataAsOf", "transformationCodeVersion" ], "additionalProperties": false }, "point": { "anyOf": [ { "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "crs": { "type": "string", "enum": [ "EPSG:4326" ] } }, "required": [ "latitude", "longitude", "crs" ], "additionalProperties": false }, { "type": "null" } ] }, "freshness": { "type": "object", "properties": { "generatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "dataAsOf": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "snapshotVersion": { "type": "string", "enum": [ "1.0.0" ] }, "cache": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "miss", "hit" ] }, "ttlSeconds": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "ttlSeconds", "expiresAt" ], "additionalProperties": false } }, "required": [ "generatedAt", "dataAsOf", "snapshotVersion", "cache" ], "additionalProperties": false }, "modules": { "type": "object", "properties": { "naipImageryMetadata": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_primary_items_newest_first" ] } }, "required": [ "method", "selection" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "usgs-naip-imagery-catalog" ] }, "sourceName": { "type": "string", "enum": [ "USGS National Map NAIP Imagery catalog" ] }, "sourceUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer/query" ] }, "termsUrl": { "type": "string", "enum": [ "https://imagery.nationalmap.gov/arcgis/rest/services/USGSNAIPImagery/ImageServer" ] }, "attribution": { "type": "string", "enum": [ "USGS, USDA, The National Map: Orthoimagery." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/usgs-naip-metadata.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "number", "enum": [ 1 ] }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "catalog item projection reported per item" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "observations": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "catalogObjectId": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalogName": { "type": "string", "minLength": 1 }, "acquisitionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "sourceYear": { "type": "integer", "minimum": 1900, "maximum": 2400 }, "state": { "type": "string", "pattern": "^[A-Z]{2}$" }, "groundSampleDistance": { "type": "object", "properties": { "value": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "enum": [ "meter" ] } }, "required": [ "value", "unit" ], "additionalProperties": false }, "bandCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "sensorType": { "type": "string", "minLength": 1 }, "projection": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "datum": { "type": "string", "minLength": 1 } }, "required": [ "name", "zone", "datum" ], "additionalProperties": false }, "agency": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 } }, "required": [ "catalogObjectId", "catalogName", "acquisitionDate", "sourceYear", "state", "groundSampleDistance", "bandCount", "sensorType", "projection", "agency", "vendor" ], "additionalProperties": false } } }, "required": [ "observations" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "Catalog metadata only; no image bytes or asset URLs were requested or retained." ] }, { "type": "string", "enum": [ "The point intersection does not establish imagery coverage for the whole parcel or current property condition." ] } ], "additionalItems": false, "minItems": 2, "maxItems": 2 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] }, "femaNfhl": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "observed" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_found" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "object", "properties": { "method": { "type": "string", "enum": [ "point_intersection" ] }, "selection": { "type": "string", "enum": [ "all_returned_zones_and_panels_stable_order" ] }, "spatialScope": { "type": "string", "enum": [ "queried_point_only" ] } }, "required": [ "method", "selection", "spatialScope" ], "additionalProperties": false }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unavailable" ] }, "reason": { "type": "string", "enum": [ "request_aborted", "request_failed", "response_http_error", "response_too_large", "response_invalid_json", "source_response_invalid", "source_result_limit_exceeded" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "provenance": { "type": "object", "properties": { "sourceId": { "type": "string", "enum": [ "fema-nfhl" ] }, "sourceName": { "type": "string", "enum": [ "FEMA National Flood Hazard Layer" ] }, "sourceUrl": { "type": "string", "enum": [ "https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer" ] }, "termsUrl": { "type": "string", "enum": [ "https://catalog.data.gov/dataset/national-flood-hazard-layer-nfhl" ] }, "attribution": { "type": "string", "enum": [ "Source: Federal Emergency Management Agency, National Flood Hazard Layer." ] }, "policyPath": { "type": "string", "enum": [ "docs/rights/source-context/fema-nfhl.json" ] }, "retrievedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "responseBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestCount": { "type": "integer", "minimum": 1, "maximum": 2 }, "attempts": { "type": "integer", "minimum": 1, "maximum": 6 }, "inputCrs": { "type": "string", "enum": [ "EPSG:4326" ] }, "sourceCrs": { "type": "string", "enum": [ "EPSG:4269 (NAD83)" ] }, "method": { "type": "string", "enum": [ "point_intersection" ] } }, "required": [ "sourceId", "sourceName", "sourceUrl", "termsUrl", "attribution", "policyPath", "retrievedAt", "responseBytes", "requestCount", "attempts", "inputCrs", "sourceCrs", "method" ], "additionalProperties": false }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "provenance", "caveats" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_evaluable" ] }, "reason": { "type": "string", "enum": [ "coordinates_not_published", "geography_not_authorized" ] }, "sourceReported": { "type": "object", "properties": { "zones": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "floodAreaId": { "type": "string", "minLength": 1 }, "zone": { "type": "string", "minLength": 1 }, "subtype": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "specialFloodHazardArea": { "type": [ "boolean", "null" ] }, "staticBaseFloodElevation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "depth": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "velocity": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "value": { "type": "number" }, "unit": { "type": "string", "minLength": 1 } }, "required": [ "status", "value", "unit" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "dFirmId", "floodAreaId", "zone", "subtype", "specialFloodHazardArea", "staticBaseFloodElevation", "depth", "velocity" ], "additionalProperties": false } }, "panels": { "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "dFirmId": { "type": "string", "minLength": 1 }, "firmId": { "type": "string", "minLength": 1 }, "panelNumber": { "type": "string", "minLength": 1 }, "panelType": { "type": "string", "minLength": 1 }, "preliminaryDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "effectiveDate": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "reported" ] }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "status", "date" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_reported" ] } }, "required": [ "status" ], "additionalProperties": false } ] }, "sourceCitation": { "type": "string", "minLength": 1 } }, "required": [ "dFirmId", "firmId", "panelNumber", "panelType", "preliminaryDate", "effectiveDate", "sourceCitation" ], "additionalProperties": false } } }, "required": [ "zones", "panels" ], "additionalProperties": false }, "computation": { "type": "null" }, "inference": { "type": "null" }, "caveats": { "type": "array", "items": [ { "type": "string", "enum": [ "The classification applies only to the queried point, not the whole parcel." ] }, { "type": "string", "enum": [ "An empty response does not mean no flood risk." ] }, { "type": "string", "enum": [ "This is not an insurance, safety, survey, engineering, or official map determination." ] } ], "additionalItems": false, "minItems": 3, "maxItems": 3 } }, "required": [ "status", "reason", "sourceReported", "computation", "inference", "caveats" ], "additionalProperties": false } ] } }, "required": [ "naipImageryMetadata", "femaNfhl" ], "additionalProperties": false } }, "required": [ "meta", "property", "dataset", "point", "freshness", "modules" ], "additionalProperties": false } } } }, "400": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "500": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1 }, "contractVersion": { "type": "string", "enum": [ "2026-09-13" ] } }, "required": [ "requestId", "contractVersion" ], "additionalProperties": false }, "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "forbidden", "not_found", "county_not_covered", "cursor_expired", "rate_limited", "data_unavailable", "internal_error" ] }, "message": { "type": "string", "minLength": 1 }, "hint": { "type": [ "null", "string" ] }, "retryAfterSeconds": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "code", "message", "hint", "retryAfterSeconds" ], "additionalProperties": false } }, "required": [ "meta", "error" ], "additionalProperties": false } } } } } } } }, "servers": [ { "url": "https://crelayer.com/data" } ], "tags": [ { "name": "Coverage", "description": "What is served, from which dataset, with which fields." }, { "name": "Properties", "description": "Query, resolve and read served parcels." }, { "name": "Operations" } ] } ```