{ "openapi": "3.0.1", "info": { "title": "Colorado Water Rights & Structures Screener — CDSS Search", "description": "Colorado water rights and water-infrastructure screening from CO DWR CDSS. Radius-search any site for ditches, wells and reservoirs with water source, seniority sampling (pre-1950 appropriations) and a per-asset availability summary. Built for data-center and land siting.", "version": "1.0", "x-build-id": "nisAHyTC8hnfY29N5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~water-rights-availability-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-water-rights-availability-screener", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/malonestar~water-rights-availability-screener/runs": { "post": { "operationId": "runs-sync-malonestar-water-rights-availability-screener", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/malonestar~water-rights-availability-screener/run-sync": { "post": { "operationId": "run-sync-malonestar-water-rights-availability-screener", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "assets" ], "properties": { "assets": { "title": "Assets (sites to screen)", "type": "array", "description": "List of sites to screen against Colorado DWR CDSS water structures. Each entry is an object {\"lat\": number, \"lon\": number, \"label\": string}. One or more structure rows plus a per-asset summary row are produced for each entry. Coordinates outside Colorado are still queried (CDSS just returns 0 structures) and get an explicit clear/summary row." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Search radius in miles around each asset within which CDSS water structures (ditches, wells, reservoirs, etc.) are inventoried.", "default": 5 }, "structureTypes": { "title": "Structure types (optional filter)", "type": "array", "description": "Optional list of structure-type keywords to keep (case-insensitive substring match against CDSS structureType, e.g. \"Ditch\", \"Well\", \"Reservoir\"). Leave empty to return every structure type found within the radius.", "default": [], "items": { "type": "string" } }, "seniorityDetailLimit": { "title": "Seniority detail limit", "minimum": 0, "maximum": 50, "type": "integer", "description": "Max number of the nearest structures per asset for which the actor looks up water-rights seniority (appropriation date, priority admin number, decreed uses) via the CDSS net-amount endpoint. Kept modest to respect the anonymous CDSS request budget (~1,000 requests/day). Structures beyond this limit still appear as rows, just without seniority detail.", "default": 10 }, "maxResultsPerAsset": { "title": "Max structure rows per asset", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Max number of nearest-first structure rows emitted per asset (in addition to the one summary row). Does not limit the counts reported in the summary row, which always reflect every structure found within the radius.", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }