{
  "schema": "kallipolis.resource-quality.v1",
  "id": "resource.public-data.usgs-water-data-apis",
  "version": "1.0.0",
  "title": "USGS Water Data APIs boundary",
  "summary": "Official-source access, authentication, request-shaping, paging, freshness, legal, and interpretation boundaries for USGS Water Data APIs.",
  "content": {
    "kind": "public-data-api-boundary",
    "facts": [
      {
        "id": "fact.usgs.water-data-apis.access",
        "statement": "USGS documents OGC, STAC, water-quality, imagery, and related APIs for sensor measurements, daily values, files, samples, and monitoring-location metadata.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.usgs.water-data-apis"
        ]
      },
      {
        "id": "fact.usgs.water-data-apis.authentication",
        "statement": "Some read access is public, while an API key can provide higher rate limits; authentication and availability must be checked for the selected endpoint family.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.usgs.water-data-apis"
        ]
      },
      {
        "id": "fact.usgs.water-data-apis.request",
        "statement": "Clients must choose the correct API family and bind monitoring location, parameter, time, format, paging, and provisional-data semantics rather than mix legacy contracts.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.usgs.water-data-apis"
        ]
      },
      {
        "id": "fact.usgs.water-data-apis.boundary",
        "statement": "Water measurements and derived values can be provisional, revised, discontinuous, or site-specific and do not alone prove water safety, absence, or regulatory compliance.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.usgs.water-data-apis"
        ]
      }
    ]
  },
  "language": "en",
  "category": "public-data-api",
  "state": "prepared",
  "canonicalUrl": "https://platoskallipolis.com/resources/public-data-apis/usgs-water-data-apis.json",
  "contentHash": "sha256:e97e39e890142ef907e4aee7ad57450b095af152ebc91946a8a9b61f6401f5ce",
  "owner": {
    "id": "platos-kallipolis",
    "name": "Plato's Kallipolis",
    "type": "organization",
    "accountabilityUrl": "https://platoskallipolis.com/about"
  },
  "access": {
    "mode": "public",
    "url": "https://platoskallipolis.com/resources/public-data-apis/usgs-water-data-apis.json",
    "authentication": "none",
    "robotsAllowed": true
  },
  "provenance": {
    "method": "primary-source",
    "sources": [
      {
        "id": "source.usgs.water-data-apis",
        "url": "https://api.waterdata.usgs.gov/docs/",
        "title": "USGS Water Data APIs",
        "publisher": "U.S. Geological Survey",
        "observedAt": "2026-08-27T09:30:00Z"
      }
    ]
  },
  "observedAt": "2026-08-27T09:30:00Z",
  "freshness": {
    "policy": "max-age",
    "state": "current",
    "nextReviewAt": "2026-09-03T09:30:00Z",
    "maxAgeSeconds": 604800
  },
  "license": {
    "id": "source-terms-apply",
    "url": "https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits",
    "redistributionAllowed": false
  },
  "evidence": [
    {
      "id": "evidence.usgs.water-data-apis",
      "type": "source-claim",
      "url": "https://api.waterdata.usgs.gov/docs/",
      "observedAt": "2026-08-27T09:30:00Z"
    }
  ]
}