USGS Water Data OGC API OpenAPI

healthy

Publisher

USGS

Human landing

https://api.waterdata.usgs.gov/docs

Artifact URL

https://api.waterdata.usgs.gov/ogcapi/v0/openapi?f=json

Auth

none recorded

Rate limit

Public OpenAPI document; ordinary HTTP.

Evidence

earth-science · open-government · water

Publisher identity: USGS Artifact relationship: official domain Automated access: plain GET succeeded Integrity hash: 796f091c6188… Parseability: valid Effects: read Licensing: USGS public-domain information as published. Freshness: Sep 17, 2026, 7:10 PM PDT

Notes

Confirmed 200 application/json OpenAPI at ogcapi/v0/openapi?f=json. The HTML docs page is not the artifact. Remote $ref documents (OGC Features, CQL2, exception, tiles, Records sortby, featureId) are vendored under sourcepaths/schemas/remote/ so a third-party outage cannot flip this row to schema_changed mid-sweep.

Tasks this artifact can answer

find the OpenAPI description for USGS water data
see which water-data paths are documented as JSON

Change history

healthySep 17, 2026, 7:10 PM PDT · HTTP 200
healthySep 17, 2026, 7:03 PM PDT · HTTP 200
healthySep 17, 2026, 6:57 PM PDT · HTTP 200
healthySep 17, 2026, 6:57 PM PDT · HTTP 200
healthySep 17, 2026, 6:55 PM PDT · HTTP 200
healthySep 17, 2026, 6:55 PM PDT · HTTP 200
healthySep 17, 2026, 6:06 PM PDT · HTTP 200
healthySep 17, 2026, 6:06 PM PDT · HTTP 200
schema changedSep 17, 2026, 6:05 PM PDT · HTTP 200 · openapi validation failed: REQUIRED must have required property 'required' 112509 | "style": "form" 112510 | }, > 112511 | { | ^ required is missing here! 112512 | "type": "object", 112513 | "additionalProperties": true, 112514 | "description": "Remote JSON Schema https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml stubbed; OAS 3 cannot ingest JSON Schema 2020-12 keywords."; REQUIRED must have required property 'required' 246 | "style": "form" 247 | }, > 248 | "remote_sortby": { | ^ required is missing here! 249 | "type": "object", 250 | "additionalProperties": true, 251 | "description": "Remote JSON Schema https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml stubbed; OAS 3 cannot ingest JSON Schema 2020-12 keywords."
schema changedSep 17, 2026, 6:05 PM PDT · HTTP 200 · openapi validation failed: ADDITIONAL PROPERTY must NOT have additional properties 12455 | "remote_LandingPage": { 12456 | "description": "The landing page provides links to the API definition\n(link relations `service-desc` and `service-doc`),\nthe Conformance declaration (path `/conformance`,\nlink relation `conformance`), and the Feature\nCollections (path `/collections`, link relation\n`data`).", > 12457 | "content": { | ^^^^^^^^^ content is not expected to be here! 12458 | "application/json": { 12459 | "schema": { 12460 | "type": "object",; ADDITIONAL PROPERTY must NOT have additional properties 12525 | "remote_InvalidParameter": { 12526 | "description": "A query parameter has an invalid value.", > 12527 | "content": { | ^^^^^^^^^ content is not expected to be here! 12528 | "application/json": { 12529 | "schema": { 12530 | "type": "object",; ADDITIONAL PROPERTY must NOT have additional properties 12552 | "remote_ServerError": { 12553 | "description": "A server error occurred.", > 12554 | "content": { | ^^^^^^^^^ content is not expected to be here! 12555 | "application/json": { 12556 | "schema": { 12557 | "type": "object",; ADDITIONAL PROPERTY must NOT have additional properties 12803 | "remote_Collection": { 12804 | "description": "Information about the feature collection with id `collectionId`.\n\nThe response contains a link to the items in the collection\n(path `/collections/{collectionId}/items`, link relation `items`)\nas well as key information about the collection. This information\nincludes:\n\n* A local identifier for the collection that is unique for the dataset;\n* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* An optional title and description for the collection;\n* An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature').", > 12805 | "content": { | ^^^^^^^^^ content is not expected to be here! 12806 | "application/json": { 12807 | "schema": { 12808 | "type": "object",; ADDITIONAL PROPERTY must NOT have additional properties 13010 | }, 13011 | "remote_cql2_json": { > 13012 | "$schema": "https://json-schema.org/draft/2020-12/schema", | ^^^^^^^^^ $schema is not expected to be here! 13013 | "$dynamicAnchor": "cql2expression", 13014 | "oneOf": [ 13015 | {; ADDITIONAL PROPERTY must NOT have additional properties 13031 | "minItems": 2, 13032 | "items": { > 13033 | "$dynamicRef": "#cql2expression" | ^^^^^^^^^^^^^ $dynamicRef is not expected to be here! 13034 | } 13035 | } 13036 | }; ADDITIONAL PROPERTY must NOT have additional properties 13054 | "maxItems": 1, 13055 | "items": { > 13056 | "$dynamicRef": "#cql2expression" | ^^^^^^^^^^^^^ $dynamicRef is not expected to be here! 13057 | } 13058 | } 13059 | }
schema changedSep 17, 2026, 6:04 PM PDT · HTTP 200 · openapi validation failed: JSON pointer /components/schemas/remote_binaryComparisonPredicate not found
schema changedSep 17, 2026, 6:03 PM PDT · HTTP 200 · openapi validation failed: JSON pointer /components/schemas/remote_binaryComparisonPredicate not found
schema changedSep 17, 2026, 6:03 PM PDT · HTTP 200 · openapi validation failed: Missing $ref pointer "#/components/schemas/remote_link". Token "remote_link" does not exist.
schema changedSep 17, 2026, 6:02 PM PDT · HTTP 200 · openapi validation failed: circular remote $ref https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link
schema changedSep 17, 2026, 6:01 PM PDT · HTTP 200 · openapi validation failed: Missing $ref pointer "#/components/schemas/pointGeoJSON". Token "pointGeoJSON" does not exist.
schema changedSep 17, 2026, 5:06 PM PDT · HTTP 200 · openapi validation failed: `/paths/collections/agency-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/agency-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/altitude-datums/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/altitude-datums/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/aquifer-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/aquifer-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/aquifer-types/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/aquifer-types/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/channel-measurements/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/channel-measurements/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/citations/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/citations/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/combined-metadata/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/combined-metadata/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/continuous/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/continuous/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-accuracy-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-accuracy-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-datum-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-datum-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-method-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/coordinate-method-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/counties/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/counties/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/countries/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/countries/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/daily/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/daily/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/field-measurements-metadata/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/field-measurements-metadata/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/field-measurements/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/field-measurements/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/hydrologic-unit-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/hydrologic-unit-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-continuous/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-continuous/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-daily/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-daily/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-field-measurements/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/latest-field-measurements/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/medium-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/medium-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/method-categories/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/method-categories/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/method-citations/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/method-citations/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/methods/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/methods/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/monitoring-locations/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/monitoring-locations/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/national-aquifer-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/national-aquifer-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/parameter-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/parameter-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/peaks/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/peaks/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/reliability-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/reliability-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/site-types/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/site-types/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/states/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/states/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/statistic-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/statistic-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-metadata/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-metadata/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-methods/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-methods/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-revisions/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-series-revisions/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-zone-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/time-zone-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.; `/paths/collections/topographic-codes/items/{featureId}/get` is missing path parameter(s) for `{featureId}`.; `/paths/collections/topographic-codes/items/{featureId}/options` is missing path parameter(s) for `{featureId}`.