{"contractVersion":"parcelops.connector.v1","name":"usgs-water","displayName":"USGS Water Services","description":"First-party USGS streamflow, stage, water-quality, site, daily-value, and groundwater observations for property and site diligence.","tags":["water","groundwater","streamflow","site-diligence","usgs"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"USGS Water Services","sourceUrl":"https://waterservices.usgs.gov/","apiBaseUrl":"https://waterservices.usgs.gov/nwis","documentationUrl":"https://waterservices.usgs.gov/"},"freshness":{"status":"not_declared"},"coverage":{"geographic":{"status":"not_declared"},"temporal":{"status":"not_declared"}},"methods":{"total":6,"items":[{"name":"getInstantaneousValues","description":"Get current discharge, gage height, or other USGS readings for comma-separated site IDs.","requiredParams":["sites"],"inputSchema":{"type":"object","properties":{"sites":{"type":"string","pattern":"^\\d{8,15}(?:,\\d{8,15})*$"},"parameterCd":{"type":"string","pattern":"^\\d{5}(?:,\\d{5})*$"},"period":{"type":"string","maxLength":30}},"required":["sites"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["water-observation"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]},{"name":"getDailyValues","description":"Get Daily Values","requiredParams":["sites"],"inputSchema":{"type":"object","properties":{"sites":{"type":"string","pattern":"^\\d{8,15}(?:,\\d{8,15})*$"},"parameterCd":{"type":"string","pattern":"^\\d{5}(?:,\\d{5})*$"},"startDate":{"type":"string","maxLength":20},"endDate":{"type":"string","maxLength":20},"period":{"type":"string","maxLength":30}},"required":["sites"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["daily-water-observation"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]},{"name":"getSiteInfo","description":"Get Site Info","requiredParams":["sites"],"inputSchema":{"type":"object","properties":{"sites":{"type":"string","pattern":"^\\d{8,15}(?:,\\d{8,15})*$"}},"required":["sites"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["water-monitoring-site"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]},{"name":"searchSites","description":"Find USGS sites by ONE location filter: bbox (max 4 square degrees), countyCd, or stateCd.","inputSchema":{"type":"object","properties":{"stateCd":{"type":"string","pattern":"^[A-Za-z]{2}$"},"countyCd":{"type":"string","pattern":"^\\d{5}(?:,\\d{5})*$"},"bbox":{"description":"west,south,east,north in WGS84. At most 4 square degrees.","oneOf":[{"type":"array","minItems":4,"maxItems":4,"items":{"type":"number"},"description":"[minLongitude, minLatitude, maxLongitude, maxLatitude] in WGS84."},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"}]},"parameterCd":{"type":"string","pattern":"^\\d{5}(?:,\\d{5})*$"},"siteType":{"type":"string","maxLength":80},"maxResults":{"type":"integer","minimum":1,"maximum":500}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["water-monitoring-site"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]},{"name":"getGroundwaterLevels","description":"Get Groundwater Levels","inputSchema":{"type":"object","properties":{"sites":{"type":"string","pattern":"^\\d{8,15}(?:,\\d{8,15})*$"},"bbox":{"description":"west,south,east,north in WGS84. At most 4 square degrees.","oneOf":[{"type":"array","minItems":4,"maxItems":4,"items":{"type":"number"},"description":"[minLongitude, minLatitude, maxLongitude, maxLatitude] in WGS84."},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$"}]},"siteType":{"type":"string","maxLength":80},"startDate":{"type":"string","maxLength":20},"endDate":{"type":"string","maxLength":20}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["groundwater-observation"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]},{"name":"getServiceInfo","description":"Get Service Info","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]}]},"caveats":["Products and freshness vary by service and site; observations can be provisional and later revised.","The legacy Water Services host is scheduled for decommissioning in early 2027."]}