components: parameters: bbox: description: Only features that have a geometry that intersects the bounding box are selected.The bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (height or depth). explode: false in: query name: bbox required: false schema: items: type: number maxItems: 6 minItems: 4 type: array style: form bbox-crs: description: Indicates the coordinate reference system for the given bbox coordinates. explode: false in: query name: bbox-crs required: false schema: format: uri type: string style: form bbox-crs-epsg: description: Indicates the EPSG for the given bbox coordinates. explode: false in: query name: bbox-crs required: false schema: default: 4326 type: integer style: form crs: description: Indicates the coordinate reference system for the results. explode: false in: query name: crs required: false schema: format: uri type: string style: form f: description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. CSV is also available. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form filter: description: "CQL Text filter expression. CQL JSON cannot be used here, only in the body. \nSee also: https://docs.pygeoapi.io/en/latest/cql.html\ \ \n\nExample: time_series_id IN ('64ee32f5350a4ec4967435dcd2e364ea', '3e55d9c2d8a54bec9ca5e292b07d5a96')" in: query name: filter required: false schema: type: string filter-lang: description: CQL language used (e.g., cql-text, cql-json) in: query name: filter-lang required: false schema: enum: - cql-text - cql-json type: string lang: description: The optional lang parameter instructs the server return a response in a certain language, if supported. If the language is not among the available values, the Accept-Language header language will be used if it is supported. If the header is missing, the default server language is used. Note that providers may only support a single language (or often no language at all), that can be different from the server language. Language strings can be written in a complex (e.g. "fr-CA,fr;q=0.9,en-US;q=0.8,en;q=0.7"), simple (e.g. "de") or locale-like (e.g. "de-CH" or "fr_BE") fashion. in: query name: lang required: false schema: default: en-US enum: - en-US type: string limit: description: The optional limit parameter limits the number of items that are presented in the response document explode: false in: query name: limit required: false schema: default: 100 maximum: 10000 minimum: 1 type: integer style: form offset: description: The optional offset parameter indicates the index within the result set from which the server shall begin presenting results in the response document. The first element has an index of 0 (default). explode: false in: query name: offset required: false schema: default: 0 minimum: 0 type: integer style: form properties: description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: type: string type: array style: form q: description: "Full-text search across the most relevant text fields for this collection (e.g. site name, identifier,\ \ number, state, county, and site type).\n\nMatching rules:\n\n - Case-insensitive, with prefix matching (e.g. `poud`\ \ matches `POUDRE`).\n - Words separated by spaces are AND'd together (all must match).\n - Terms separated by commas\ \ are OR'd together (any may match).\n - Common abbreviations are expanded, so `river` also matches sites stored\ \ as `RV` (and vice versa).\n\nResults are ordered by relevance when `q` is supplied without an explicit `sortby`.\n\ \nExamples:\n\n - `q=poudre` — sites whose name/identifier starts with or contains `poudre`\n - `q=colorado river`\ \ — sites matching both `colorado` and `river`/`rv`\n - `q=poudre,cache creek` — sites matching `poudre` OR (`cache`\ \ AND `creek`/`ck`)" explode: false in: query name: q required: false schema: minLength: 2 type: string style: form resourceId: description: Configuration resource identifier in: path name: resourceId required: true schema: default: latest-continuous type: string skipGeometry: description: This option can be used to skip response geometries for each feature. explode: false in: query name: skipGeometry required: false schema: default: false type: boolean style: form statistic_id: description: A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://help.waterdata.usgs.gov/code/stat_cd_nm_query?stat_nm_cd=%25&fmt=html](https://help.waterdata.usgs.gov/code/stat_cd_nm_query?stat_nm_cd=%25&fmt=html). explode: false in: query name: statistic_id required: false schema: description: A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://help.waterdata.usgs.gov/code/stat_cd_nm_query?stat_nm_cd=%25&fmt=html](https://help.waterdata.usgs.gov/code/stat_cd_nm_query?stat_nm_cd=%25&fmt=html). title: Statistic ID type: string style: form time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering to\ \ RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or\ \ end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"\ P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that intersects\ \ the value of datetime are selected. If a feature has multiple temporal properties, it is the decision of the server\ \ whether only a single temporal property is used to determine the extent or all relevant temporal properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" title: Time type: string style: form vendorSpecificParameters: description: Additional "free-form" parameters that are not explicitly defined in: query name: vendorSpecificParameters schema: additionalProperties: true type: object style: form wda_sortby: description: "Specifies a comma-separated list of property names by which the response shall be sorted. If the property\ \ name is preceded by a plus (+) sign it indicates an ascending sort for that property. If the property name is preceded\ \ by a minus (-) sign it indicates a descending sort for that property. If the property is not preceded by a plus\ \ or minus, then the default sort order implied is ascending (+). \n\nOnly a single page of data can be returned\ \ when specifying sortby. If you need more than a single page of data, don't specify a sortby value and sort the full\ \ data set after it's been downloaded." explode: false in: query name: sortby required: false schema: items: pattern: '[+|-]?[A-Za-z_].*' type: string minItems: 1 type: array style: form responses: '200': description: successful operation '204': description: no content AgencyCodesFeature: content: application/geo+json: example: geometry: null id: AK001 properties: agency_name: Alaska Department of Transportation and Public Facilities id: AK001 type: Feature schema: $ref: '#/components/schemas/AgencyCodesFeature' text/html: schema: type: string description: A single feature from Agency codes. AgencyCodesFeatures: content: application/geo+json: example: features: - geometry: null id: AK001 properties: agency_name: Alaska Department of Transportation and Public Facilities id: AK001 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/AgencyCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Agency codes. AltitudeDatumsFeature: content: application/geo+json: example: geometry: null id: NAVD88 properties: altitude_datum_description: North American Vertical Datum of 1988 id: NAVD88 type: Feature schema: $ref: '#/components/schemas/AltitudeDatumsFeature' text/html: schema: type: string description: A single feature from Altitude datums. AltitudeDatumsFeatures: content: application/geo+json: example: features: - geometry: null id: NAVD88 properties: altitude_datum_description: North American Vertical Datum of 1988 id: NAVD88 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/AltitudeDatumsFeatureCollection' text/html: schema: type: string description: A feature collection of Altitude datums. AquiferCodesFeature: content: application/geo+json: example: geometry: null id: 000AARF properties: aquifer_name: Amphibolite and Amphibolite Rich Foliats id: 000AARF type: Feature schema: $ref: '#/components/schemas/AquiferCodesFeature' text/html: schema: type: string description: A single feature from Aquifer codes. AquiferCodesFeatures: content: application/geo+json: example: features: - geometry: null id: 000AARF properties: aquifer_name: Amphibolite and Amphibolite Rich Foliats id: 000AARF type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/aquifer-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/AquiferCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Aquifer codes. AquiferTypesFeature: content: application/geo+json: example: geometry: null id: U properties: aquifer_type_description: Unconfined single aquifer id: U type: Feature schema: $ref: '#/components/schemas/AquiferTypesFeature' text/html: schema: type: string description: A single feature from Aquifer types. AquiferTypesFeatures: content: application/geo+json: example: features: - geometry: null id: U properties: aquifer_type_description: Unconfined single aquifer id: U type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/aquifer-types/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/AquiferTypesFeatureCollection' text/html: schema: type: string description: A feature collection of Aquifer types. ChannelMeasurementsFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 6b0fefaa-5f8a-41a6-b590-7b31f2f4eb03 properties: channel_area: example-value channel_area_unit: example-value channel_evenness: example-value channel_flow: example-value channel_flow_unit: example-value channel_location_direction: example-value channel_location_distance: example-value channel_location_distance_unit: example-value channel_material: example-value channel_measurement_type: example-value channel_name: example-value channel_stability: example-value channel_velocity: example-value channel_velocity_unit: example-value channel_width: example-value channel_width_unit: example-value field_visit_id: 00000000-0000-0000-0000-000000000002 horizontal_velocity_description: example-value id: 6b0fefaa-5f8a-41a6-b590-7b31f2f4eb03 last_modified: '2025-06-16T14:13:28+00:00' longitudinal_velocity_description: example-value measurement_number: example-value measurement_type: example-value monitoring_location_id: USGS-09380000 time: '2024-06-15T14:00:00+00:00' vertical_velocity_description: example-value type: Feature schema: $ref: '#/components/schemas/ChannelMeasurementsFeature' text/html: schema: type: string description: A single feature from Channel measurements. ChannelMeasurementsFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 6b0fefaa-5f8a-41a6-b590-7b31f2f4eb03 properties: channel_area: example-value channel_area_unit: example-value channel_evenness: example-value channel_flow: example-value channel_flow_unit: example-value channel_location_direction: example-value channel_location_distance: example-value channel_location_distance_unit: example-value channel_material: example-value channel_measurement_type: example-value channel_name: example-value channel_stability: example-value channel_velocity: example-value channel_velocity_unit: example-value channel_width: example-value channel_width_unit: example-value field_visit_id: 00000000-0000-0000-0000-000000000002 horizontal_velocity_description: example-value id: 6b0fefaa-5f8a-41a6-b590-7b31f2f4eb03 last_modified: '2025-06-16T14:13:28+00:00' longitudinal_velocity_description: example-value measurement_number: example-value measurement_type: example-value monitoring_location_id: USGS-09380000 time: '2024-06-15T14:00:00+00:00' vertical_velocity_description: example-value type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/channel-measurements/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/ChannelMeasurementsFeatureCollection' text/html: schema: type: string description: A feature collection of Channel measurements. CitationsFeature: content: application/geo+json: example: geometry: null id: ALSC SOPs, 2015 properties: citation_description: 'Adirondack Lakes Survey Corporation, 2015, Standard operating procedures, laboratory, as of December 1, 2015: Ray Brook, New York, Adirondack Lakes Survey Corporation, 72 p.' id: ALSC SOPs, 2015 type: Feature schema: $ref: '#/components/schemas/CitationsFeature' text/html: schema: type: string description: A single feature from Citations. CitationsFeatures: content: application/geo+json: example: features: - geometry: null id: ALSC SOPs, 2015 properties: citation_description: 'Adirondack Lakes Survey Corporation, 2015, Standard operating procedures, laboratory, as of December 1, 2015: Ray Brook, New York, Adirondack Lakes Survey Corporation, 72 p.' id: ALSC SOPs, 2015 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/citations/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CitationsFeatureCollection' text/html: schema: type: string description: A feature collection of Citations. CombinedMetadataFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: example-value properties: agency_code: USGS agency_name: U.S. Geological Survey altitude: '930.63' altitude_accuracy: '0.16' altitude_method_code: X altitude_method_name: GNSS2 - Level 2 Quality Survey Grade Global Navigation Satellite System aquifer_code: 300GRNT aquifer_type_code: U basin_code: '01' begin: '2007-10-01T06:00:00+00:00' computation_identifier: Mean construction_date: '19630101' contributing_drainage_area: '1338' country_code: US country_name: United States of America county_code: '005' county_name: Coconino County data_gap_interval: P1D data_type: example-value depth_source_code: D district_code: '04' drainage_area: '1338' end: '2026-06-21T05:00:00+00:00' hole_constructed_depth: '160' horizontal_position_method_code: N horizontal_position_method_name: Interpolated from digital map horizontal_positional_accuracy: Accurate to + or - 1 sec. horizontal_positional_accuracy_code: S hydrologic_unit_code: '15010001' id: example-value last_modified: '2025-06-16T14:13:28+00:00' minor_civil_division_code: '01465' monitoring_location_id: USGS-09380000 monitoring_location_name: Colorado River at Lees Ferry, AZ monitoring_location_number: 09380000 national_aquifer_code: N100CMBRINM original_horizontal_datum: NAD83 original_horizontal_datum_name: North American Datum of 1983 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s parent_time_series_id: 786d481eaa73420da68a5a08a4302e76 primary: Primary reading_type: ReferencePrimary site_type: Stream site_type_code: ST state_code: '04' state_name: Arizona statistic_id: '00003' sublocation_identifier: Downstream thresholds: [] time_zone_abbreviation: MST unit_of_measure: ft3/s uses_daylight_savings: Y vertical_datum: NAVD88 vertical_datum_name: North American Vertical Datum of 1988 web_description: Discharge, cubic feet per second, from river/stream well_constructed_depth: '150' type: Feature schema: $ref: '#/components/schemas/CombinedMetadataFeature' text/html: schema: type: string description: A single feature from Combined metadata. CombinedMetadataFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: example-value properties: agency_code: USGS agency_name: U.S. Geological Survey altitude: '930.63' altitude_accuracy: '0.16' altitude_method_code: X altitude_method_name: GNSS2 - Level 2 Quality Survey Grade Global Navigation Satellite System aquifer_code: 300GRNT aquifer_type_code: U basin_code: '01' begin: '2007-10-01T06:00:00+00:00' computation_identifier: Mean construction_date: '19630101' contributing_drainage_area: '1338' country_code: US country_name: United States of America county_code: '005' county_name: Coconino County data_gap_interval: P1D data_type: example-value depth_source_code: D district_code: '04' drainage_area: '1338' end: '2026-06-21T05:00:00+00:00' hole_constructed_depth: '160' horizontal_position_method_code: N horizontal_position_method_name: Interpolated from digital map horizontal_positional_accuracy: Accurate to + or - 1 sec. horizontal_positional_accuracy_code: S hydrologic_unit_code: '15010001' id: example-value last_modified: '2025-06-16T14:13:28+00:00' minor_civil_division_code: '01465' monitoring_location_id: USGS-09380000 monitoring_location_name: Colorado River at Lees Ferry, AZ monitoring_location_number: 09380000 national_aquifer_code: N100CMBRINM original_horizontal_datum: NAD83 original_horizontal_datum_name: North American Datum of 1983 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s parent_time_series_id: 786d481eaa73420da68a5a08a4302e76 primary: Primary reading_type: ReferencePrimary site_type: Stream site_type_code: ST state_code: '04' state_name: Arizona statistic_id: '00003' sublocation_identifier: Downstream thresholds: [] time_zone_abbreviation: MST unit_of_measure: ft3/s uses_daylight_savings: Y vertical_datum: NAVD88 vertical_datum_name: North American Vertical Datum of 1988 web_description: Discharge, cubic feet per second, from river/stream well_constructed_depth: '150' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/combined-metadata/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CombinedMetadataFeatureCollection' text/html: schema: type: string description: A feature collection of Combined metadata. ContinuousFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature schema: $ref: '#/components/schemas/ContinuousFeature' text/html: schema: type: string description: A single feature from Continuous values. ContinuousFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/continuous/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/ContinuousFeatureCollection' text/html: schema: type: string description: A feature collection of Continuous values. CoordinateAccuracyCodesFeature: content: application/geo+json: example: geometry: null id: B properties: coordinate_accuracy_description: Level 1 survey-grade GPS id: B type: Feature schema: $ref: '#/components/schemas/CoordinateAccuracyCodesFeature' text/html: schema: type: string description: A single feature from Coordinate accuracy codes. CoordinateAccuracyCodesFeatures: content: application/geo+json: example: features: - geometry: null id: B properties: coordinate_accuracy_description: Level 1 survey-grade GPS id: B type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CoordinateAccuracyCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Coordinate accuracy codes. CoordinateDatumCodesFeature: content: application/geo+json: example: geometry: null id: NAD27 properties: coordinate_datum_description: North American Datum of 1927 id: NAD27 type: Feature schema: $ref: '#/components/schemas/CoordinateDatumCodesFeature' text/html: schema: type: string description: A single feature from Coordinate datum codes. CoordinateDatumCodesFeatures: content: application/geo+json: example: features: - geometry: null id: NAD27 properties: coordinate_datum_description: North American Datum of 1927 id: NAD27 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CoordinateDatumCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Coordinate datum codes. CoordinateMethodCodesFeature: content: application/geo+json: example: geometry: null id: C properties: coordinate_method_description: Calculated from land net id: C type: Feature schema: $ref: '#/components/schemas/CoordinateMethodCodesFeature' text/html: schema: type: string description: A single feature from Coordinate method codes. CoordinateMethodCodesFeatures: content: application/geo+json: example: features: - geometry: null id: C properties: coordinate_method_description: Calculated from land net id: C type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CoordinateMethodCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Coordinate method codes. CountiesFeature: content: application/geo+json: example: geometry: null id: AD-00-000 properties: country_code: AD county_fips_code: '000' county_name: Unspecified id: AD-00-000 state_fips_code: '00' type: Feature schema: $ref: '#/components/schemas/CountiesFeature' text/html: schema: type: string description: A single feature from County identifiers. CountiesFeatures: content: application/geo+json: example: features: - geometry: null id: AD-00-000 properties: country_code: AD county_fips_code: '000' county_name: Unspecified id: AD-00-000 state_fips_code: '00' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CountiesFeatureCollection' text/html: schema: type: string description: A feature collection of County identifiers. CountriesFeature: content: application/geo+json: example: geometry: null id: US properties: country_name: United States of America id: US type: Feature schema: $ref: '#/components/schemas/CountriesFeature' text/html: schema: type: string description: A single feature from Country identifiers. CountriesFeatures: content: application/geo+json: example: features: - geometry: null id: US properties: country_name: United States of America id: US type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/countries/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/CountriesFeatureCollection' text/html: schema: type: string description: A feature collection of Country identifiers. DailyFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature schema: $ref: '#/components/schemas/DailyFeature' text/html: schema: type: string description: A single feature from Daily values. DailyFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/daily/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/DailyFeatureCollection' text/html: schema: type: string description: A feature collection of Daily values. FieldMeasurementsFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved control_condition: Clear day: 15 field_measurements_series_id: WDA-STABLE-SERIES-0001 field_visit_id: 00000000-0000-0000-0000-000000000002 last_modified: '2025-06-16T14:13:28+00:00' measurement_rated: Fair measuring_agency: USGS monitoring_location_id: USGS-09380000 month: 6 observing_procedure: GW level, calib steel tape observing_procedure_code: S parameter_code: '00060' qualifier: Ice reading_type: ReferencePrimary time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 unit_of_measure: ft3/s value: '579.40' vertical_datum: NAVD88 year: 2020 type: Feature schema: $ref: '#/components/schemas/FieldMeasurementsFeature' text/html: schema: type: string description: A single feature from Field measurements. FieldMeasurementsFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved control_condition: Clear day: 15 field_measurements_series_id: WDA-STABLE-SERIES-0001 field_visit_id: 00000000-0000-0000-0000-000000000002 last_modified: '2025-06-16T14:13:28+00:00' measurement_rated: Fair measuring_agency: USGS monitoring_location_id: USGS-09380000 month: 6 observing_procedure: GW level, calib steel tape observing_procedure_code: S parameter_code: '00060' qualifier: Ice reading_type: ReferencePrimary time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 unit_of_measure: ft3/s value: '579.40' vertical_datum: NAVD88 year: 2020 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/FieldMeasurementsFeatureCollection' text/html: schema: type: string description: A feature collection of Field measurements. FieldMeasurementsMetadataFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: WDA-STABLE-SERIES-0001 properties: begin: '2007-10-01T06:00:00+00:00' end: '2026-06-21T05:00:00+00:00' id: WDA-STABLE-SERIES-0001 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s reading_type: ReferencePrimary type: Feature schema: $ref: '#/components/schemas/FieldMeasurementsMetadataFeature' text/html: schema: type: string description: A single feature from Field measurements metadata. FieldMeasurementsMetadataFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: WDA-STABLE-SERIES-0001 properties: begin: '2007-10-01T06:00:00+00:00' end: '2026-06-21T05:00:00+00:00' id: WDA-STABLE-SERIES-0001 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s reading_type: ReferencePrimary type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements-metadata/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/FieldMeasurementsMetadataFeatureCollection' text/html: schema: type: string description: A feature collection of Field measurements metadata. Forbidden403: content: application/json: examples: missingApiKey: summary: Missing API Key value: error: code: API_KEY_MISSING message: No api_key was supplied. Get one at https://api.waterdata.usgs.gov/signup/ schema: $ref: '#/components/schemas/Error' application/xml: example: "<response>\n <error>\n <code>API_KEY_MISSING</code>\n <message>No\ \ api_key was supplied. Get one at https://api.waterdata.usgs.gov/signup/</message>\n </error>\n\ \ </response>" schema: properties: response: properties: error: properties: code: type: string message: type: string required: - code - message type: object required: - error type: object type: object text/csv: examples: missingApiKeyCsv: summary: Missing API Key (CSV) value: 'Error Code,Error Message API_KEY_MISSING, No api_key was supplied. Get one at https://api.waterdata.usgs.gov/signup/' schema: type: string text/html: examples: missingApiKeyHtml: summary: Missing API Key (HTML) value: "<html>\n <body>\n <h1>API_KEY_MISSING</h1>\n <p>No\ \ api_key was supplied. Get one at https://api.waterdata.usgs.gov/signup/</p>\n </body>\n\ \ </html>" schema: type: string description: Forbidden - API key is missing or not authorized for this resource. HydrologicUnitCodesFeature: content: application/geo+json: example: geometry: null id: '01' properties: hydrologic_unit_classification_code: R hydrologic_unit_name: New England Region id: '01' type: Feature schema: $ref: '#/components/schemas/HydrologicUnitCodesFeature' text/html: schema: type: string description: A single feature from Hydrologic unit codes (HUCs). HydrologicUnitCodesFeatures: content: application/geo+json: example: features: - geometry: null id: '01' properties: hydrologic_unit_classification_code: R hydrologic_unit_name: New England Region id: '01' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/hydrologic-unit-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/HydrologicUnitCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Hydrologic unit codes (HUCs). LatestContinuousFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature schema: $ref: '#/components/schemas/LatestContinuousFeature' text/html: schema: type: string description: A single feature from Latest continuous. LatestContinuousFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/latest-continuous/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/LatestContinuousFeatureCollection' text/html: schema: type: string description: A feature collection of Latest continuous. LatestDailyFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature schema: $ref: '#/components/schemas/LatestDailyFeature' text/html: schema: type: string description: A single feature from Latest daily values. LatestDailyFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' qualifier: Ice statistic_id: '00003' time: '2024-06-15T14:00:00+00:00' time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/latest-daily/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/LatestDailyFeatureCollection' text/html: schema: type: string description: A feature collection of Latest daily values. LatestFieldMeasurementsFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved control_condition: Clear day: 15 field_measurements_series_id: WDA-STABLE-SERIES-0001 field_visit_id: 00000000-0000-0000-0000-000000000002 last_modified: '2025-06-16T14:13:28+00:00' measurement_rated: Fair measuring_agency: USGS monitoring_location_id: USGS-09380000 month: 6 observing_procedure: GW level, calib steel tape observing_procedure_code: S parameter_code: '00060' qualifier: Ice time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 unit_of_measure: ft3/s value: '579.40' vertical_datum: NAVD88 year: 2020 type: Feature schema: $ref: '#/components/schemas/LatestFieldMeasurementsFeature' text/html: schema: type: string description: A single feature from Latest field measurements. LatestFieldMeasurementsFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: approval_status: Approved control_condition: Clear day: 15 field_measurements_series_id: WDA-STABLE-SERIES-0001 field_visit_id: 00000000-0000-0000-0000-000000000002 last_modified: '2025-06-16T14:13:28+00:00' measurement_rated: Fair measuring_agency: USGS monitoring_location_id: USGS-09380000 month: 6 observing_procedure: GW level, calib steel tape observing_procedure_code: S parameter_code: '00060' qualifier: Ice time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 unit_of_measure: ft3/s value: '579.40' vertical_datum: NAVD88 year: 2020 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/latest-field-measurements/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/LatestFieldMeasurementsFeatureCollection' text/html: schema: type: string description: A feature collection of Latest field measurements. MediumCodesFeature: content: application/geo+json: example: geometry: null id: OA properties: id: OA legacy_medium_code: A medium_description: Any substance that is not part of an aquatic environment and cannot be described by the Sample Medium Codes medium_name: Artificial type: Feature schema: $ref: '#/components/schemas/MediumCodesFeature' text/html: schema: type: string description: A single feature from Medium codes. MediumCodesFeatures: content: application/geo+json: example: features: - geometry: null id: OA properties: id: OA legacy_medium_code: A medium_description: Any substance that is not part of an aquatic environment and cannot be described by the Sample Medium Codes medium_name: Artificial type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/medium-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/MediumCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Medium codes. MethodCategoriesFeature: content: application/geo+json: example: geometry: null id: STNRD properties: id: STNRD method_category_description: Data obtained by Standardized methods follow approved standard field methods or validated laboratory analytical methods, have known uncertainty or defined bias and variability, and follow rigorous quality assurance and quality control (QA/QC) workflows. Method category of Standardized should not be confused with approved USEPA 'Standard Methods' for water and wastewater analysis. method_category_name: Standardized type: Feature schema: $ref: '#/components/schemas/MethodCategoriesFeature' text/html: schema: type: string description: A single feature from Method categories. MethodCategoriesFeatures: content: application/geo+json: example: features: - geometry: null id: STNRD properties: id: STNRD method_category_description: Data obtained by Standardized methods follow approved standard field methods or validated laboratory analytical methods, have known uncertainty or defined bias and variability, and follow rigorous quality assurance and quality control (QA/QC) workflows. Method category of Standardized should not be confused with approved USEPA 'Standard Methods' for water and wastewater analysis. method_category_name: Standardized type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/method-categories/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/MethodCategoriesFeatureCollection' text/html: schema: type: string description: A feature collection of Method categories. MethodCitationsFeature: content: application/geo+json: example: geometry: null id: 1 properties: citation_method_number: O-2080-08 citation_name: USGS TMR 5-B5 id: 1 method_id: '00021' method_source: USGS type: Feature schema: $ref: '#/components/schemas/MethodCitationsFeature' text/html: schema: type: string description: A single feature from Method citations. MethodCitationsFeatures: content: application/geo+json: example: features: - geometry: null id: 1 properties: citation_method_number: O-2080-08 citation_name: USGS TMR 5-B5 id: 1 method_id: '00021' method_source: USGS type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/method-citations/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/MethodCitationsFeatureCollection' text/html: schema: type: string description: A feature collection of Method citations. MethodsFeature: content: application/geo+json: example: geometry: null id: '00001' properties: id: '00001' method_category: UNKWN method_description: AMMONIA+ORGANIC-N,SUS method_name: NH3+org-N, sus method_type: QW type: Feature schema: $ref: '#/components/schemas/MethodsFeature' text/html: schema: type: string description: A single feature from Water measurement methods. MethodsFeatures: content: application/geo+json: example: features: - geometry: null id: '00001' properties: id: '00001' method_category: UNKWN method_description: AMMONIA+ORGANIC-N,SUS method_name: NH3+org-N, sus method_type: QW type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/methods/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/MethodsFeatureCollection' text/html: schema: type: string description: A feature collection of Water measurement methods. MonitoringLocationsFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: USGS-09380000 properties: agency_code: USGS agency_name: U.S. Geological Survey altitude: '930.63' altitude_accuracy: '0.16' altitude_method_code: X altitude_method_name: GNSS2 - Level 2 Quality Survey Grade Global Navigation Satellite System aquifer_code: 300GRNT aquifer_type_code: U basin_code: '01' construction_date: '19630101' contributing_drainage_area: '1338' country_code: US country_name: United States of America county_code: '005' county_name: Coconino County depth_source_code: D district_code: '04' drainage_area: '1338' hole_constructed_depth: '160' horizontal_position_method_code: N horizontal_position_method_name: Interpolated from digital map horizontal_positional_accuracy: Accurate to + or - 1 sec. horizontal_positional_accuracy_code: S hydrologic_unit_code: '15010001' id: USGS-09380000 minor_civil_division_code: '01465' monitoring_location_name: Colorado River at Lees Ferry, AZ monitoring_location_number: 09380000 national_aquifer_code: N100CMBRINM original_horizontal_datum: NAD83 original_horizontal_datum_name: North American Datum of 1983 revision_created: '2017-11-13T06:00:00+00:00' revision_modified: '2024-06-14T13:30:29+00:00' revision_note: Drainage area revised. site_type: Stream site_type_code: ST state_code: '04' state_name: Arizona time_zone_abbreviation: MST uses_daylight_savings: Y vertical_datum: NAVD88 vertical_datum_name: North American Vertical Datum of 1988 well_constructed_depth: '150' type: Feature schema: $ref: '#/components/schemas/MonitoringLocationsFeature' text/html: schema: type: string description: A single feature from Monitoring locations. MonitoringLocationsFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: USGS-09380000 properties: agency_code: USGS agency_name: U.S. Geological Survey altitude: '930.63' altitude_accuracy: '0.16' altitude_method_code: X altitude_method_name: GNSS2 - Level 2 Quality Survey Grade Global Navigation Satellite System aquifer_code: 300GRNT aquifer_type_code: U basin_code: '01' construction_date: '19630101' contributing_drainage_area: '1338' country_code: US country_name: United States of America county_code: '005' county_name: Coconino County depth_source_code: D district_code: '04' drainage_area: '1338' hole_constructed_depth: '160' horizontal_position_method_code: N horizontal_position_method_name: Interpolated from digital map horizontal_positional_accuracy: Accurate to + or - 1 sec. horizontal_positional_accuracy_code: S hydrologic_unit_code: '15010001' id: USGS-09380000 minor_civil_division_code: '01465' monitoring_location_name: Colorado River at Lees Ferry, AZ monitoring_location_number: 09380000 national_aquifer_code: N100CMBRINM original_horizontal_datum: NAD83 original_horizontal_datum_name: North American Datum of 1983 revision_created: '2017-11-13T06:00:00+00:00' revision_modified: '2024-06-14T13:30:29+00:00' revision_note: Drainage area revised. site_type: Stream site_type_code: ST state_code: '04' state_name: Arizona time_zone_abbreviation: MST uses_daylight_savings: Y vertical_datum: NAVD88 vertical_datum_name: North American Vertical Datum of 1988 well_constructed_depth: '150' type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/MonitoringLocationsFeatureCollection' text/html: schema: type: string description: A feature collection of Monitoring locations. NationalAquiferCodesFeature: content: application/geo+json: example: geometry: null id: N300ADAVMS properties: id: N300ADAVMS national_aquifer_name: Ada-Vamoosa aquifer type: Feature schema: $ref: '#/components/schemas/NationalAquiferCodesFeature' text/html: schema: type: string description: A single feature from National aquifer codes. NationalAquiferCodesFeatures: content: application/geo+json: example: features: - geometry: null id: N300ADAVMS properties: id: N300ADAVMS national_aquifer_name: Ada-Vamoosa aquifer type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/NationalAquiferCodesFeatureCollection' text/html: schema: type: string description: A feature collection of National aquifer codes. ParameterCodesFeature: content: application/geo+json: example: geometry: null id: '00001' properties: epa_equivalence: Agree id: '00001' medium: Water parameter_description: Location in cross section, distance from right bank looking upstream, feet parameter_group_code: INF parameter_name: Xsec loc, US from rb particle_size_basis: example-value sample_fraction: Total statistical_basis: example-value temperature_basis: example-value time_basis: example-value unit_of_measure: ft weight_basis: example-value type: Feature schema: $ref: '#/components/schemas/ParameterCodesFeature' text/html: schema: type: string description: A single feature from Parameter codes. ParameterCodesFeatures: content: application/geo+json: example: features: - geometry: null id: '00001' properties: epa_equivalence: Agree id: '00001' medium: Water parameter_description: Location in cross section, distance from right bank looking upstream, feet parameter_group_code: INF parameter_name: Xsec loc, US from rb particle_size_basis: example-value sample_fraction: Total statistical_basis: example-value temperature_basis: example-value time_basis: example-value unit_of_measure: ft weight_basis: example-value type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/ParameterCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Parameter codes. PeaksFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: day: 15 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 month: 6 parameter_code: '00060' peak_since: 1 qualifier: Ice time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' water_year: 2020 year: 2020 type: Feature schema: $ref: '#/components/schemas/PeaksFeature' text/html: schema: type: string description: A single feature from Peaks. PeaksFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 properties: day: 15 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 month: 6 parameter_code: '00060' peak_since: 1 qualifier: Ice time: '2024-06-15T14:00:00+00:00' time_of_day: 12:00:00+00:00 time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 unit_of_measure: ft3/s value: '579.40' water_year: 2020 year: 2020 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/peaks/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/PeaksFeatureCollection' text/html: schema: type: string description: A feature collection of Peaks. Queryables: content: application/json: schema: $ref: '#/components/schemas/queryables' description: successful queryables operation ReliabilityCodesFeature: content: application/geo+json: example: geometry: null id: C properties: id: C reliability_description: Data have been field checked by the reporting agency. type: Feature schema: $ref: '#/components/schemas/ReliabilityCodesFeature' text/html: schema: type: string description: A single feature from Reliability codes. ReliabilityCodesFeatures: content: application/geo+json: example: features: - geometry: null id: C properties: id: C reliability_description: Data have been field checked by the reporting agency. type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/reliability-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/ReliabilityCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Reliability codes. SiteTypesFeature: content: application/geo+json: example: geometry: null id: GL properties: id: GL site_type_description: Body of land ice that consists of recrystallized snow accumulated on the surface of the ground and moves slowly downslope (WSP-1541A) over a period of years or centuries. Since glacial sites move, the lat-long precision for these sites is usually coarse. site_type_name: Glacier site_type_primary_flag: Y type: Feature schema: $ref: '#/components/schemas/SiteTypesFeature' text/html: schema: type: string description: A single feature from Site types. SiteTypesFeatures: content: application/geo+json: example: features: - geometry: null id: GL properties: id: GL site_type_description: Body of land ice that consists of recrystallized snow accumulated on the surface of the ground and moves slowly downslope (WSP-1541A) over a period of years or centuries. Since glacial sites move, the lat-long precision for these sites is usually coarse. site_type_name: Glacier site_type_primary_flag: Y type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/SiteTypesFeatureCollection' text/html: schema: type: string description: A feature collection of Site types. StatesFeature: content: application/geo+json: example: geometry: null id: AD-00 properties: country_code: AD id: AD-00 state_fips_code: '00' state_name: Unspecified state_postal_code: example-value type: Feature schema: $ref: '#/components/schemas/StatesFeature' text/html: schema: type: string description: A single feature from State identifiers. StatesFeatures: content: application/geo+json: example: features: - geometry: null id: AD-00 properties: country_code: AD id: AD-00 state_fips_code: '00' state_name: Unspecified state_postal_code: example-value type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/states/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/StatesFeatureCollection' text/html: schema: type: string description: A feature collection of State identifiers. StatisticCodesFeature: content: application/geo+json: example: geometry: null id: '00001' properties: id: '00001' statistic_description: MAXIMUM VALUES statistic_name: MAXIMUM type: Feature schema: $ref: '#/components/schemas/StatisticCodesFeature' text/html: schema: type: string description: A single feature from Statistic codes. StatisticCodesFeatures: content: application/geo+json: example: features: - geometry: null id: '00001' properties: id: '00001' statistic_description: MAXIMUM VALUES statistic_name: MAXIMUM type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/StatisticCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Statistic codes. Tiles: content: application/json: schema: $ref: '#/components/schemas/tiles' description: Retrieves the tiles description for this collection TimeSeriesMetadataFeature: content: application/geo+json: example: geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 properties: begin: '2007-10-01T00:00:00+00:00' begin_utc: '2007-10-01T06:00:00+00:00' computation_identifier: Mean computation_period_identifier: Daily data_gap_interval: P1D end: '2026-06-21T00:00:00+00:00' end_utc: '2026-06-21T05:00:00+00:00' hydrologic_unit_code: '15010001' id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s parent_time_series_id: 786d481eaa73420da68a5a08a4302e76 primary: Primary state_name: Arizona statistic_id: '00003' sublocation_identifier: Downstream thresholds: [] unit_of_measure: ft3/s web_description: Discharge, cubic feet per second, from river/stream type: Feature schema: $ref: '#/components/schemas/TimeSeriesMetadataFeature' text/html: schema: type: string description: A single feature from Time series metadata. TimeSeriesMetadataFeatures: content: application/geo+json: example: features: - geometry: coordinates: - -88.01 - 44.5286111111111 type: Point id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 properties: begin: '2007-10-01T00:00:00+00:00' begin_utc: '2007-10-01T06:00:00+00:00' computation_identifier: Mean computation_period_identifier: Daily data_gap_interval: P1D end: '2026-06-21T00:00:00+00:00' end_utc: '2026-06-21T05:00:00+00:00' hydrologic_unit_code: '15010001' id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 last_modified: '2025-06-16T14:13:28+00:00' monitoring_location_id: USGS-09380000 parameter_code: '00060' parameter_description: Discharge, cubic feet per second parameter_name: Discharge, ft3/s parent_time_series_id: 786d481eaa73420da68a5a08a4302e76 primary: Primary state_name: Arizona statistic_id: '00003' sublocation_identifier: Downstream thresholds: [] unit_of_measure: ft3/s web_description: Discharge, cubic feet per second, from river/stream type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/time-series-metadata/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/TimeSeriesMetadataFeatureCollection' text/html: schema: type: string description: A feature collection of Time series metadata. TimeSeriesRevisionsFeature: content: application/geo+json: example: geometry: null id: 6c4c51cd-30ed-43d7-b4dd-b64ba9476b93 properties: begin: '2007-10-01T06:00:00+00:00' end: '2026-06-21T05:00:00+00:00' id: 6c4c51cd-30ed-43d7-b4dd-b64ba9476b93 monitoring_location_id: USGS-09380000 revision_note: Drainage area revised. time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 type: Feature schema: $ref: '#/components/schemas/TimeSeriesRevisionsFeature' text/html: schema: type: string description: A single feature from Time series revisions. TimeSeriesRevisionsFeatures: content: application/geo+json: example: features: - geometry: null id: 6c4c51cd-30ed-43d7-b4dd-b64ba9476b93 properties: begin: '2007-10-01T06:00:00+00:00' end: '2026-06-21T05:00:00+00:00' id: 6c4c51cd-30ed-43d7-b4dd-b64ba9476b93 monitoring_location_id: USGS-09380000 revision_note: Drainage area revised. time_series_id: 6b0fefaa5f8a41a6b5907b31f2f4eb03 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/time-series-revisions/items rel: self title: This document as GeoJSON type: application/geo+json numberMatched: 1 numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/TimeSeriesRevisionsFeatureCollection' text/html: schema: type: string description: A feature collection of Time series revisions. TimeZoneCodesFeature: content: application/geo+json: example: geometry: null id: UTC properties: id: UTC time_zone_daylight_savings_time_code: NDT time_zone_daylight_savings_time_name: Newfoundland Daylight Time time_zone_daylight_savings_utc_offset: -02:30 time_zone_description: Universal Coordinated Time time_zone_name: Universal Coordinated Time time_zone_utc_offset: +00:00 type: Feature schema: $ref: '#/components/schemas/TimeZoneCodesFeature' text/html: schema: type: string description: A single feature from Time zone codes. TimeZoneCodesFeatures: content: application/geo+json: example: features: - geometry: null id: UTC properties: id: UTC time_zone_daylight_savings_time_code: NDT time_zone_daylight_savings_time_name: Newfoundland Daylight Time time_zone_daylight_savings_utc_offset: -02:30 time_zone_description: Universal Coordinated Time time_zone_name: Universal Coordinated Time time_zone_utc_offset: +00:00 type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/time-zone-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/TimeZoneCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Time zone codes. TooManyRequests429: content: application/json: examples: rateLimitExceeded: summary: Rate Limit Exceeded value: error: code: OVER_RATE_LIMIT message: You have exceeded your rate limit. Make sure you provided your API key from https://api.waterdata.usgs.gov/signup/, then either try again later or contact us at https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov for assistance. schema: $ref: '#/components/schemas/Error' application/xml: example: "<response>\n <error>\n <code>OVER_RATE_LIMIT</code>\n <message>You\ \ have exceeded your rate limit. Make sure you provided your API key from https://api.waterdata.usgs.gov/signup/,\ \ then either try again later or contact us at https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov\ \ for assistance.</message>\n </error>\n </response>" schema: properties: response: properties: error: properties: code: type: string message: type: string required: - code - message type: object required: - error type: object type: object text/csv: examples: rateLimitCsv: summary: Rate Limit Exceeded (CSV) value: 'Error Code,Error Message OVER_RATE_LIMIT,You have exceeded your rate limit. Make sure you provided your API key from https://api.waterdata.usgs.gov/signup/, then either try again later or contact us at https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov for assistance.' schema: type: string text/html: examples: rateLimitHtml: summary: Rate Limit Exceeded (HTML) value: "<html>\n <body>\n <h1>OVER_RATE_LIMIT</h1>\n <p>You\ \ have exceeded your rate limit. Make sure you provided your API key from https://api.waterdata.usgs.gov/signup/,\ \ then either try again later or contact us at https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov\ \ for assistance.</p>\n </body>\n </html>" schema: type: string description: Too Many Requests - Rate limit exceeded. TopographicCodesFeature: content: application/geo+json: example: geometry: null id: A properties: full_topography_description: Alluvial fan refers to a low, outspread, relatively flat to gently sloping mass of loose rock material shaped like an open fan or a segment of a cone. It is deposited by a stream at a place where it issues from a narrow mountain valley upon a plain or broad valley. id: A short_topography_description: Stream deposit of loose rock material where it issues from a narrow mountain valley upon a plain. topography_name: Alluvial fan type: Feature schema: $ref: '#/components/schemas/TopographicCodesFeature' text/html: schema: type: string description: A single feature from Topographic codes. TopographicCodesFeatures: content: application/geo+json: example: features: - geometry: null id: A properties: full_topography_description: Alluvial fan refers to a low, outspread, relatively flat to gently sloping mass of loose rock material shaped like an open fan or a segment of a cone. It is deposited by a stream at a place where it issues from a narrow mountain valley upon a plain or broad valley. id: A short_topography_description: Stream deposit of loose rock material where it issues from a narrow mountain valley upon a plain. topography_name: Alluvial fan type: Feature links: - href: https://api.waterdata.usgs.gov/ogcapi/v0/collections/topographic-codes/items rel: self title: This document as GeoJSON type: application/geo+json numberReturned: 1 timeStamp: '2024-07-21T12:00:00Z' type: FeatureCollection schema: $ref: '#/components/schemas/TopographicCodesFeatureCollection' text/html: schema: type: string description: A feature collection of Topographic codes. default: content: application/json: schema: $ref: https://schemas.opengis.net/ogcapi/processes/part1/1.0/openapi/schemas/exception.yaml description: Unexpected error schemas: AgencyCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: agency_name: description: Agency name. nullable: true type: string id: description: Agency code identification number. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object AgencyCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/AgencyCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object AltitudeDatumsFeature: properties: geometry: nullable: true id: type: string properties: properties: altitude_datum_description: nullable: true type: string id: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object AltitudeDatumsFeatureCollection: properties: features: items: $ref: '#/components/schemas/AltitudeDatumsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object AquiferCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: aquifer_name: description: Aquifer name. Aquifer names are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" nullable: true type: string id: description: Aquifer code. The eight-character string identifying an aquifer. Codes are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object AquiferCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/AquiferCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object AquiferTypesFeature: properties: geometry: nullable: true id: type: string properties: properties: aquifer_type_description: description: Longer description of the aquifer type. nullable: true type: string id: description: The single-character code identifying the type of aquifer nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object AquiferTypesFeatureCollection: properties: features: items: $ref: '#/components/schemas/AquiferTypesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object ChannelMeasurementsFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: channel_area: description: The channel area. nullable: true title: Channel area type: string channel_area_unit: description: The units for channel area. nullable: true title: Channel area unit type: string channel_evenness: description: The channel evenness from bank to bank. nullable: true title: Channel evenness type: string channel_flow: description: Channel discharge. nullable: true title: Channel flow type: string channel_flow_unit: description: The units for channel discharge. nullable: true title: Channel flow unit type: string channel_location_direction: description: Location of the measurement from the gage. nullable: true title: Channel Location Direction type: string channel_location_distance: description: The channel location distance. nullable: true title: Channel location distance type: string channel_location_distance_unit: description: The units for channel location distance. nullable: true title: Channel location distance unit type: string channel_material: description: The channel material. nullable: true title: Channel material type: string channel_measurement_type: description: The channel measurement type. nullable: true title: Channel measurement type type: string channel_name: description: The channel name. nullable: true title: Channel name type: string channel_stability: description: The stability of the channel material. nullable: true title: Channel stability type: string channel_velocity: description: The mean channel velocity. nullable: true title: Channel velocity type: string channel_velocity_unit: description: The units for channel velocity. nullable: true title: Channel velocity unit type: string channel_width: description: The channel width. nullable: true title: Channel width type: string channel_width_unit: description: The units for channel width. nullable: true title: Channel width unit type: string field_visit_id: description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' format: uuid nullable: true title: Field visit ID type: string horizontal_velocity_description: description: The horizontal velocity description. nullable: true title: Horizontal velocity description type: string id: description: 'A universally unique identifier (UUID) representing a single version of a record. It is not stable over time. Every time the record is refreshed in our database (which may happen as part of normal operations and does not imply any change to the data itself) a new ID will be generated. To uniquely identify a single observation over time, compare the `time` and `time_series_id` fields; each time series will only have a single observation at a given `time`. ' format: uuid nullable: true title: Record identifier type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string longitudinal_velocity_description: description: The longitudinal velocity description. nullable: true title: Longitudinal velocity description type: string measurement_number: description: Measurement number. nullable: true title: Measurement number type: string measurement_type: description: The measurement type. nullable: true title: Measurement type type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string vertical_velocity_description: description: The vertical velocity description. nullable: true title: Vertical velocity description type: string type: object type: enum: - Feature type: string required: - type - properties type: object ChannelMeasurementsFeatureCollection: properties: features: items: $ref: '#/components/schemas/ChannelMeasurementsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CitationsFeature: properties: geometry: nullable: true id: type: string properties: properties: citation_description: description: Method citation description. nullable: true type: string id: description: Method citation name. An abbreviated citation that describes the reference. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CitationsFeatureCollection: properties: features: items: $ref: '#/components/schemas/CitationsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CombinedMetadataFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: agency_code: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' nullable: true title: Agency code type: string agency_name: description: 'The name of the agency that is reporting the data. ' nullable: true title: Agency name type: string altitude: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' nullable: true title: Altitude type: number altitude_accuracy: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' nullable: true title: Altitude accuracy type: number altitude_method_code: description: 'Codes representing the method used to measure altitude. ' nullable: true title: Altitude method code type: string altitude_method_name: description: 'The name of the method used to measure altitude. ' nullable: true title: Altitude method name type: string aquifer_code: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' nullable: true title: Aquifer code type: string aquifer_type_code: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' nullable: true title: Aquifer type code type: string basin_code: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' nullable: true title: Basin code type: string begin: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field\ \ represents the period of record of a time series. Note that some time series may have large gaps in their\ \ collection record.\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using\ \ ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\ \n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `begin_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series first observation timestamp - UTC type: string computation_identifier: description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. nullable: true title: Computation identifier type: string construction_date: description: 'Date the well was completed. ' nullable: true title: Construction date type: string contributing_drainage_area: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' nullable: true title: Contributing drainage area type: number country_code: description: 'The code for the country in which the monitoring location is located. ' nullable: true title: Country code type: string country_name: description: 'The name of the country in which the monitoring location is located. ' nullable: true title: Country name type: string county_code: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' nullable: true title: County code type: string county_name: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' nullable: true title: County name type: string data_gap_interval: description: 'The time interval threshold used for gap detection in the time series. ' format: duration nullable: true title: Data gap interval type: string data_type: description: The computational period type of data collected at the monitoring location. nullable: true title: Data type type: string depth_source_code: description: 'A code indicating the source of water-level data. ' nullable: true title: Depth source code type: string district_code: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' nullable: true title: District code type: string drainage_area: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' nullable: true title: Drainage area type: number end: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint\ \ updates at most once per day, and potentially less frequently than that, and as such there may be more recent\ \ observations within a time series than the time series `end_utc` value reflects. Together with `begin_utc`,\ \ this field represents the period of record of a time series. It is additionally used to determine whether\ \ a time series is \"active\".\nYou can query this field using date-times or intervals, adhering to RFC 3339,\ \ or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\n\ Examples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `end_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series most recent observation timestamp - UTC type: string hole_constructed_depth: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' nullable: true title: Hole constructed depth type: number horizontal_position_method_code: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' nullable: true title: Horizontal position method code type: string horizontal_position_method_name: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' nullable: true title: Horizontal position method name type: string horizontal_positional_accuracy: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' nullable: true title: Horizontal positional accuracy type: string horizontal_positional_accuracy_code: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' nullable: true title: Horizontal positional accuracy code type: string hydrologic_unit_code: description: 'The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with a shorter HUC (e.g. "04") matches all locations within that hydrologic region. ' nullable: true title: Hydrologic unit code (HUC) type: string id: description: The ID of the time series or field measurement series (identified by `data_type`) that collection metadata corresponds to. nullable: true title: Data series ID type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string minor_civil_division_code: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' nullable: true title: Minor civil division code type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string monitoring_location_name: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' nullable: true title: Monitoring location name type: string monitoring_location_number: description: 'Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number. ' nullable: true title: Monitoring location number type: string national_aquifer_code: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' nullable: true title: National aquifer code type: string original_horizontal_datum: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' nullable: true title: Original horizontal datum type: string original_horizontal_datum_name: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' nullable: true title: Original horizontal datum name type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string parameter_description: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' nullable: true title: Parameter description type: string parameter_name: description: A human-understandable name corresponding to `parameter_code`. nullable: true title: Parameter name type: string parent_time_series_id: description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' nullable: true title: Parent time series ID type: string primary: description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' nullable: true title: Primary flag type: string reading_type: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' nullable: true title: Reading type type: string site_type: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' nullable: true title: Monitoring location type type: string site_type_code: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' nullable: true title: Monitoring location type code type: string state_code: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' nullable: true title: State code type: string state_name: description: 'The name of the state or state equivalent in which the monitoring location is located. ' nullable: true title: State name type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string sublocation_identifier: description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' nullable: true title: Sublocation identifier type: string thresholds: description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' nullable: true title: Operational thresholds type: string time_zone_abbreviation: description: 'A short code describing the time zone used by a monitoring location. ' nullable: true title: Time zone abbreviation type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string uses_daylight_savings: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' nullable: true title: Uses daylight savings flag type: string vertical_datum: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum type: string vertical_datum_name: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum name type: string web_description: description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' nullable: true title: Time series description type: string well_constructed_depth: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' nullable: true title: Well constructed depth type: number type: object type: enum: - Feature type: string required: - type - properties type: object CombinedMetadataFeatureCollection: properties: features: items: $ref: '#/components/schemas/CombinedMetadataFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object ContinuousFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string type: object type: enum: - Feature type: string required: - type - properties type: object ContinuousFeatureCollection: properties: features: items: $ref: '#/components/schemas/ContinuousFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CoordinateAccuracyCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: coordinate_accuracy_description: nullable: true type: string id: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CoordinateAccuracyCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/CoordinateAccuracyCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CoordinateDatumCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: coordinate_datum_description: nullable: true type: string id: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CoordinateDatumCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/CoordinateDatumCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CoordinateMethodCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: coordinate_method_description: nullable: true type: string id: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CoordinateMethodCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/CoordinateMethodCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CountiesFeature: properties: geometry: nullable: true id: type: string properties: properties: country_code: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' nullable: true type: string county_fips_code: description: County FIPS code. A two digit code indicating a U.S. county as defined by FIPS 5-2. nullable: true type: string county_name: description: County name. The name of a U.S. county as defined by FIPS 5-2. nullable: true type: string id: nullable: true type: string state_fips_code: description: State FIPS code. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CountiesFeatureCollection: properties: features: items: $ref: '#/components/schemas/CountiesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object CountriesFeature: properties: geometry: nullable: true id: type: string properties: properties: country_name: description: Country name. nullable: true type: string id: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object CountriesFeatureCollection: properties: features: items: $ref: '#/components/schemas/CountriesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object DailyFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string type: object type: enum: - Feature type: string required: - type - properties type: object DailyFeatureCollection: properties: features: items: $ref: '#/components/schemas/DailyFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object Error: properties: error: properties: code: description: Error code such as OVER_RATE_LIMIT, see https://api.data.gov/docs/developer-manual/#general-web-service-errors type: string message: description: Error message type: string required: - code - message type: object type: object FieldMeasurementsFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string control_condition: description: 'The state of the control feature at the time of observation. ' nullable: true title: Control condition type: string day: description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' nullable: true title: Day type: integer field_measurements_series_id: description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' nullable: true title: Field measurements series ID type: string field_visit_id: description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' format: uuid nullable: true title: Field visit ID type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string measurement_rated: description: 'A qualitative estimate of the quality of a measurement. ' nullable: true title: Measurement rating type: string measuring_agency: description: The agency performing the measurement. nullable: true title: Measuring agency type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string month: description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' nullable: true title: Month type: integer observing_procedure: description: Water measurement or water-quality observing procedure descriptions. nullable: true title: Observing procedure type: string observing_procedure_code: description: A short code corresponding to the observing procedure for the field measurement. nullable: true title: Observing procedure code type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string reading_type: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' nullable: true title: Reading type type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_of_day: description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' format: time nullable: true title: Time of Day type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string vertical_datum: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum type: string year: description: 'The calendar year the field measurement was taken. ' nullable: true title: Year type: integer type: object type: enum: - Feature type: string required: - type - properties type: object FieldMeasurementsFeatureCollection: properties: features: items: $ref: '#/components/schemas/FieldMeasurementsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object FieldMeasurementsMetadataFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: begin: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field\ \ represents the period of record of a time series. Note that some time series may have large gaps in their\ \ collection record.\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using\ \ ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\ \n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `begin_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series first observation timestamp - UTC type: string end: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint\ \ updates at most once per day, and potentially less frequently than that, and as such there may be more recent\ \ observations within a time series than the time series `end_utc` value reflects. Together with `begin_utc`,\ \ this field represents the period of record of a time series. It is additionally used to determine whether\ \ a time series is \"active\".\nYou can query this field using date-times or intervals, adhering to RFC 3339,\ \ or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\n\ Examples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `end_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series most recent observation timestamp - UTC type: string id: description: 'A unique identifier representing a single collection series. This corresponds to the `field_measurement_series_id` field in the `field-measurements` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' nullable: true title: Field measurement series ID type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string parameter_description: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' nullable: true title: Parameter description type: string parameter_name: description: A human-understandable name corresponding to `parameter_code`. nullable: true title: Parameter name type: string reading_type: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' nullable: true title: Reading type type: string type: object type: enum: - Feature type: string required: - type - properties type: object FieldMeasurementsMetadataFeatureCollection: properties: features: items: $ref: '#/components/schemas/FieldMeasurementsMetadataFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object HydrologicUnitCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: hydrologic_unit_classification_code: description: Hydrologic unit classification code. nullable: true type: string hydrologic_unit_name: description: Hydrologic unit name. nullable: true type: string id: description: 'Hydrologic unit code. The format of the code is (''RRSSBBUUWWXX'') where: ''RR'' is the 2-digit code for the region. ''SS'' is the 2-digit code for the sub-region. ''BB'' is the 2-digit code for the basin. ''UU'' is the 2-digit code for the sub-basin. ''WW'' is the 2-digit code for the watershed. ''XX'' is the 2-digit code for the sub-watershed. Watersheds are delineated by USGS using a nationwide system based on surface hydrologic features. This system divides the country into 22 regions (2-digit), 245 subregions (4-digit), 405 basins (6-digit), ~2,400 subbasins (8-digit), ~19,000 watersheds (10-digit), and ~105,000 subwatersheds (12-digit). A hierarchical hydrologic unit code (HUC) consisting of 2 additional digits for each level in the hydrologic unit system is used to identify any hydrologic area (see Federal Standards and Procedures for the National Watershed Boundary Dataset - https://pubs.usgs.gov/tm/11/a3/).' nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object HydrologicUnitCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/HydrologicUnitCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object LatestContinuousFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string type: object type: enum: - Feature type: string required: - type - properties type: object LatestContinuousFeatureCollection: properties: features: items: $ref: '#/components/schemas/LatestContinuousFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object LatestDailyFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string type: object type: enum: - Feature type: string required: - type - properties type: object LatestDailyFeatureCollection: properties: features: items: $ref: '#/components/schemas/LatestDailyFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object LatestFieldMeasurementsFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: approval_status: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved nullable: true title: Approval Status type: string control_condition: description: 'The state of the control feature at the time of observation. ' nullable: true title: Control condition type: string day: description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' nullable: true title: Day type: integer field_measurements_series_id: description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' nullable: true title: Field measurements series ID type: string field_visit_id: description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' format: uuid nullable: true title: Field visit ID type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string measurement_rated: description: 'A qualitative estimate of the quality of a measurement. ' nullable: true title: Measurement rating type: string measuring_agency: description: The agency performing the measurement. nullable: true title: Measuring agency type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string month: description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' nullable: true title: Month type: integer observing_procedure: description: Water measurement or water-quality observing procedure descriptions. nullable: true title: Observing procedure type: string observing_procedure_code: description: A short code corresponding to the observing procedure for the field measurement. nullable: true title: Observing procedure code type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_of_day: description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' format: time nullable: true title: Time of Day type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string vertical_datum: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum type: string year: description: 'The calendar year the field measurement was taken. ' nullable: true title: Year type: integer type: object type: enum: - Feature type: string required: - type - properties type: object LatestFieldMeasurementsFeatureCollection: properties: features: items: $ref: '#/components/schemas/LatestFieldMeasurementsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object MediumCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: The medium code is the 3-character alpha code that identifies the material type and quality-assurance type of the sample. The first character of the code is the \"super\" medium, which describes the primary matrix of the sample. The second character is the sub-medium, which characterizes the sample type as a unique entity within the \"super\" medium category. The third character is used to designate whether a sample is an environmental or QC sample. A blank in position three denotes an environmental sample; a \"Q\" in position three denotes a QC sample. nullable: true type: string legacy_medium_code: description: Historical 1-char medium code that corresponds to the 3-char code. nullable: true type: string medium_description: description: The medium description is a short string of words that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. nullable: true type: string medium_name: description: The medium name is a short identifying appellation that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object MediumCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/MediumCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object MethodCategoriesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: Code representing the method category standard. nullable: true type: string method_category_description: description: Full description of the method category as defined by the USGS Water Mission Area standards for field and analytical methods and their fit-for-purpose use internally and for public delivery nullable: true type: string method_category_name: description: Name representing the method category standard. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object MethodCategoriesFeatureCollection: properties: features: items: $ref: '#/components/schemas/MethodCategoriesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object MethodCitationsFeature: properties: geometry: nullable: true id: type: string properties: properties: citation_method_number: description: Citation method number. A number assigned to a method within a cited reference. nullable: true type: string citation_name: description: Method citation name. An abbreviated citation that describes the reference. nullable: true type: string id: description: Citation method identification number. nullable: true type: integer method_id: description: USGS Central Laboratory method code. The lab method used to determine a parameter value. nullable: true type: string method_source: description: Protocol organization code. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object MethodCitationsFeatureCollection: properties: features: items: $ref: '#/components/schemas/MethodCitationsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object MethodsFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: Water measurement or water-quality analytical method code. The method used to determine a parameter value. nullable: true type: string method_category: description: Code representing the method category standard. nullable: true type: string method_description: description: A long name that fully describes a method. nullable: true type: string method_name: description: A short name that partially describes a method. nullable: true type: string method_type: description: Method type for measured or collected data nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object MethodsFeatureCollection: properties: features: items: $ref: '#/components/schemas/MethodsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object MonitoringLocationsFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: agency_code: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' nullable: true title: Agency code type: string agency_name: description: 'The name of the agency that is reporting the data. ' nullable: true title: Agency name type: string altitude: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' nullable: true title: Altitude type: number altitude_accuracy: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' nullable: true title: Altitude accuracy type: number altitude_method_code: description: 'Codes representing the method used to measure altitude. ' nullable: true title: Altitude method code type: string altitude_method_name: description: 'The name of the method used to measure altitude. ' nullable: true title: Altitude method name type: string aquifer_code: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' nullable: true title: Aquifer code type: string aquifer_type_code: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' nullable: true title: Aquifer type code type: string basin_code: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' nullable: true title: Basin code type: string construction_date: description: 'Date the well was completed. ' nullable: true title: Construction date type: string contributing_drainage_area: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' nullable: true title: Contributing drainage area type: number country_code: description: 'The code for the country in which the monitoring location is located. ' nullable: true title: Country code type: string country_name: description: 'The name of the country in which the monitoring location is located. ' nullable: true title: Country name type: string county_code: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' nullable: true title: County code type: string county_name: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' nullable: true title: County name type: string depth_source_code: description: 'A code indicating the source of water-level data. ' nullable: true title: Depth source code type: string district_code: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' nullable: true title: District code type: string drainage_area: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' nullable: true title: Drainage area type: number hole_constructed_depth: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' nullable: true title: Hole constructed depth type: number horizontal_position_method_code: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' nullable: true title: Horizontal position method code type: string horizontal_position_method_name: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' nullable: true title: Horizontal position method name type: string horizontal_positional_accuracy: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' nullable: true title: Horizontal positional accuracy type: string horizontal_positional_accuracy_code: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' nullable: true title: Horizontal positional accuracy code type: string hydrologic_unit_code: description: 'The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with a shorter HUC (e.g. "04") matches all locations within that hydrologic region. ' nullable: true title: Hydrologic unit code (HUC) type: string id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `monitoring_location_id` field in other endpoints. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string minor_civil_division_code: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' nullable: true title: Minor civil division code type: string monitoring_location_name: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' nullable: true title: Monitoring location name type: string monitoring_location_number: description: 'Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number. ' nullable: true title: Monitoring location number type: string national_aquifer_code: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' nullable: true title: National aquifer code type: string original_horizontal_datum: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' nullable: true title: Original horizontal datum type: string original_horizontal_datum_name: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' nullable: true title: Original horizontal datum name type: string revision_created: description: 'The date a revision statement was created. ' nullable: true title: Date revision created type: string revision_modified: description: 'The most recent date a revision statement was modified. ' nullable: true title: Date revision modified type: string revision_note: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' nullable: true title: Revision note type: string site_type: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' nullable: true title: Monitoring location type type: string site_type_code: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' nullable: true title: Monitoring location type code type: string state_code: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' nullable: true title: State code type: string state_name: description: 'The name of the state or state equivalent in which the monitoring location is located. ' nullable: true title: State name type: string time_zone_abbreviation: description: 'A short code describing the time zone used by a monitoring location. ' nullable: true title: Time zone abbreviation type: string uses_daylight_savings: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' nullable: true title: Uses daylight savings flag type: string vertical_datum: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum type: string vertical_datum_name: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' nullable: true title: Vertical datum name type: string well_constructed_depth: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' nullable: true title: Well constructed depth type: number type: object type: enum: - Feature type: string required: - type - properties type: object MonitoringLocationsFeatureCollection: properties: features: items: $ref: '#/components/schemas/MonitoringLocationsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object NationalAquiferCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: National aquifer code. nullable: true type: string national_aquifer_name: description: National aquifer name. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object NationalAquiferCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/NationalAquiferCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object ParameterCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: epa_equivalence: description: Indicates the relationship of the USGS parameter code to the EPA code. nullable: true type: string id: description: Parameter code. nullable: true type: string medium: description: Parameter medium. nullable: true type: string parameter_description: description: Parameter description. nullable: true type: string parameter_group_code: description: Categorical groupings of parameters by water-quality data type for display and report ordering nullable: true type: string parameter_name: description: Parameter short name. nullable: true type: string particle_size_basis: description: Parameter particle-size basis. nullable: true type: string sample_fraction: description: Parameter fraction. nullable: true type: string statistical_basis: description: Parameter statistical basis. nullable: true type: string temperature_basis: description: Parameter temperature basis. nullable: true type: string time_basis: description: Parameter time basis. nullable: true type: string unit_of_measure: description: Parameter reporting units defined to cooperate with descriptions by USEPA. nullable: true type: string weight_basis: description: Parameter weight basis. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object ParameterCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/ParameterCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object PeaksFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: day: description: 'The day of the month a peak occurred. If null, the day a peak occurred is unknown. ' nullable: true title: Day type: integer last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string month: description: 'The calendar month a peak occurred. If null, the month a peak occurred is unknown. ' nullable: true title: Month type: integer parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string peak_since: description: 'If not null, this record represents the peak value for the parameter code since the year contained in "peak_since". ' nullable: true title: Peak since type: integer qualifier: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' nullable: true title: Qualifier type: string time: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at\ \ start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is\ \ the decision of the server whether only a single temporal property is used to determine the extent or all\ \ relevant temporal properties.\n" nullable: true title: Time type: string time_of_day: description: 'The time of day a peak occurred. If null, the time of day a peak occurred is unknown. ' format: time nullable: true title: Time of Day type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string value: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' nullable: true title: Value type: string water_year: description: 'The water year (running from October 1st to September 30th) a peak occurred. ' nullable: true title: Water Year type: integer year: description: 'The calendar year a peak occurred. ' nullable: true title: Year type: integer type: object type: enum: - Feature type: string required: - type - properties type: object PeaksFeatureCollection: properties: features: items: $ref: '#/components/schemas/PeaksFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object ReliabilityCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: nullable: true type: string reliability_description: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object ReliabilityCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/ReliabilityCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object SiteTypesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: An acronym specifying the primary or secondary site type. nullable: true type: string site_type_description: description: Site type description. nullable: true type: string site_type_name: description: A long name for the site type used in retrieved output. nullable: true type: string site_type_primary_flag: description: Identifies which site types are primary. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object SiteTypesFeatureCollection: properties: features: items: $ref: '#/components/schemas/SiteTypesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object StatesFeature: properties: geometry: nullable: true id: type: string properties: properties: country_code: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' nullable: true type: string id: nullable: true type: string state_fips_code: description: State FIPS code. nullable: true type: string state_name: description: State name. nullable: true type: string state_postal_code: description: State postal abbreviation. A two-letter USPS state postal abbreviation. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object StatesFeatureCollection: properties: features: items: $ref: '#/components/schemas/StatesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object StatisticCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: Statistic code. nullable: true type: string statistic_description: description: Statistic description. nullable: true type: string statistic_name: description: Statistic name. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object StatisticCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/StatisticCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object TimeSeriesMetadataFeature: properties: geometry: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/geometryGeoJSON id: type: string properties: properties: begin: description: 'This field contains the same information as "begin_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' nullable: true title: Time series first observation timestamp - local time type: string begin_utc: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field\ \ represents the period of record of a time series. Note that some time series may have large gaps in their\ \ collection record.\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using\ \ ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\ \n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `begin_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series first observation timestamp - UTC type: string computation_identifier: description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. nullable: true title: Computation identifier type: string computation_period_identifier: description: Indicates the period of data used for any statistical computations. nullable: true title: Computation period identifier type: string data_gap_interval: description: 'The time interval threshold used for gap detection in the time series. ' format: duration nullable: true title: Data gap interval type: string end: description: 'This field contains the same information as "end_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' nullable: true title: Time series most recent observation timestamp - local time type: string end_utc: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint\ \ updates at most once per day, and potentially less frequently than that, and as such there may be more recent\ \ observations within a time series than the time series `end_utc` value reflects. Together with `begin_utc`,\ \ this field represents the period of record of a time series. It is additionally used to determine whether\ \ a time series is \"active\".\nYou can query this field using date-times or intervals, adhering to RFC 3339,\ \ or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\n\ Examples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `end_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series most recent observation timestamp - UTC type: string hydrologic_unit_code: description: 'The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with a shorter HUC (e.g. "04") matches all locations within that hydrologic region. ' nullable: true title: Hydrologic unit code (HUC) type: string id: description: A unique identifier representing a single time series. This corresponds to the "time_series_id" field in other endpoints. nullable: true title: Time series ID type: string last_modified: description: "The last time a record was refreshed in our database. This may happen due to regular operational\ \ processes and does not necessarily indicate anything about the measurement has changed.\nYou can query this\ \ field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals\ \ may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\"\ \ for the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime\ \ are selected.\n" nullable: true title: Last modified date type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string parameter_code: description: 'Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure. A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items). ' nullable: true title: Parameter code type: string parameter_description: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' nullable: true title: Parameter description type: string parameter_name: description: A human-understandable name corresponding to `parameter_code`. nullable: true title: Parameter name type: string parent_time_series_id: description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' nullable: true title: Parent time series ID type: string primary: description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' nullable: true title: Primary flag type: string state_name: description: 'The name of the state or state equivalent in which the monitoring location is located. ' nullable: true title: State name type: string statistic_id: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' nullable: true title: Statistic ID type: string sublocation_identifier: description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' nullable: true title: Sublocation identifier type: string thresholds: description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' nullable: true title: Operational thresholds type: string unit_of_measure: description: A human-readable description of the units of measurement associated with an observation. nullable: true title: Unit of measure type: string web_description: description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' nullable: true title: Time series description type: string type: object type: enum: - Feature type: string required: - type - properties type: object TimeSeriesMetadataFeatureCollection: properties: features: items: $ref: '#/components/schemas/TimeSeriesMetadataFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object TimeSeriesRevisionsFeature: properties: geometry: nullable: true id: type: string properties: properties: begin: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field\ \ represents the period of record of a time series. Note that some time series may have large gaps in their\ \ collection record.\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using\ \ ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\ \n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `begin_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series first observation timestamp - UTC type: string end: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint\ \ updates at most once per day, and potentially less frequently than that, and as such there may be more recent\ \ observations within a time series than the time series `end_utc` value reflects. Together with `begin_utc`,\ \ this field represents the period of record of a time series. It is additionally used to determine whether\ \ a time series is \"active\".\nYou can query this field using date-times or intervals, adhering to RFC 3339,\ \ or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start or end).\n\ Examples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `end_utc`\ \ that intersects the value of datetime are selected.\n" nullable: true title: Time series most recent observation timestamp - UTC type: string id: description: A unique identifier for a single revision record. nullable: true title: Revision ID type: string monitoring_location_id: description: 'A unique identifier representing a single monitoring location. This corresponds to the `id` field in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500). ' nullable: true title: Monitoring location ID type: string revision_note: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' nullable: true title: Revision note type: string time_series_id: description: 'A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata` endpoint. ' nullable: true title: Time series ID type: string type: object type: enum: - Feature type: string required: - type - properties type: object TimeSeriesRevisionsFeatureCollection: properties: features: items: $ref: '#/components/schemas/TimeSeriesRevisionsFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberMatched: minimum: 0 type: integer numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object TimeZoneCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: id: description: Time zone code. An NWIS time zone code. nullable: true type: string time_zone_daylight_savings_time_code: description: Time zone Daylight Saving Time code. nullable: true type: string time_zone_daylight_savings_time_name: description: Time zone Daylight Saving Time name. nullable: true type: string time_zone_daylight_savings_utc_offset: description: Daylight Saving Time offset time. The number of hours offset from UTC time when Daylight Saving Time is in effect, in ISO format. nullable: true type: string time_zone_description: description: Time zone description. nullable: true type: string time_zone_name: description: Time zone name. An English name for a world time zone. nullable: true type: string time_zone_utc_offset: description: Coordinated Universal Time (UTC) offset time. The number of hours offset from UTC time, in ISO format. nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object TimeZoneCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/TimeZoneCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object TopographicCodesFeature: properties: geometry: nullable: true id: type: string properties: properties: full_topography_description: nullable: true type: string id: nullable: true type: string short_topography_description: nullable: true type: string topography_name: nullable: true type: string type: object type: enum: - Feature type: string required: - type - properties type: object TopographicCodesFeatureCollection: properties: features: items: $ref: '#/components/schemas/TopographicCodesFeature' type: array links: items: $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/schemas/link type: array numberReturned: minimum: 0 type: integer timeStamp: format: date-time type: string type: enum: - FeatureCollection type: string required: - type - features type: object queryable: properties: description: description: a human-readable narrative describing the queryable type: string language: default: en description: the language used for the title and description type: string queryable: description: the token that may be used in a CQL predicate type: string title: description: a human readable title for the queryable type: string type: description: the data type of the queryable type: string type-ref: description: a reference to the formal definition of the type format: url type: string required: - queryable - type type: object queryables: properties: queryables: items: $ref: '#/components/schemas/queryable' type: array required: - queryables type: object tilematrixsetlink: properties: tileMatrixSet: type: string tileMatrixSetURI: type: string required: - tileMatrixSet type: object tiles: properties: links: items: $ref: https://schemas.opengis.net/ogcapi/tiles/part1/1.0/openapi/ogcapi-tiles-1.yaml#/components/schemas/link type: array tileMatrixSetLinks: items: $ref: '#/components/schemas/tilematrixsetlink' type: array required: - tileMatrixSetLinks - links type: object securitySchemes: ApiKeyHeader: description: Providing your API key gives you higher rate limits when querying our APIs. You can obtain an API key at https://api.waterdata.usgs.gov/signup in: header name: api_key type: apiKey ApiKeyQuery: description: Providing your API key gives you higher rate limits when querying our APIs. You can obtain an API key at https://api.waterdata.usgs.gov/signup in: query name: api_key type: apiKey info: contact: name: US Geological Survey - Water Data for the Nation url: https://waterdata.usgs.gov x-ogc-serviceContact: addresses: [] emails: - value: wdfn@usgs.gov hoursOfService: pointOfContact links: - href: https://waterdata.usgs.gov/questions-comments/?referrerUrl=https://api.waterdata.usgs.gov type: text/html name: WDFN Support description: 'The United States Geological Survey (USGS) collects water data at monitoring locations across the United States using both automated sensors and manual data collection. These APIs provide access to that data, alongside metadata about data collections and monitoring locations, in standardized machine-readable formats. ' license: name: US Government work in the public domain url: https://creativecommons.org/publicdomain/zero/1.0/ termsOfService: https://creativecommons.org/publicdomain/zero/1.0/ title: USGS Water Data APIs version: 0.71.7 x-keywords: - geospatial - data - api - hydrology - USGS openapi: 3.0.2 paths: /: get: description: Landing page operationId: getLandingPage parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/LandingPage '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Landing page tags: - server /collections: get: description: Collections operationId: getCollections parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/LandingPage '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Collections tags: - server /collections/agency-codes: get: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: describeAgency-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Agency codes metadata tags: - agency-codes /collections/agency-codes/items: get: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: getAgency-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - agency_name type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Agency code identification number. explode: false in: query name: id required: false schema: description: Agency code identification number. type: string style: form - description: Agency name. explode: false in: query name: agency_name required: false schema: description: Agency name. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/AgencyCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Agency codes items tags: - agency-codes options: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: optionsAgency-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Agency codes items tags: - agency-codes post: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: getCQL2Agency-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/AgencyCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Agency codes items with CQL2 tags: - agency-codes /collections/agency-codes/items/{featureId}: get: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: getAgency-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/AgencyCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Agency codes item by id tags: - agency-codes options: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: optionsAgency-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Agency codes item by id tags: - agency-codes /collections/agency-codes/queryables: get: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: getAgency-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - agency_name type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Agency codes queryables tags: - agency-codes /collections/agency-codes/schema: get: description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' operationId: getAgency-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Agency codes schema tags: - agency-codes /collections/altitude-datums: get: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: describeAltitude-datumsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Altitude datums metadata tags: - altitude-datums /collections/altitude-datums/items: get: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: getAltitude-datumsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - altitude_datum_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: altitude_datum_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/AltitudeDatumsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Altitude datums items tags: - altitude-datums options: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: optionsAltitude-datumsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Altitude datums items tags: - altitude-datums post: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: getCQL2Altitude-datumsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/AltitudeDatumsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Altitude datums items with CQL2 tags: - altitude-datums /collections/altitude-datums/items/{featureId}: get: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: getAltitude-datumsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/AltitudeDatumsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Altitude datums item by id tags: - altitude-datums options: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: optionsAltitude-datumsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Altitude datums item by id tags: - altitude-datums /collections/altitude-datums/queryables: get: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: getAltitude-datumsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - altitude_datum_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Altitude datums queryables tags: - altitude-datums /collections/altitude-datums/schema: get: description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' operationId: getAltitude-datumsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Altitude datums schema tags: - altitude-datums /collections/aquifer-codes: get: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: describeAquifer-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Aquifer codes metadata tags: - aquifer-codes /collections/aquifer-codes/items: get: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: getAquifer-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - aquifer_name type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Aquifer code. The eight-character string identifying an aquifer. Codes are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" explode: false in: query name: id required: false schema: description: Aquifer code. The eight-character string identifying an aquifer. Codes are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" type: string style: form - description: Aquifer name. Aquifer names are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" explode: false in: query name: aquifer_name required: false schema: description: Aquifer name. Aquifer names are defined by the \"Catalog of Aquifer Names and Geologic Unit Codes used by the Water Resources Division.\" type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/AquiferCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer codes items tags: - aquifer-codes options: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: optionsAquifer-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Aquifer codes items tags: - aquifer-codes post: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: getCQL2Aquifer-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/AquiferCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer codes items with CQL2 tags: - aquifer-codes /collections/aquifer-codes/items/{featureId}: get: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: getAquifer-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/AquiferCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer codes item by id tags: - aquifer-codes options: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: optionsAquifer-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Aquifer codes item by id tags: - aquifer-codes /collections/aquifer-codes/queryables: get: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: getAquifer-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - aquifer_name type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer codes queryables tags: - aquifer-codes /collections/aquifer-codes/schema: get: description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' operationId: getAquifer-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer codes schema tags: - aquifer-codes /collections/aquifer-types: get: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: describeAquifer-typesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Aquifer types metadata tags: - aquifer-types /collections/aquifer-types/items: get: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: getAquifer-typesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - aquifer_type_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: The single-character code identifying the type of aquifer explode: false in: query name: id required: false schema: description: The single-character code identifying the type of aquifer type: string style: form - description: Longer description of the aquifer type. explode: false in: query name: aquifer_type_description required: false schema: description: Longer description of the aquifer type. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/AquiferTypesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer types items tags: - aquifer-types options: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: optionsAquifer-typesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Aquifer types items tags: - aquifer-types post: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: getCQL2Aquifer-typesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/AquiferTypesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer types items with CQL2 tags: - aquifer-types /collections/aquifer-types/items/{featureId}: get: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: getAquifer-typesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/AquiferTypesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer types item by id tags: - aquifer-types options: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: optionsAquifer-typesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Aquifer types item by id tags: - aquifer-types /collections/aquifer-types/queryables: get: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: getAquifer-typesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - aquifer_type_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer types queryables tags: - aquifer-types /collections/aquifer-types/schema: get: description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' operationId: getAquifer-typesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Aquifer types schema tags: - aquifer-types /collections/channel-measurements: get: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: describeChannel-measurementsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Channel measurements metadata tags: - channel-measurements /collections/channel-measurements/items: get: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: getChannel-measurementsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - monitoring_location_id - field_visit_id - measurement_number - time - channel_name - channel_flow - channel_flow_unit - channel_width - channel_width_unit - channel_area - channel_area_unit - channel_velocity - channel_velocity_unit - channel_location_distance - channel_location_distance_unit - channel_stability - channel_material - channel_evenness - horizontal_velocity_description - vertical_velocity_description - longitudinal_velocity_description - measurement_type - last_modified - channel_measurement_type - channel_location_direction type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: 'A universally unique identifier (UUID) representing a single version of a record. It is not stable over time. Every time the record is refreshed in our database (which may happen as part of normal operations and does not imply any change to the data itself) a new ID will be generated. To uniquely identify a single observation over time, compare the `time` and `time_series_id` fields; each time series will only have a single observation at a given `time`. ' explode: false in: query name: id required: false schema: description: 'A universally unique identifier (UUID) representing a single version of a record. It is not stable over time. Every time the record is refreshed in our database (which may happen as part of normal operations and does not imply any change to the data itself) a new ID will be generated. To uniquely identify a single observation over time, compare the `time` and `time_series_id` fields; each time series will only have a single observation at a given `time`. ' format: uuid title: Record identifier type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during\ \ a single field visit.\n Split parameters are enabled for this field, so you can supply multiple values separated\ \ by commas." explode: false in: query name: field_visit_id required: false schema: description: "A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during\ \ a single field visit.\n Split parameters are enabled for this field, so you can supply multiple values separated\ \ by commas." format: uuid title: Field visit ID type: string style: form - description: Measurement number. explode: false in: query name: measurement_number required: false schema: description: Measurement number. title: Measurement number type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: The channel name. explode: false in: query name: channel_name required: false schema: description: The channel name. title: Channel name type: string style: form - description: Channel discharge. explode: false in: query name: channel_flow required: false schema: description: Channel discharge. title: Channel flow type: string style: form - description: The units for channel discharge. explode: false in: query name: channel_flow_unit required: false schema: description: The units for channel discharge. title: Channel flow unit type: string style: form - description: The channel width. explode: false in: query name: channel_width required: false schema: description: The channel width. title: Channel width type: string style: form - description: The units for channel width. explode: false in: query name: channel_width_unit required: false schema: description: The units for channel width. title: Channel width unit type: string style: form - description: The channel area. explode: false in: query name: channel_area required: false schema: description: The channel area. title: Channel area type: string style: form - description: The units for channel area. explode: false in: query name: channel_area_unit required: false schema: description: The units for channel area. title: Channel area unit type: string style: form - description: The mean channel velocity. explode: false in: query name: channel_velocity required: false schema: description: The mean channel velocity. title: Channel velocity type: string style: form - description: The units for channel velocity. explode: false in: query name: channel_velocity_unit required: false schema: description: The units for channel velocity. title: Channel velocity unit type: string style: form - description: The channel location distance. explode: false in: query name: channel_location_distance required: false schema: description: The channel location distance. title: Channel location distance type: string style: form - description: The units for channel location distance. explode: false in: query name: channel_location_distance_unit required: false schema: description: The units for channel location distance. title: Channel location distance unit type: string style: form - description: The stability of the channel material. explode: false in: query name: channel_stability required: false schema: description: The stability of the channel material. title: Channel stability type: string style: form - description: The channel material. explode: false in: query name: channel_material required: false schema: description: The channel material. title: Channel material type: string style: form - description: The channel evenness from bank to bank. explode: false in: query name: channel_evenness required: false schema: description: The channel evenness from bank to bank. title: Channel evenness type: string style: form - description: The horizontal velocity description. explode: false in: query name: horizontal_velocity_description required: false schema: description: The horizontal velocity description. title: Horizontal velocity description type: string style: form - description: The vertical velocity description. explode: false in: query name: vertical_velocity_description required: false schema: description: The vertical velocity description. title: Vertical velocity description type: string style: form - description: The longitudinal velocity description. explode: false in: query name: longitudinal_velocity_description required: false schema: description: The longitudinal velocity description. title: Longitudinal velocity description type: string style: form - description: The measurement type. explode: false in: query name: measurement_type required: false schema: description: The measurement type. title: Measurement type type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: The channel measurement type. explode: false in: query name: channel_measurement_type required: false schema: description: The channel measurement type. title: Channel measurement type type: string style: form - description: Location of the measurement from the gage. explode: false in: query name: channel_location_direction required: false schema: description: Location of the measurement from the gage. title: Channel Location Direction type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/ChannelMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Channel measurements items tags: - channel-measurements options: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: optionsChannel-measurementsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Channel measurements items tags: - channel-measurements post: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: getCQL2Channel-measurementsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/ChannelMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Channel measurements items with CQL2 tags: - channel-measurements /collections/channel-measurements/items/{featureId}: get: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: getChannel-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/ChannelMeasurementsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Channel measurements item by id tags: - channel-measurements options: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: optionsChannel-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Channel measurements item by id tags: - channel-measurements /collections/channel-measurements/queryables: get: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: getChannel-measurementsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - monitoring_location_id - field_visit_id - measurement_number - time - channel_name - channel_flow - channel_flow_unit - channel_width - channel_width_unit - channel_area - channel_area_unit - channel_velocity - channel_velocity_unit - channel_location_distance - channel_location_distance_unit - channel_stability - channel_material - channel_evenness - horizontal_velocity_description - vertical_velocity_description - longitudinal_velocity_description - measurement_type - last_modified - channel_measurement_type - channel_location_direction type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Channel measurements queryables tags: - channel-measurements /collections/channel-measurements/schema: get: description: 'Channel measurements taken as part of streamflow field measurements. ' operationId: getChannel-measurementsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Channel measurements schema tags: - channel-measurements /collections/citations: get: description: 'Citations associated with water measurement methods. ' operationId: describeCitationsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Citations metadata tags: - citations /collections/citations/items: get: description: 'Citations associated with water measurement methods. ' operationId: getCitationsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - citation_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Method citation name. An abbreviated citation that describes the reference. explode: false in: query name: id required: false schema: description: Method citation name. An abbreviated citation that describes the reference. type: string style: form - description: Method citation description. explode: false in: query name: citation_description required: false schema: description: Method citation description. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CitationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Citations items tags: - citations options: description: 'Citations associated with water measurement methods. ' operationId: optionsCitationsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Citations items tags: - citations post: description: 'Citations associated with water measurement methods. ' operationId: getCQL2CitationsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CitationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Citations items with CQL2 tags: - citations /collections/citations/items/{featureId}: get: description: 'Citations associated with water measurement methods. ' operationId: getCitationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CitationsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Citations item by id tags: - citations options: description: 'Citations associated with water measurement methods. ' operationId: optionsCitationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Citations item by id tags: - citations /collections/citations/queryables: get: description: 'Citations associated with water measurement methods. ' operationId: getCitationsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - citation_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Citations queryables tags: - citations /collections/citations/schema: get: description: 'Citations associated with water measurement methods. ' operationId: getCitationsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Citations schema tags: - citations /collections/combined-metadata: get: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: describeCombined-metadataCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Combined metadata metadata tags: - combined-metadata /collections/combined-metadata/items: get: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: getCombined-metadataFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - monitoring_location_id - agency_code - agency_name - monitoring_location_number - monitoring_location_name - district_code - country_code - country_name - state_code - state_name - county_code - county_name - minor_civil_division_code - site_type_code - site_type - hydrologic_unit_code - basin_code - altitude - altitude_accuracy - altitude_method_code - altitude_method_name - vertical_datum - vertical_datum_name - horizontal_positional_accuracy_code - horizontal_positional_accuracy - horizontal_position_method_code - horizontal_position_method_name - original_horizontal_datum - original_horizontal_datum_name - drainage_area - contributing_drainage_area - time_zone_abbreviation - uses_daylight_savings - construction_date - aquifer_code - national_aquifer_code - aquifer_type_code - well_constructed_depth - hole_constructed_depth - depth_source_code - id - unit_of_measure - parameter_name - parameter_code - statistic_id - last_modified - begin - end - data_type - computation_identifier - thresholds - sublocation_identifier - primary - web_description - parameter_description - parent_time_series_id - data_gap_interval - reading_type type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: The ID of the time series or field measurement series (identified by `data_type`) that collection metadata corresponds to. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: id required: false schema: description: The ID of the time series or field measurement series (identified by `data_type`) that collection metadata corresponds to. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Data series ID type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: A human-understandable name corresponding to `parameter_code`. explode: false in: query name: parameter_name required: false schema: description: A human-understandable name corresponding to `parameter_code`. title: Parameter name type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: statistic_id required: false schema: description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Statistic ID type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: begin required: false schema: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" title: Time series first observation timestamp - UTC type: string style: form - description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: end required: false schema: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" title: Time series most recent observation timestamp - UTC type: string style: form - description: The computational period type of data collected at the monitoring location. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: data_type required: false schema: description: The computational period type of data collected at the monitoring location. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Data type type: string style: form - description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: computation_identifier required: false schema: description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Computation identifier type: string style: form - description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' explode: false in: query name: thresholds required: false schema: description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' title: Operational thresholds type: string style: form - description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' explode: false in: query name: sublocation_identifier required: false schema: description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' title: Sublocation identifier type: string style: form - description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' explode: false in: query name: primary required: false schema: description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' title: Primary flag type: string style: form - description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' explode: false in: query name: web_description required: false schema: description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' title: Time series description type: string style: form - description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' explode: false in: query name: parameter_description required: false schema: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' title: Parameter description type: string style: form - description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' explode: false in: query name: parent_time_series_id required: false schema: description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' title: Parent time series ID type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' explode: false in: query name: reading_type required: false schema: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' title: Reading type type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CombinedMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Combined metadata items tags: - combined-metadata options: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: optionsCombined-metadataFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Combined metadata items tags: - combined-metadata post: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: getCQL2Combined-metadataFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CombinedMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Combined metadata items with CQL2 tags: - combined-metadata /collections/combined-metadata/items/{featureId}: get: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: getCombined-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CombinedMetadataFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Combined metadata item by id tags: - combined-metadata options: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: optionsCombined-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Combined metadata item by id tags: - combined-metadata /collections/combined-metadata/queryables: get: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: getCombined-metadataQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - monitoring_location_id - agency_code - agency_name - monitoring_location_number - monitoring_location_name - district_code - country_code - country_name - state_code - state_name - county_code - county_name - minor_civil_division_code - site_type_code - site_type - hydrologic_unit_code - basin_code - altitude - altitude_accuracy - altitude_method_code - altitude_method_name - vertical_datum - vertical_datum_name - horizontal_positional_accuracy_code - horizontal_positional_accuracy - horizontal_position_method_code - horizontal_position_method_name - original_horizontal_datum - original_horizontal_datum_name - drainage_area - contributing_drainage_area - time_zone_abbreviation - uses_daylight_savings - construction_date - aquifer_code - national_aquifer_code - aquifer_type_code - well_constructed_depth - hole_constructed_depth - depth_source_code - id - unit_of_measure - parameter_name - parameter_code - statistic_id - last_modified - begin - end - data_type - computation_identifier - thresholds - sublocation_identifier - primary - web_description - parameter_description - parent_time_series_id - data_gap_interval - reading_type type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Combined metadata queryables tags: - combined-metadata /collections/combined-metadata/schema: get: description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' operationId: getCombined-metadataSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Combined metadata schema tags: - combined-metadata /collections/continuous: get: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: describeContinuousCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Continuous values metadata tags: - continuous /collections/continuous/items: get: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: getContinuousFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' explode: false in: query name: statistic_id required: false schema: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' title: Statistic ID type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/ContinuousFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Continuous values items tags: - continuous options: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: optionsContinuousFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Continuous values items tags: - continuous post: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: getCQL2ContinuousFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/ContinuousFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Continuous values items with CQL2 tags: - continuous /collections/continuous/items/{featureId}: get: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: getContinuousFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/ContinuousFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Continuous values item by id tags: - continuous options: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: optionsContinuousFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Continuous values item by id tags: - continuous /collections/continuous/queryables: get: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: getContinuousQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Continuous values queryables tags: - continuous /collections/continuous/schema: get: description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' operationId: getContinuousSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Continuous values schema tags: - continuous /collections/coordinate-accuracy-codes: get: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: describeCoordinate-accuracy-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Coordinate accuracy codes metadata tags: - coordinate-accuracy-codes /collections/coordinate-accuracy-codes/items: get: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: getCoordinate-accuracy-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_accuracy_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: coordinate_accuracy_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CoordinateAccuracyCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate accuracy codes items tags: - coordinate-accuracy-codes options: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: optionsCoordinate-accuracy-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate accuracy codes items tags: - coordinate-accuracy-codes post: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: getCQL2Coordinate-accuracy-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CoordinateAccuracyCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate accuracy codes items with CQL2 tags: - coordinate-accuracy-codes /collections/coordinate-accuracy-codes/items/{featureId}: get: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: getCoordinate-accuracy-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CoordinateAccuracyCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate accuracy codes item by id tags: - coordinate-accuracy-codes options: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: optionsCoordinate-accuracy-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate accuracy codes item by id tags: - coordinate-accuracy-codes /collections/coordinate-accuracy-codes/queryables: get: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: getCoordinate-accuracy-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_accuracy_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate accuracy codes queryables tags: - coordinate-accuracy-codes /collections/coordinate-accuracy-codes/schema: get: description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' operationId: getCoordinate-accuracy-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate accuracy codes schema tags: - coordinate-accuracy-codes /collections/coordinate-datum-codes: get: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: describeCoordinate-datum-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Coordinate datum codes metadata tags: - coordinate-datum-codes /collections/coordinate-datum-codes/items: get: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: getCoordinate-datum-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_datum_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: coordinate_datum_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CoordinateDatumCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate datum codes items tags: - coordinate-datum-codes options: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: optionsCoordinate-datum-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate datum codes items tags: - coordinate-datum-codes post: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: getCQL2Coordinate-datum-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CoordinateDatumCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate datum codes items with CQL2 tags: - coordinate-datum-codes /collections/coordinate-datum-codes/items/{featureId}: get: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: getCoordinate-datum-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CoordinateDatumCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate datum codes item by id tags: - coordinate-datum-codes options: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: optionsCoordinate-datum-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate datum codes item by id tags: - coordinate-datum-codes /collections/coordinate-datum-codes/queryables: get: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: getCoordinate-datum-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_datum_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate datum codes queryables tags: - coordinate-datum-codes /collections/coordinate-datum-codes/schema: get: description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' operationId: getCoordinate-datum-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate datum codes schema tags: - coordinate-datum-codes /collections/coordinate-method-codes: get: description: 'Methods used to determine latitude-longitude values. ' operationId: describeCoordinate-method-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Coordinate method codes metadata tags: - coordinate-method-codes /collections/coordinate-method-codes/items: get: description: 'Methods used to determine latitude-longitude values. ' operationId: getCoordinate-method-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_method_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: coordinate_method_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CoordinateMethodCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate method codes items tags: - coordinate-method-codes options: description: 'Methods used to determine latitude-longitude values. ' operationId: optionsCoordinate-method-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate method codes items tags: - coordinate-method-codes post: description: 'Methods used to determine latitude-longitude values. ' operationId: getCQL2Coordinate-method-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CoordinateMethodCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate method codes items with CQL2 tags: - coordinate-method-codes /collections/coordinate-method-codes/items/{featureId}: get: description: 'Methods used to determine latitude-longitude values. ' operationId: getCoordinate-method-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CoordinateMethodCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate method codes item by id tags: - coordinate-method-codes options: description: 'Methods used to determine latitude-longitude values. ' operationId: optionsCoordinate-method-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Coordinate method codes item by id tags: - coordinate-method-codes /collections/coordinate-method-codes/queryables: get: description: 'Methods used to determine latitude-longitude values. ' operationId: getCoordinate-method-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - coordinate_method_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate method codes queryables tags: - coordinate-method-codes /collections/coordinate-method-codes/schema: get: description: 'Methods used to determine latitude-longitude values. ' operationId: getCoordinate-method-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Coordinate method codes schema tags: - coordinate-method-codes /collections/counties: get: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: describeCountiesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get County identifiers metadata tags: - counties /collections/counties/items: get: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: getCountiesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_code - state_fips_code - county_fips_code - county_name type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' explode: false in: query name: country_code required: false schema: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' type: string style: form - description: State FIPS code. explode: false in: query name: state_fips_code required: false schema: description: State FIPS code. type: string style: form - description: County FIPS code. A two digit code indicating a U.S. county as defined by FIPS 5-2. explode: false in: query name: county_fips_code required: false schema: description: County FIPS code. A two digit code indicating a U.S. county as defined by FIPS 5-2. type: string style: form - description: County name. The name of a U.S. county as defined by FIPS 5-2. explode: false in: query name: county_name required: false schema: description: County name. The name of a U.S. county as defined by FIPS 5-2. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CountiesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get County identifiers items tags: - counties options: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: optionsCountiesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for County identifiers items tags: - counties post: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: getCQL2CountiesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CountiesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get County identifiers items with CQL2 tags: - counties /collections/counties/items/{featureId}: get: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: getCountiesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CountiesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get County identifiers item by id tags: - counties options: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: optionsCountiesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for County identifiers item by id tags: - counties /collections/counties/queryables: get: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: getCountiesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_code - state_fips_code - county_fips_code - county_name type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get County identifiers queryables tags: - counties /collections/counties/schema: get: description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' operationId: getCountiesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get County identifiers schema tags: - counties /collections/countries: get: description: 'FIPS country codes and names. ' operationId: describeCountriesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Country identifiers metadata tags: - countries /collections/countries/items: get: description: 'FIPS country codes and names. ' operationId: getCountriesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_name type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' explode: false in: query name: id required: false schema: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' type: string style: form - description: Country name. explode: false in: query name: country_name required: false schema: description: Country name. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/CountriesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Country identifiers items tags: - countries options: description: 'FIPS country codes and names. ' operationId: optionsCountriesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Country identifiers items tags: - countries post: description: 'FIPS country codes and names. ' operationId: getCQL2CountriesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/CountriesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Country identifiers items with CQL2 tags: - countries /collections/countries/items/{featureId}: get: description: 'FIPS country codes and names. ' operationId: getCountriesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/CountriesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Country identifiers item by id tags: - countries options: description: 'FIPS country codes and names. ' operationId: optionsCountriesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Country identifiers item by id tags: - countries /collections/countries/queryables: get: description: 'FIPS country codes and names. ' operationId: getCountriesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_name type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Country identifiers queryables tags: - countries /collections/countries/schema: get: description: 'FIPS country codes and names. ' operationId: getCountriesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Country identifiers schema tags: - countries /collections/daily: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: describeDailyCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Daily values metadata tags: - daily /collections/daily/items: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getDailyFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: statistic_id required: false schema: description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Statistic ID type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/DailyFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Daily values items tags: - daily options: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: optionsDailyFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Daily values items tags: - daily post: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getCQL2DailyFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/DailyFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Daily values items with CQL2 tags: - daily /collections/daily/items/{featureId}: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getDailyFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/DailyFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Daily values item by id tags: - daily options: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: optionsDailyFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Daily values item by id tags: - daily /collections/daily/queryables: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getDailyQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Daily values queryables tags: - daily /collections/daily/schema: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getDailySchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Daily values schema tags: - daily /collections/field-measurements: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: describeField-measurementsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Field measurements metadata tags: - field-measurements /collections/field-measurements-metadata: get: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: describeField-measurements-metadataCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Field measurements metadata metadata tags: - field-measurements-metadata /collections/field-measurements-metadata/items: get: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: getField-measurements-metadataFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - reading_type - monitoring_location_id - parameter_code - parameter_name - parameter_description - begin - end - last_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: "A unique identifier representing a single collection series. This corresponds to the `field_measurement_series_id`\ \ field in the `field-measurements` endpoint. Collection series are defined as the set of field measurements at\ \ a given monitoring location for a single parameter code using a single reading type.\n Split parameters are enabled\ \ for this field, so you can supply multiple values separated by commas." explode: false in: query name: id required: false schema: description: "A unique identifier representing a single collection series. This corresponds to the `field_measurement_series_id`\ \ field in the `field-measurements` endpoint. Collection series are defined as the set of field measurements at\ \ a given monitoring location for a single parameter code using a single reading type.\n Split parameters are\ \ enabled for this field, so you can supply multiple values separated by commas." title: Field measurement series ID type: string style: form - description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' explode: false in: query name: reading_type required: false schema: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' title: Reading type type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: A human-understandable name corresponding to `parameter_code`. explode: false in: query name: parameter_name required: false schema: description: A human-understandable name corresponding to `parameter_code`. title: Parameter name type: string style: form - description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' explode: false in: query name: parameter_description required: false schema: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' title: Parameter description type: string style: form - description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: begin required: false schema: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" title: Time series first observation timestamp - UTC type: string style: form - description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: end required: false schema: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" title: Time series most recent observation timestamp - UTC type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/FieldMeasurementsMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements metadata items tags: - field-measurements-metadata options: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: optionsField-measurements-metadataFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Field measurements metadata items tags: - field-measurements-metadata post: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: getCQL2Field-measurements-metadataFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/FieldMeasurementsMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements metadata items with CQL2 tags: - field-measurements-metadata /collections/field-measurements-metadata/items/{featureId}: get: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: getField-measurements-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/FieldMeasurementsMetadataFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements metadata item by id tags: - field-measurements-metadata options: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: optionsField-measurements-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Field measurements metadata item by id tags: - field-measurements-metadata /collections/field-measurements-metadata/queryables: get: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: getField-measurements-metadataQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - reading_type - monitoring_location_id - parameter_code - parameter_name - parameter_description - begin - end - last_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements metadata queryables tags: - field-measurements-metadata /collections/field-measurements-metadata/schema: get: description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' operationId: getField-measurements-metadataSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements metadata schema tags: - field-measurements-metadata /collections/field-measurements/items: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getField-measurementsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - field_measurements_series_id - field_visit_id - parameter_code - monitoring_location_id - observing_procedure_code - observing_procedure - value - unit_of_measure - time - qualifier - vertical_datum - approval_status - measuring_agency - reading_type - last_modified - control_condition - measurement_rated - year - month - day - time_of_day type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' explode: false in: query name: field_measurements_series_id required: false schema: description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' title: Field measurements series ID type: string style: form - description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' explode: false in: query name: reading_type required: false schema: description: 'Distinguishes field-measurement readings from measurements. Readings have a value of ReferencePrimary; measurements are Discharge or MeanGageHeight. ' title: Reading type type: string style: form - description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' explode: false in: query name: field_visit_id required: false schema: description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' format: uuid title: Field visit ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: A short code corresponding to the observing procedure for the field measurement. explode: false in: query name: observing_procedure_code required: false schema: description: A short code corresponding to the observing procedure for the field measurement. title: Observing procedure code type: string style: form - description: Water measurement or water-quality observing procedure descriptions. explode: false in: query name: observing_procedure required: false schema: description: Water measurement or water-quality observing procedure descriptions. title: Observing procedure type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: The agency performing the measurement. explode: false in: query name: measuring_agency required: false schema: description: The agency performing the measurement. title: Measuring agency type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The state of the control feature at the time of observation. ' explode: false in: query name: control_condition required: false schema: description: 'The state of the control feature at the time of observation. ' title: Control condition type: string style: form - description: 'A qualitative estimate of the quality of a measurement. ' explode: false in: query name: measurement_rated required: false schema: description: 'A qualitative estimate of the quality of a measurement. ' title: Measurement rating type: string style: form - description: 'The calendar year the field measurement was taken. ' explode: false in: query name: year required: false schema: description: 'The calendar year the field measurement was taken. ' title: Year type: integer style: form - description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' explode: false in: query name: month required: false schema: description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' title: Month type: integer style: form - description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' explode: false in: query name: day required: false schema: description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' title: Day type: integer style: form - description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' explode: false in: query name: time_of_day required: false schema: description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' format: time title: Time of Day type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The vertical datum used to determine altitude at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_site required: false schema: description: 'The vertical datum used to determine altitude at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum (site) type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/FieldMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements items tags: - field-measurements options: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: optionsField-measurementsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Field measurements items tags: - field-measurements post: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getCQL2Field-measurementsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/FieldMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements items with CQL2 tags: - field-measurements /collections/field-measurements/items/{featureId}: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getField-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/FieldMeasurementsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements item by id tags: - field-measurements options: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: optionsField-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Field measurements item by id tags: - field-measurements /collections/field-measurements/queryables: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getField-measurementsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - field_measurements_series_id - field_visit_id - parameter_code - monitoring_location_id - observing_procedure_code - observing_procedure - value - unit_of_measure - time - qualifier - vertical_datum - approval_status - measuring_agency - reading_type - last_modified - control_condition - measurement_rated - year - month - day - time_of_day type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements queryables tags: - field-measurements /collections/field-measurements/schema: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getField-measurementsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Field measurements schema tags: - field-measurements /collections/hydrologic-unit-codes: get: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: describeHydrologic-unit-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Hydrologic unit codes (HUCs) metadata tags: - hydrologic-unit-codes /collections/hydrologic-unit-codes/items: get: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: getHydrologic-unit-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - hydrologic_unit_name - hydrologic_unit_classification_code type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: 'Hydrologic unit code. The format of the code is (''RRSSBBUUWWXX'') where: ''RR'' is the 2-digit code for the region. ''SS'' is the 2-digit code for the sub-region. ''BB'' is the 2-digit code for the basin. ''UU'' is the 2-digit code for the sub-basin. ''WW'' is the 2-digit code for the watershed. ''XX'' is the 2-digit code for the sub-watershed. Watersheds are delineated by USGS using a nationwide system based on surface hydrologic features. This system divides the country into 22 regions (2-digit), 245 subregions (4-digit), 405 basins (6-digit), ~2,400 subbasins (8-digit), ~19,000 watersheds (10-digit), and ~105,000 subwatersheds (12-digit). A hierarchical hydrologic unit code (HUC) consisting of 2 additional digits for each level in the hydrologic unit system is used to identify any hydrologic area (see Federal Standards and Procedures for the National Watershed Boundary Dataset - https://pubs.usgs.gov/tm/11/a3/).' explode: false in: query name: id required: false schema: description: 'Hydrologic unit code. The format of the code is (''RRSSBBUUWWXX'') where: ''RR'' is the 2-digit code for the region. ''SS'' is the 2-digit code for the sub-region. ''BB'' is the 2-digit code for the basin. ''UU'' is the 2-digit code for the sub-basin. ''WW'' is the 2-digit code for the watershed. ''XX'' is the 2-digit code for the sub-watershed. Watersheds are delineated by USGS using a nationwide system based on surface hydrologic features. This system divides the country into 22 regions (2-digit), 245 subregions (4-digit), 405 basins (6-digit), ~2,400 subbasins (8-digit), ~19,000 watersheds (10-digit), and ~105,000 subwatersheds (12-digit). A hierarchical hydrologic unit code (HUC) consisting of 2 additional digits for each level in the hydrologic unit system is used to identify any hydrologic area (see Federal Standards and Procedures for the National Watershed Boundary Dataset - https://pubs.usgs.gov/tm/11/a3/).' type: string style: form - description: Hydrologic unit name. explode: false in: query name: hydrologic_unit_name required: false schema: description: Hydrologic unit name. type: string style: form - description: Hydrologic unit classification code. explode: false in: query name: hydrologic_unit_classification_code required: false schema: description: Hydrologic unit classification code. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/HydrologicUnitCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Hydrologic unit codes (HUCs) items tags: - hydrologic-unit-codes options: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: optionsHydrologic-unit-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Hydrologic unit codes (HUCs) items tags: - hydrologic-unit-codes post: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: getCQL2Hydrologic-unit-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/HydrologicUnitCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Hydrologic unit codes (HUCs) items with CQL2 tags: - hydrologic-unit-codes /collections/hydrologic-unit-codes/items/{featureId}: get: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: getHydrologic-unit-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/HydrologicUnitCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Hydrologic unit codes (HUCs) item by id tags: - hydrologic-unit-codes options: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: optionsHydrologic-unit-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Hydrologic unit codes (HUCs) item by id tags: - hydrologic-unit-codes /collections/hydrologic-unit-codes/queryables: get: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: getHydrologic-unit-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - hydrologic_unit_name - hydrologic_unit_classification_code type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Hydrologic unit codes (HUCs) queryables tags: - hydrologic-unit-codes /collections/hydrologic-unit-codes/schema: get: description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' operationId: getHydrologic-unit-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Hydrologic unit codes (HUCs) schema tags: - hydrologic-unit-codes /collections/latest-continuous: get: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: describeLatest-continuousCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Latest continuous metadata tags: - latest-continuous /collections/latest-continuous/items: get: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: getLatest-continuousFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' explode: false in: query name: statistic_id required: false schema: description: 'A code corresponding to the statistic an observation represents. Example codes include 00001 (max), 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items). ' title: Statistic ID type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/LatestContinuousFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest continuous items tags: - latest-continuous options: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: optionsLatest-continuousFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest continuous items tags: - latest-continuous post: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: getCQL2Latest-continuousFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/LatestContinuousFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest continuous items with CQL2 tags: - latest-continuous /collections/latest-continuous/items/{featureId}: get: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: getLatest-continuousFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/LatestContinuousFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest continuous item by id tags: - latest-continuous options: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: optionsLatest-continuousFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest continuous item by id tags: - latest-continuous /collections/latest-continuous/queryables: get: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: getLatest-continuousQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest continuous queryables tags: - latest-continuous /collections/latest-continuous/schema: get: description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' operationId: getLatest-continuousSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest continuous schema tags: - latest-continuous /collections/latest-daily: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: describeLatest-dailyCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Latest daily values metadata tags: - latest-daily /collections/latest-daily/items: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getLatest-dailyFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: statistic_id required: false schema: description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Statistic ID type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/LatestDailyFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest daily values items tags: - latest-daily options: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: optionsLatest-dailyFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest daily values items tags: - latest-daily post: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getCQL2Latest-dailyFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/LatestDailyFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest daily values items with CQL2 tags: - latest-daily /collections/latest-daily/items/{featureId}: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getLatest-dailyFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/LatestDailyFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest daily values item by id tags: - latest-daily options: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: optionsLatest-dailyFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest daily values item by id tags: - latest-daily /collections/latest-daily/queryables: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getLatest-dailyQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - statistic_id - time - value - unit_of_measure - approval_status - qualifier - last_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest daily values queryables tags: - latest-daily /collections/latest-daily/schema: get: description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' operationId: getLatest-dailySchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest daily values schema tags: - latest-daily /collections/latest-field-measurements: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: describeLatest-field-measurementsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Latest field measurements metadata tags: - latest-field-measurements /collections/latest-field-measurements/items: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getLatest-field-measurementsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - field_measurements_series_id - field_visit_id - parameter_code - monitoring_location_id - observing_procedure_code - observing_procedure - value - unit_of_measure - time - qualifier - vertical_datum - approval_status - measuring_agency - last_modified - control_condition - measurement_rated - year - month - day - time_of_day type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/datetime - description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' explode: false in: query name: field_measurements_series_id required: false schema: description: 'A unique identifier representing a single collection series. This corresponds to the `id` field in the `field-measurements-metadata` endpoint. Collection series are defined as the set of field measurements at a given monitoring location for a single parameter code using a single reading type. ' title: Field measurements series ID type: string style: form - description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' explode: false in: query name: field_visit_id required: false schema: description: 'A universally unique identifier (UUID) for the field visit. Multiple measurements may be made during a single field visit. ' format: uuid title: Field visit ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: A short code corresponding to the observing procedure for the field measurement. explode: false in: query name: observing_procedure_code required: false schema: description: A short code corresponding to the observing procedure for the field measurement. title: Observing procedure code type: string style: form - description: Water measurement or water-quality observing procedure descriptions. explode: false in: query name: observing_procedure required: false schema: description: Water measurement or water-quality observing procedure descriptions. title: Observing procedure type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' explode: false in: query name: approval_status required: false schema: description: 'Some of the data that you have obtained from this U.S. Geological Survey database may not have received Director''s approval. Any such data values are qualified as provisional and are subject to revision. Provisional data are released on the condition that neither the USGS nor the United States Government may be held liable for any damages resulting from its use. This field reflects the approval status of each record, and is either "Approved", meaining processing review has been completed and the data is approved for publication, or "Provisional" and subject to revision. For more information about provisional data, go to [https://waterdata.usgs.gov/provisional-data-statement/](https://waterdata.usgs.gov/provisional-data-statement/). ' enum: - Provisional - Approved title: Approval Status type: string style: form - description: The agency performing the measurement. explode: false in: query name: measuring_agency required: false schema: description: The agency performing the measurement. title: Measuring agency type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'The state of the control feature at the time of observation. ' explode: false in: query name: control_condition required: false schema: description: 'The state of the control feature at the time of observation. ' title: Control condition type: string style: form - description: 'A qualitative estimate of the quality of a measurement. ' explode: false in: query name: measurement_rated required: false schema: description: 'A qualitative estimate of the quality of a measurement. ' title: Measurement rating type: string style: form - description: 'The calendar year the field measurement was taken. ' explode: false in: query name: year required: false schema: description: 'The calendar year the field measurement was taken. ' title: Year type: integer style: form - description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' explode: false in: query name: month required: false schema: description: 'The calendar month the field measurement was taken. If null, the month is unknown. ' title: Month type: integer style: form - description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' explode: false in: query name: day required: false schema: description: 'The day of the month the field measurement was taken. If null, the day is unknown. ' title: Day type: integer style: form - description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' explode: false in: query name: time_of_day required: false schema: description: 'The time of day the field measurement was taken. If null, the time of day is unknown. ' format: time title: Time of Day type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The vertical datum used to determine altitude at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_site required: false schema: description: 'The vertical datum used to determine altitude at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum (site) type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/LatestFieldMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest field measurements items tags: - latest-field-measurements options: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: optionsLatest-field-measurementsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest field measurements items tags: - latest-field-measurements post: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getCQL2Latest-field-measurementsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/LatestFieldMeasurementsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest field measurements items with CQL2 tags: - latest-field-measurements /collections/latest-field-measurements/items/{featureId}: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getLatest-field-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/LatestFieldMeasurementsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest field measurements item by id tags: - latest-field-measurements options: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: optionsLatest-field-measurementsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Latest field measurements item by id tags: - latest-field-measurements /collections/latest-field-measurements/queryables: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getLatest-field-measurementsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - field_measurements_series_id - field_visit_id - parameter_code - monitoring_location_id - observing_procedure_code - observing_procedure - value - unit_of_measure - time - qualifier - vertical_datum - approval_status - measuring_agency - last_modified - control_condition - measurement_rated - year - month - day - time_of_day type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest field measurements queryables tags: - latest-field-measurements /collections/latest-field-measurements/schema: get: description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' operationId: getLatest-field-measurementsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Latest field measurements schema tags: - latest-field-measurements /collections/medium-codes: get: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: describeMedium-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Medium codes metadata tags: - medium-codes /collections/medium-codes/items: get: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: getMedium-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - medium_name - medium_description - legacy_medium_code type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: The medium code is the 3-character alpha code that identifies the material type and quality-assurance type of the sample. The first character of the code is the \"super\" medium, which describes the primary matrix of the sample. The second character is the sub-medium, which characterizes the sample type as a unique entity within the \"super\" medium category. The third character is used to designate whether a sample is an environmental or QC sample. A blank in position three denotes an environmental sample; a \"Q\" in position three denotes a QC sample. explode: false in: query name: id required: false schema: description: The medium code is the 3-character alpha code that identifies the material type and quality-assurance type of the sample. The first character of the code is the \"super\" medium, which describes the primary matrix of the sample. The second character is the sub-medium, which characterizes the sample type as a unique entity within the \"super\" medium category. The third character is used to designate whether a sample is an environmental or QC sample. A blank in position three denotes an environmental sample; a \"Q\" in position three denotes a QC sample. type: string style: form - description: The medium name is a short identifying appellation that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. explode: false in: query name: medium_name required: false schema: description: The medium name is a short identifying appellation that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. type: string style: form - description: The medium description is a short string of words that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. explode: false in: query name: medium_description required: false schema: description: The medium description is a short string of words that explains the associated medium code. See qwmed for examples of codes, names, and descriptions. type: string style: form - description: Historical 1-char medium code that corresponds to the 3-char code. explode: false in: query name: legacy_medium_code required: false schema: description: Historical 1-char medium code that corresponds to the 3-char code. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/MediumCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Medium codes items tags: - medium-codes options: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: optionsMedium-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Medium codes items tags: - medium-codes post: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: getCQL2Medium-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/MediumCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Medium codes items with CQL2 tags: - medium-codes /collections/medium-codes/items/{featureId}: get: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: getMedium-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/MediumCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Medium codes item by id tags: - medium-codes options: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: optionsMedium-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Medium codes item by id tags: - medium-codes /collections/medium-codes/queryables: get: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: getMedium-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - medium_name - medium_description - legacy_medium_code type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Medium codes queryables tags: - medium-codes /collections/medium-codes/schema: get: description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' operationId: getMedium-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Medium codes schema tags: - medium-codes /collections/method-categories: get: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: describeMethod-categoriesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Method categories metadata tags: - method-categories /collections/method-categories/items: get: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: getMethod-categoriesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_category_name - method_category_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Code representing the method category standard. explode: false in: query name: id required: false schema: description: Code representing the method category standard. type: string style: form - description: Name representing the method category standard. explode: false in: query name: method_category_name required: false schema: description: Name representing the method category standard. type: string style: form - description: Full description of the method category as defined by the USGS Water Mission Area standards for field and analytical methods and their fit-for-purpose use internally and for public delivery explode: false in: query name: method_category_description required: false schema: description: Full description of the method category as defined by the USGS Water Mission Area standards for field and analytical methods and their fit-for-purpose use internally and for public delivery type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/MethodCategoriesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method categories items tags: - method-categories options: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: optionsMethod-categoriesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Method categories items tags: - method-categories post: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: getCQL2Method-categoriesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/MethodCategoriesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method categories items with CQL2 tags: - method-categories /collections/method-categories/items/{featureId}: get: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: getMethod-categoriesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/MethodCategoriesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method categories item by id tags: - method-categories options: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: optionsMethod-categoriesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Method categories item by id tags: - method-categories /collections/method-categories/queryables: get: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: getMethod-categoriesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_category_name - method_category_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method categories queryables tags: - method-categories /collections/method-categories/schema: get: description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' operationId: getMethod-categoriesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method categories schema tags: - method-categories /collections/method-citations: get: description: 'Citation identifiers for water measurement methods. ' operationId: describeMethod-citationsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Method citations metadata tags: - method-citations /collections/method-citations/items: get: description: 'Citation identifiers for water measurement methods. ' operationId: getMethod-citationsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_id - citation_name - citation_method_number - method_source type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Citation method identification number. explode: false in: query name: id required: false schema: description: Citation method identification number. type: integer style: form - description: USGS Central Laboratory method code. The lab method used to determine a parameter value. explode: false in: query name: method_id required: false schema: description: USGS Central Laboratory method code. The lab method used to determine a parameter value. type: string style: form - description: Method citation name. An abbreviated citation that describes the reference. explode: false in: query name: citation_name required: false schema: description: Method citation name. An abbreviated citation that describes the reference. type: string style: form - description: Citation method number. A number assigned to a method within a cited reference. explode: false in: query name: citation_method_number required: false schema: description: Citation method number. A number assigned to a method within a cited reference. type: string style: form - description: Protocol organization code. explode: false in: query name: method_source required: false schema: description: Protocol organization code. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/MethodCitationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method citations items tags: - method-citations options: description: 'Citation identifiers for water measurement methods. ' operationId: optionsMethod-citationsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Method citations items tags: - method-citations post: description: 'Citation identifiers for water measurement methods. ' operationId: getCQL2Method-citationsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/MethodCitationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method citations items with CQL2 tags: - method-citations /collections/method-citations/items/{featureId}: get: description: 'Citation identifiers for water measurement methods. ' operationId: getMethod-citationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/MethodCitationsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method citations item by id tags: - method-citations options: description: 'Citation identifiers for water measurement methods. ' operationId: optionsMethod-citationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Method citations item by id tags: - method-citations /collections/method-citations/queryables: get: description: 'Citation identifiers for water measurement methods. ' operationId: getMethod-citationsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_id - citation_name - citation_method_number - method_source type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method citations queryables tags: - method-citations /collections/method-citations/schema: get: description: 'Citation identifiers for water measurement methods. ' operationId: getMethod-citationsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Method citations schema tags: - method-citations /collections/methods: get: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: describeMethodsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Water measurement methods metadata tags: - methods /collections/methods/items: get: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: getMethodsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_type - method_category - method_name - method_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Water measurement or water-quality analytical method code. The method used to determine a parameter value. explode: false in: query name: id required: false schema: description: Water measurement or water-quality analytical method code. The method used to determine a parameter value. type: string style: form - description: Method type for measured or collected data explode: false in: query name: method_type required: false schema: description: Method type for measured or collected data type: string style: form - description: Code representing the method category standard. explode: false in: query name: method_category required: false schema: description: Code representing the method category standard. type: string style: form - description: A short name that partially describes a method. explode: false in: query name: method_name required: false schema: description: A short name that partially describes a method. type: string style: form - description: A long name that fully describes a method. explode: false in: query name: method_description required: false schema: description: A long name that fully describes a method. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/MethodsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Water measurement methods items tags: - methods options: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: optionsMethodsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Water measurement methods items tags: - methods post: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: getCQL2MethodsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/MethodsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Water measurement methods items with CQL2 tags: - methods /collections/methods/items/{featureId}: get: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: getMethodsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/MethodsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Water measurement methods item by id tags: - methods options: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: optionsMethodsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Water measurement methods item by id tags: - methods /collections/methods/queryables: get: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: getMethodsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - method_type - method_category - method_name - method_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Water measurement methods queryables tags: - methods /collections/methods/schema: get: description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' operationId: getMethodsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Water measurement methods schema tags: - methods /collections/monitoring-locations: get: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: describeMonitoring-locationsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Monitoring locations metadata tags: - monitoring-locations /collections/monitoring-locations/items: get: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: getMonitoring-locationsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - agency_code - agency_name - monitoring_location_number - monitoring_location_name - district_code - country_code - country_name - state_code - state_name - county_code - county_name - minor_civil_division_code - site_type_code - site_type - hydrologic_unit_code - basin_code - altitude - altitude_accuracy - altitude_method_code - altitude_method_name - vertical_datum - vertical_datum_name - horizontal_positional_accuracy_code - horizontal_positional_accuracy - horizontal_position_method_code - horizontal_position_method_name - original_horizontal_datum - original_horizontal_datum_name - drainage_area - contributing_drainage_area - time_zone_abbreviation - uses_daylight_savings - construction_date - aquifer_code - national_aquifer_code - aquifer_type_code - well_constructed_depth - hole_constructed_depth - depth_source_code - revision_note - revision_created - revision_modified type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: "A unique identifier representing a single monitoring location. This corresponds to the `monitoring_location_id`\ \ field in other endpoints. Monitoring location IDs are created by combining the agency code of the agency responsible\ \ for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated\ \ by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple values\ \ separated by commas." explode: false in: query name: id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `monitoring_location_id`\ \ field in other endpoints. Monitoring location IDs are created by combining the agency code of the agency responsible\ \ for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500), separated\ \ by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." title: Monitoring location ID type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' explode: false in: query name: revision_note required: false schema: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' title: Revision note type: string style: form - description: 'The date a revision statement was created. ' explode: false in: query name: revision_created required: false schema: description: 'The date a revision statement was created. ' title: Date revision created type: string style: form - description: 'The most recent date a revision statement was modified. ' explode: false in: query name: revision_modified required: false schema: description: 'The most recent date a revision statement was modified. ' title: Date revision modified type: string style: form - $ref: '#/components/parameters/filter' - $ref: '#/components/parameters/q' responses: '200': $ref: '#/components/responses/MonitoringLocationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Monitoring locations items tags: - monitoring-locations options: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: optionsMonitoring-locationsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Monitoring locations items tags: - monitoring-locations post: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: getCQL2Monitoring-locationsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/MonitoringLocationsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Monitoring locations items with CQL2 tags: - monitoring-locations /collections/monitoring-locations/items/{featureId}: get: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: getMonitoring-locationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/MonitoringLocationsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Monitoring locations item by id tags: - monitoring-locations options: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: optionsMonitoring-locationsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Monitoring locations item by id tags: - monitoring-locations /collections/monitoring-locations/queryables: get: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: getMonitoring-locationsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - agency_code - agency_name - monitoring_location_number - monitoring_location_name - district_code - country_code - country_name - state_code - state_name - county_code - county_name - minor_civil_division_code - site_type_code - site_type - hydrologic_unit_code - basin_code - altitude - altitude_accuracy - altitude_method_code - altitude_method_name - vertical_datum - vertical_datum_name - horizontal_positional_accuracy_code - horizontal_positional_accuracy - horizontal_position_method_code - horizontal_position_method_name - original_horizontal_datum - original_horizontal_datum_name - drainage_area - contributing_drainage_area - time_zone_abbreviation - uses_daylight_savings - construction_date - aquifer_code - national_aquifer_code - aquifer_type_code - well_constructed_depth - hole_constructed_depth - depth_source_code - revision_note - revision_created - revision_modified type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Monitoring locations queryables tags: - monitoring-locations /collections/monitoring-locations/schema: get: description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' operationId: getMonitoring-locationsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Monitoring locations schema tags: - monitoring-locations /collections/national-aquifer-codes: get: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: describeNational-aquifer-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get National aquifer codes metadata tags: - national-aquifer-codes /collections/national-aquifer-codes/items: get: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: getNational-aquifer-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - national_aquifer_name type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: National aquifer code. explode: false in: query name: id required: false schema: description: National aquifer code. type: string style: form - description: National aquifer name. explode: false in: query name: national_aquifer_name required: false schema: description: National aquifer name. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/NationalAquiferCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get National aquifer codes items tags: - national-aquifer-codes options: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: optionsNational-aquifer-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for National aquifer codes items tags: - national-aquifer-codes post: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: getCQL2National-aquifer-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/NationalAquiferCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get National aquifer codes items with CQL2 tags: - national-aquifer-codes /collections/national-aquifer-codes/items/{featureId}: get: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: getNational-aquifer-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/NationalAquiferCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get National aquifer codes item by id tags: - national-aquifer-codes options: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: optionsNational-aquifer-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for National aquifer codes item by id tags: - national-aquifer-codes /collections/national-aquifer-codes/queryables: get: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: getNational-aquifer-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - national_aquifer_name type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get National aquifer codes queryables tags: - national-aquifer-codes /collections/national-aquifer-codes/schema: get: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' operationId: getNational-aquifer-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get National aquifer codes schema tags: - national-aquifer-codes /collections/parameter-codes: get: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: describeParameter-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Parameter codes metadata tags: - parameter-codes /collections/parameter-codes/items: get: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: getParameter-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - parameter_name - unit_of_measure - parameter_group_code - parameter_description - medium - statistical_basis - time_basis - weight_basis - particle_size_basis - sample_fraction - temperature_basis - epa_equivalence type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Parameter code. explode: false in: query name: id required: false schema: description: Parameter code. type: string style: form - description: Parameter short name. explode: false in: query name: parameter_name required: false schema: description: Parameter short name. type: string style: form - description: Parameter reporting units defined to cooperate with descriptions by USEPA. explode: false in: query name: unit_of_measure required: false schema: description: Parameter reporting units defined to cooperate with descriptions by USEPA. type: string style: form - description: Categorical groupings of parameters by water-quality data type for display and report ordering explode: false in: query name: parameter_group_code required: false schema: description: Categorical groupings of parameters by water-quality data type for display and report ordering type: string style: form - description: Parameter description. explode: false in: query name: parameter_description required: false schema: description: Parameter description. type: string style: form - description: Parameter medium. explode: false in: query name: medium required: false schema: description: Parameter medium. type: string style: form - description: Parameter statistical basis. explode: false in: query name: statistical_basis required: false schema: description: Parameter statistical basis. type: string style: form - description: Parameter time basis. explode: false in: query name: time_basis required: false schema: description: Parameter time basis. type: string style: form - description: Parameter weight basis. explode: false in: query name: weight_basis required: false schema: description: Parameter weight basis. type: string style: form - description: Parameter particle-size basis. explode: false in: query name: particle_size_basis required: false schema: description: Parameter particle-size basis. type: string style: form - description: Parameter fraction. explode: false in: query name: sample_fraction required: false schema: description: Parameter fraction. type: string style: form - description: Parameter temperature basis. explode: false in: query name: temperature_basis required: false schema: description: Parameter temperature basis. type: string style: form - description: Indicates the relationship of the USGS parameter code to the EPA code. explode: false in: query name: epa_equivalence required: false schema: description: Indicates the relationship of the USGS parameter code to the EPA code. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/ParameterCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Parameter codes items tags: - parameter-codes options: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: optionsParameter-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Parameter codes items tags: - parameter-codes post: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: getCQL2Parameter-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/ParameterCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Parameter codes items with CQL2 tags: - parameter-codes /collections/parameter-codes/items/{featureId}: get: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: getParameter-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/ParameterCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Parameter codes item by id tags: - parameter-codes options: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: optionsParameter-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Parameter codes item by id tags: - parameter-codes /collections/parameter-codes/queryables: get: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: getParameter-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - parameter_name - unit_of_measure - parameter_group_code - parameter_description - medium - statistical_basis - time_basis - weight_basis - particle_size_basis - sample_fraction - temperature_basis - epa_equivalence type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Parameter codes queryables tags: - parameter-codes /collections/parameter-codes/schema: get: description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' operationId: getParameter-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Parameter codes schema tags: - parameter-codes /collections/peaks: get: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: describePeaksCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Peaks metadata tags: - peaks /collections/peaks/items: get: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: getPeaksFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - unit_of_measure - value - last_modified - time - water_year - year - month - day - time_of_day - peak_since - qualifier type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' explode: false in: query name: value required: false schema: description: 'The value of the observation. Values are transmitted as strings in the JSON response format in order to preserve precision. ' title: Value type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time` that\ \ intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the decision\ \ of the server whether only a single temporal property is used to determine the extent or all relevant temporal\ \ properties.\n" explode: false in: query name: time required: false schema: description: "The date an observation represents. You can query this field using date-times or intervals, adhering\ \ to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or half-bounded (double-dots at start\ \ or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\ \n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n - Duration objects:\ \ \"P1M\" for data from the past month or \"PT36H\" for the last 36 hours\n\nOnly features that have a `time`\ \ that intersects the value of datetime are selected. If a feature has multiple temporal properties, it is the\ \ decision of the server whether only a single temporal property is used to determine the extent or all relevant\ \ temporal properties.\n" title: Time type: string style: form - description: "The water year (running from October 1st to September 30th) a peak occurred.\n Split parameters are\ \ enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: water_year required: false schema: description: "The water year (running from October 1st to September 30th) a peak occurred.\n Split parameters are\ \ enabled for this field, so you can supply multiple values separated by commas." title: Water Year type: integer style: form - description: "The calendar year a peak occurred.\n Split parameters are enabled for this field, so you can supply\ \ multiple values separated by commas." explode: false in: query name: year required: false schema: description: "The calendar year a peak occurred.\n Split parameters are enabled for this field, so you can supply\ \ multiple values separated by commas." title: Year type: integer style: form - description: "The calendar month a peak occurred. If null, the month a peak occurred is unknown.\n Split parameters\ \ are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: month required: false schema: description: "The calendar month a peak occurred. If null, the month a peak occurred is unknown.\n Split parameters\ \ are enabled for this field, so you can supply multiple values separated by commas." title: Month type: integer style: form - description: "The day of the month a peak occurred. If null, the day a peak occurred is unknown.\n Split parameters\ \ are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: day required: false schema: description: "The day of the month a peak occurred. If null, the day a peak occurred is unknown.\n Split parameters\ \ are enabled for this field, so you can supply multiple values separated by commas." title: Day type: integer style: form - description: 'The time of day a peak occurred. If null, the time of day a peak occurred is unknown. ' explode: false in: query name: time_of_day required: false schema: description: 'The time of day a peak occurred. If null, the time of day a peak occurred is unknown. ' format: time title: Time of Day type: string style: form - description: "If not null, this record represents the peak value for the parameter code since the year contained in\ \ \"peak_since\".\n Split parameters are enabled for this field, so you can supply multiple values separated by\ \ commas." explode: false in: query name: peak_since required: false schema: description: "If not null, this record represents the peak value for the parameter code since the year contained\ \ in \"peak_since\".\n Split parameters are enabled for this field, so you can supply multiple values separated\ \ by commas." title: Peak since type: integer style: form - description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' explode: false in: query name: qualifier required: false schema: description: 'This field indicates any qualifiers associated with an observation, for instance if a sensor may have been impacted by ice or if values were estimated. ' title: Qualifier type: string style: form - description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' explode: false in: query name: agency_code required: false schema: description: 'The agency that is reporting the data. Agency codes are fixed values assigned by the National Water Information System (NWIS). A list of agency codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/agency-codes/items). ' title: Agency code type: string style: form - description: 'The name of the agency that is reporting the data. ' explode: false in: query name: agency_name required: false schema: description: 'The name of the agency that is reporting the data. ' title: Agency name type: string style: form - description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' explode: false in: query name: altitude required: false schema: description: 'Altitude of the monitoring location referenced to the specified Vertical Datum. ' title: Altitude type: number style: form - description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' explode: false in: query name: altitude_accuracy required: false schema: description: 'Accuracy of the altitude, in feet. An accuracy of +/- 0.1 foot would be entered as “.1”. Many altitudes are interpolated from the contours on topographic maps; accuracies determined in this way are generally entered as one-half of the contour interval. ' title: Altitude accuracy type: number style: form - description: 'Codes representing the method used to measure altitude. ' explode: false in: query name: altitude_method_code required: false schema: description: 'Codes representing the method used to measure altitude. ' title: Altitude method code type: string style: form - description: 'The name of the method used to measure altitude. ' explode: false in: query name: altitude_method_name required: false schema: description: 'The name of the method used to measure altitude. ' title: Altitude method name type: string style: form - description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' explode: false in: query name: aquifer_code required: false schema: description: 'Local aquifers in the USGS water resources data base are identified by a geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). ' title: Aquifer code type: string style: form - description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' explode: false in: query name: aquifer_type_code required: false schema: description: 'Describes the confinement status of an aquifer at the monitoring location. A confined aquifer is an aquifer below the land surface that is saturated with water. A water table--or unconfined--aquifer is an aquifer whose upper water surface (water table) is at atmospheric pressure, and thus is able to rise and fall. ' title: Aquifer type code type: string style: form - description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' explode: false in: query name: basin_code required: false schema: description: 'The Basin Code or "drainage basin code" is a two-digit code that further subdivides the 8-digit hydrologic-unit code. The drainage basin code is defined by the USGS State Office where the monitoring location is located. ' title: Basin code type: string style: form - description: 'Date the well was completed. ' explode: false in: query name: construction_date required: false schema: description: 'Date the well was completed. ' title: Construction date type: string style: form - description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' explode: false in: query name: contributing_drainage_area required: false schema: description: 'The contributing drainage area of a lake, stream, wetland, or estuary monitoring location, in square miles. This item should be present only if the contributing area is different from the total drainage area. This situation can occur when part of the drainage area consists of very porous soil or depressions that either allow all runoff to enter the groundwater or traps the water in ponds so that rainfall does not contribute to runoff. A transbasin diversion can also affect the total drainage area. ' title: Contributing drainage area type: number style: form - description: 'The code for the country in which the monitoring location is located. ' explode: false in: query name: country_code required: false schema: description: 'The code for the country in which the monitoring location is located. ' title: Country code type: string style: form - description: 'The name of the country in which the monitoring location is located. ' explode: false in: query name: country_name required: false schema: description: 'The name of the country in which the monitoring location is located. ' title: Country name type: string style: form - description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_code required: false schema: description: 'The code for the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County code type: string style: form - description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' explode: false in: query name: county_name required: false schema: description: 'The name of the county or county equivalent (parish, borough, etc.) in which the monitoring location is located. [A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/counties/items). ' title: County name type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - description: 'A code indicating the source of water-level data. ' explode: false in: query name: depth_source_code required: false schema: description: 'A code indicating the source of water-level data. ' title: Depth source code type: string style: form - description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' explode: false in: query name: district_code required: false schema: description: 'The Water Science Centers (WSCs) across the United States use the FIPS state code as the district code. In some case, monitoring locations and samples may be managed by a water science center that is adjacent to the state in which the monitoring location actually resides. For example a monitoring location may have a district code of 30 which translates to Montana, but the state code could be 56 for Wyoming because that is where the monitoring location actually is located. ' title: District code type: string style: form - description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' explode: false in: query name: drainage_area required: false schema: description: 'The area enclosed by a topographic divide from which direct surface runoff from precipitation normally drains by gravity into the stream above that point. ' title: Drainage area type: number style: form - description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: hole_constructed_depth required: false schema: description: 'The total depth to which the hole is drilled, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Hole Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Hole constructed depth type: number style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_code required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method code type: string style: form - description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' explode: false in: query name: horizontal_position_method_name required: false schema: description: 'Indicates the method used to determine latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-method-codes/items). ' title: Horizontal position method name type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy type: string style: form - description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' explode: false in: query name: horizontal_positional_accuracy_code required: false schema: description: 'Indicates the accuracy of the latitude longitude values. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-accuracy-codes/items). ' title: Horizontal positional accuracy code type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' explode: false in: query name: minor_civil_division_code required: false schema: description: 'Codes for primary governmental or administrative divisions of the county or county equivalent in which the monitoring location is located. ' title: Minor civil division code type: string style: form - description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' explode: false in: query name: monitoring_location_name required: false schema: description: 'This is the official name of the monitoring location in the database. For well information this can be a district-assigned local number. ' title: Monitoring location name type: string style: form - description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: monitoring_location_number required: false schema: description: "Each monitoring location in the USGS data base has a unique 8- to 15-digit identification number.\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Monitoring location number type: string style: form - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' explode: false in: query name: national_aquifer_code required: false schema: description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. Not all groundwater monitoring locations can be associated with a National Aquifer. Such monitoring locations will not be retrieved using this search criteria. A list of National aquifer codes and names is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/national-aquifer-codes/items). ' title: National aquifer code type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum type: string style: form - description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' explode: false in: query name: original_horizontal_datum_name required: false schema: description: 'Coordinates are published in EPSG:4326 / WGS84 / World Geodetic System 1984. This field indicates the original datum used to determine coordinates before they were converted. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/coordinate-datum-codes/items). ' title: Original horizontal datum name type: string style: form - description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type required: false schema: description: 'A description of the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type type: string style: form - description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' explode: false in: query name: site_type_code required: false schema: description: 'A code describing the hydrologic setting of the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/site-types/items). ' title: Monitoring location type code type: string style: form - description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' explode: false in: query name: state_code required: false schema: description: 'State code. A [two-digit ANSI code](https://www2.census.gov/geo/docs/reference/state.txt) (formerly FIPS code) as defined by the American National Standards Institute, to define States and equivalents. A three-digit ANSI code is used to define counties and county equivalents. [A lookup table is available.](https://www.census.gov/library/reference/code-lists/ansi.html#states) The only countries with political subdivisions other than the US are Mexico and Canada. The Mexican states have US state codes ranging from 81-86 and Canadian provinces have state codes ranging from 90-98. ' title: State code type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: 'A short code describing the time zone used by a monitoring location. ' explode: false in: query name: time_zone_abbreviation required: false schema: description: 'A short code describing the time zone used by a monitoring location. ' title: Time zone abbreviation type: string style: form - description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' explode: false in: query name: uses_daylight_savings required: false schema: description: 'A flag indicating whether or not a monitoring location uses daylight savings. ' title: Uses daylight savings flag type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum type: string style: form - description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' explode: false in: query name: vertical_datum_name required: false schema: description: 'The datum used to determine altitude and vertical position at the monitoring location. A list of codes is available at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/altitude-datums/items). ' title: Vertical datum name type: string style: form - description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' explode: false in: query name: well_constructed_depth required: false schema: description: 'The depth of the finished well, in feet below land surface datum. Note: Not all groundwater monitoring locations have information on Well Depth. Such monitoring locations will not be retrieved using this search criteria. ' title: Well constructed depth type: number style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/PeaksFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Peaks items tags: - peaks options: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: optionsPeaksFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Peaks items tags: - peaks post: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: getCQL2PeaksFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/PeaksFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Peaks items with CQL2 tags: - peaks /collections/peaks/items/{featureId}: get: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: getPeaksFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/PeaksFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Peaks item by id tags: - peaks options: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: optionsPeaksFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Peaks item by id tags: - peaks /collections/peaks/queryables: get: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: getPeaksQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - time_series_id - monitoring_location_id - parameter_code - unit_of_measure - value - last_modified - time - water_year - year - month - day - time_of_day - peak_since - qualifier type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Peaks queryables tags: - peaks /collections/peaks/schema: get: description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' operationId: getPeaksSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Peaks schema tags: - peaks /collections/reliability-codes: get: description: 'Code indicating the reliability of the data available for the site. ' operationId: describeReliability-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Reliability codes metadata tags: - reliability-codes /collections/reliability-codes/items: get: description: 'Code indicating the reliability of the data available for the site. ' operationId: getReliability-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - reliability_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: reliability_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/ReliabilityCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Reliability codes items tags: - reliability-codes options: description: 'Code indicating the reliability of the data available for the site. ' operationId: optionsReliability-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Reliability codes items tags: - reliability-codes post: description: 'Code indicating the reliability of the data available for the site. ' operationId: getCQL2Reliability-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/ReliabilityCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Reliability codes items with CQL2 tags: - reliability-codes /collections/reliability-codes/items/{featureId}: get: description: 'Code indicating the reliability of the data available for the site. ' operationId: getReliability-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/ReliabilityCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Reliability codes item by id tags: - reliability-codes options: description: 'Code indicating the reliability of the data available for the site. ' operationId: optionsReliability-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Reliability codes item by id tags: - reliability-codes /collections/reliability-codes/queryables: get: description: 'Code indicating the reliability of the data available for the site. ' operationId: getReliability-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - reliability_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Reliability codes queryables tags: - reliability-codes /collections/reliability-codes/schema: get: description: 'Code indicating the reliability of the data available for the site. ' operationId: getReliability-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Reliability codes schema tags: - reliability-codes /collections/site-types: get: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: describeSite-typesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Site types metadata tags: - site-types /collections/site-types/items: get: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: getSite-typesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - site_type_primary_flag - site_type_name - site_type_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: An acronym specifying the primary or secondary site type. explode: false in: query name: id required: false schema: description: An acronym specifying the primary or secondary site type. type: string style: form - description: Identifies which site types are primary. explode: false in: query name: site_type_primary_flag required: false schema: description: Identifies which site types are primary. type: string style: form - description: A long name for the site type used in retrieved output. explode: false in: query name: site_type_name required: false schema: description: A long name for the site type used in retrieved output. type: string style: form - description: Site type description. explode: false in: query name: site_type_description required: false schema: description: Site type description. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/SiteTypesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Site types items tags: - site-types options: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: optionsSite-typesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Site types items tags: - site-types post: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: getCQL2Site-typesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/SiteTypesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Site types items with CQL2 tags: - site-types /collections/site-types/items/{featureId}: get: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: getSite-typesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/SiteTypesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Site types item by id tags: - site-types options: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: optionsSite-typesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Site types item by id tags: - site-types /collections/site-types/queryables: get: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: getSite-typesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - site_type_primary_flag - site_type_name - site_type_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Site types queryables tags: - site-types /collections/site-types/schema: get: description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' operationId: getSite-typesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Site types schema tags: - site-types /collections/states: get: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: describeStatesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get State identifiers metadata tags: - states /collections/states/items: get: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: getStatesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_code - state_fips_code - state_name - state_postal_code type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' explode: false in: query name: country_code required: false schema: description: 'FIPS country code as defined by FIPS PUB 10-4: Countries, Dependencies, Areas of Special Sovereignty, and Their Principal Administrative Divisions.' type: string style: form - description: State FIPS code. explode: false in: query name: state_fips_code required: false schema: description: State FIPS code. type: string style: form - description: State name. explode: false in: query name: state_name required: false schema: description: State name. type: string style: form - description: State postal abbreviation. A two-letter USPS state postal abbreviation. explode: false in: query name: state_postal_code required: false schema: description: State postal abbreviation. A two-letter USPS state postal abbreviation. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/StatesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get State identifiers items tags: - states options: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: optionsStatesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for State identifiers items tags: - states post: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: getCQL2StatesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/StatesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get State identifiers items with CQL2 tags: - states /collections/states/items/{featureId}: get: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: getStatesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/StatesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get State identifiers item by id tags: - states options: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: optionsStatesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for State identifiers item by id tags: - states /collections/states/queryables: get: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: getStatesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - country_code - state_fips_code - state_name - state_postal_code type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get State identifiers queryables tags: - states /collections/states/schema: get: description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' operationId: getStatesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get State identifiers schema tags: - states /collections/statistic-codes: get: description: 'Statistic codes. ' operationId: describeStatistic-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Statistic codes metadata tags: - statistic-codes /collections/statistic-codes/items: get: description: 'Statistic codes. ' operationId: getStatistic-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - statistic_name - statistic_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Statistic code. explode: false in: query name: id required: false schema: description: Statistic code. type: string style: form - description: Statistic name. explode: false in: query name: statistic_name required: false schema: description: Statistic name. type: string style: form - description: Statistic description. explode: false in: query name: statistic_description required: false schema: description: Statistic description. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/StatisticCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Statistic codes items tags: - statistic-codes options: description: 'Statistic codes. ' operationId: optionsStatistic-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Statistic codes items tags: - statistic-codes post: description: 'Statistic codes. ' operationId: getCQL2Statistic-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/StatisticCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Statistic codes items with CQL2 tags: - statistic-codes /collections/statistic-codes/items/{featureId}: get: description: 'Statistic codes. ' operationId: getStatistic-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/StatisticCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Statistic codes item by id tags: - statistic-codes options: description: 'Statistic codes. ' operationId: optionsStatistic-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Statistic codes item by id tags: - statistic-codes /collections/statistic-codes/queryables: get: description: 'Statistic codes. ' operationId: getStatistic-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - statistic_name - statistic_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Statistic codes queryables tags: - statistic-codes /collections/statistic-codes/schema: get: description: 'Statistic codes. ' operationId: getStatistic-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Statistic codes schema tags: - statistic-codes /collections/time-series-metadata: get: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: describeTime-series-metadataCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Time series metadata metadata tags: - time-series-metadata /collections/time-series-metadata/items: get: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: getTime-series-metadataFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - unit_of_measure - parameter_name - parameter_code - statistic_id - hydrologic_unit_code - state_name - last_modified - begin - end - begin_utc - end_utc - computation_period_identifier - computation_identifier - thresholds - sublocation_identifier - primary - monitoring_location_id - web_description - parameter_description - parent_time_series_id - data_gap_interval type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: A unique identifier representing a single time series. This corresponds to the "time_series_id" field in other endpoints. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: id required: false schema: description: A unique identifier representing a single time series. This corresponds to the "time_series_id" field in other endpoints. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Time series ID type: string style: form - description: A human-readable description of the units of measurement associated with an observation. explode: false in: query name: unit_of_measure required: false schema: description: A human-readable description of the units of measurement associated with an observation. title: Unit of measure type: string style: form - description: A human-understandable name corresponding to `parameter_code`. explode: false in: query name: parameter_name required: false schema: description: A human-understandable name corresponding to `parameter_code`. title: Parameter name type: string style: form - description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: parameter_code required: false schema: description: "Parameter codes are 5-digit codes used to identify the constituent measured and the units of measure.\ \ A complete list of parameter codes and associated groupings can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/parameter-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Parameter code type: string style: form - description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: statistic_id required: false schema: description: "A code corresponding to the statistic an observation represents. Example codes include 00001 (max),\ \ 00002 (min), and 00003 (mean). A complete list of codes and their descriptions can be found at [https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items](https://api.waterdata.usgs.gov/ogcapi/v0/collections/statistic-codes/items).\n\ \ Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Statistic ID type: string style: form - description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial HUCs." explode: false in: query name: hydrologic_unit_code required: false schema: description: "The hydrologic unit code (HUC) for the monitoring location. Supports prefix matching — querying with\ \ a shorter HUC (e.g. \"04\") matches all locations within that hydrologic region.\n Search will match partial\ \ HUCs." title: Hydrologic unit code (HUC) type: string style: form - description: 'The name of the state or state equivalent in which the monitoring location is located. ' explode: false in: query name: state_name required: false schema: description: 'The name of the state or state equivalent in which the monitoring location is located. ' title: State name type: string style: form - description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded or\ \ half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n - A bounded\ \ interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" explode: false in: query name: last_modified required: false schema: description: "The last time a record was refreshed in our database. This may happen due to regular operational processes\ \ and does not necessarily indicate anything about the measurement has changed.\nYou can query this field using\ \ date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects. Intervals may be bounded\ \ or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\n -\ \ A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `last_modified` that intersects the value of datetime are selected.\n" title: Last modified date type: string style: form - description: 'This field contains the same information as "begin_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' explode: false in: query name: begin required: false schema: description: 'This field contains the same information as "begin_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' title: Time series first observation timestamp - local time type: string style: form - description: 'This field contains the same information as "end_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' explode: false in: query name: end required: false schema: description: 'This field contains the same information as "end_utc", but in the local time of the monitoring location. It is retained for backwards compatibility, but will be removed in V1 of these APIs. ' title: Time series most recent observation timestamp - local time type: string style: form - description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: begin_utc required: false schema: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" title: Time series first observation timestamp - UTC type: string style: form - description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: end_utc required: false schema: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" title: Time series most recent observation timestamp - UTC type: string style: form - description: Indicates the period of data used for any statistical computations. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: computation_period_identifier required: false schema: description: Indicates the period of data used for any statistical computations. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Computation period identifier type: string style: form - description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: computation_identifier required: false schema: description: Indicates the computation performed to calculate this time series. Values of "Instantaneous" reflect point measurements. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Computation identifier type: string style: form - description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' explode: false in: query name: thresholds required: false schema: description: 'Thresholds represent known numeric limits for a time series, for example the historic maximum value for a parameter or a level below which a sensor is non-operative. These thresholds are sometimes used to automatically determine if an observation is erroneous due to sensor error, and therefore shouldn''t be included in the time series. ' title: Operational thresholds type: string style: form - description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' explode: false in: query name: sublocation_identifier required: false schema: description: 'An optional human-readable identifier used to specify where measurements are recorded at a monitoring location. ' title: Sublocation identifier type: string style: form - description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' explode: false in: query name: primary required: false schema: description: 'A flag identifying if the time series is a "primary" time series. "Primary" time series (which have this flag) are standard observations which undergo [Bureau review and approval processes](https://www.usgs.gov/survey-manual/5028-fundamental-science-practices-review-and-approval-scientific-data-release). Non-primary time series, which will have missing values for "primary", are provisional datasets made available to meet the need for timely best science and to assist with daily operations which need real-time information. Non-primary time series data are only retained by this system for 120 days. See the [USGS Provisional Data Statement](https://waterdata.usgs.gov/provisional-data-statement/) for more information. ' title: Primary flag type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' explode: false in: query name: web_description required: false schema: description: 'An optional description of the time series. WDFN and other USGS data dissemination products use this field, in combination with sublocation_identifier, to distinguish the differences between multiple time series for the same parameter code, statistic code, and monitoring location. ' title: Time series description type: string style: form - description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' explode: false in: query name: parameter_description required: false schema: description: 'A description of what the parameter code represents, as used by WDFN and other USGS data dissemination products. ' title: Parameter description type: string style: form - description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' explode: false in: query name: parent_time_series_id required: false schema: description: 'The unique identifier representing the parent or "upchain" time series that a daily values time series is generated from. Daily values time series have one and only one parent time series. ' title: Parent time series ID type: string style: form - description: 'The time interval threshold used for gap detection in the time series. ' explode: false in: query name: data_gap_interval required: false schema: description: 'The time interval threshold used for gap detection in the time series. ' format: duration title: Data gap interval type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/TimeSeriesMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series metadata items tags: - time-series-metadata options: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: optionsTime-series-metadataFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time series metadata items tags: - time-series-metadata post: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: getCQL2Time-series-metadataFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/TimeSeriesMetadataFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series metadata items with CQL2 tags: - time-series-metadata /collections/time-series-metadata/items/{featureId}: get: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: getTime-series-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/TimeSeriesMetadataFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series metadata item by id tags: - time-series-metadata options: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: optionsTime-series-metadataFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time series metadata item by id tags: - time-series-metadata /collections/time-series-metadata/queryables: get: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: getTime-series-metadataQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - unit_of_measure - parameter_name - parameter_code - statistic_id - hydrologic_unit_code - state_name - last_modified - begin - end - begin_utc - end_utc - computation_period_identifier - computation_identifier - thresholds - sublocation_identifier - primary - monitoring_location_id - web_description - parameter_description - parent_time_series_id - data_gap_interval type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series metadata queryables tags: - time-series-metadata /collections/time-series-metadata/schema: get: description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' operationId: getTime-series-metadataSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series metadata schema tags: - time-series-metadata /collections/time-series-revisions: get: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: describeTime-series-revisionsCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Time series revisions metadata tags: - time-series-revisions /collections/time-series-revisions/items: get: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: getTime-series-revisionsFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10). explode: false in: query name: limit required: false schema: default: 10 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - monitoring_location_id - time_series_id - revision_note - begin - end type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: '#/components/parameters/wda_sortby' - $ref: '#/components/parameters/offset' - description: A unique identifier for a single revision record. Split parameters are enabled for this field, so you can supply multiple values separated by commas. explode: false in: query name: id required: false schema: description: A unique identifier for a single revision record. Split parameters are enabled for this field, so you can supply multiple values separated by commas. title: Revision ID type: string style: form - description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field in\ \ the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of the agency\ \ responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location (e.g. 02238500),\ \ separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field, so you can supply multiple\ \ values separated by commas." explode: false in: query name: monitoring_location_id required: false schema: description: "A unique identifier representing a single monitoring location. This corresponds to the `id` field\ \ in the `monitoring-locations` endpoint. Monitoring location IDs are created by combining the agency code of\ \ the agency responsible for the monitoring location (e.g. USGS) with the ID number of the monitoring location\ \ (e.g. 02238500), separated by a hyphen (e.g. USGS-02238500).\n Split parameters are enabled for this field,\ \ so you can supply multiple values separated by commas." title: Monitoring location ID type: string style: form - description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." explode: false in: query name: time_series_id required: false schema: description: "A unique identifier representing a single time series. This corresponds to the `id` field in the `time-series-metadata`\ \ endpoint.\n Split parameters are enabled for this field, so you can supply multiple values separated by commas." title: Time series ID type: string style: form - description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' explode: false in: query name: revision_note required: false schema: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions at this monitoring location. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. ' title: Revision note type: string style: form - description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: begin required: false schema: description: "The datetime of the earliest observation in the time series. Together with `end_utc`, this field represents\ \ the period of record of a time series. Note that some time series may have large gaps in their collection record.\n\ You can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `begin_utc` that intersects the value of datetime are selected.\n" title: Time series first observation timestamp - UTC type: string style: form - description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for the\ \ last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" explode: false in: query name: end required: false schema: description: "The datetime of the most recent observation in the time series. Data returned by this endpoint updates\ \ at most once per day, and potentially less frequently than that, and as such there may be more recent observations\ \ within a time series than the time series `end_utc` value reflects. Together with `begin_utc`, this field represents\ \ the period of record of a time series. It is additionally used to determine whether a time series is \"active\"\ .\nYou can query this field using date-times or intervals, adhering to RFC 3339, or using ISO 8601 duration objects.\ \ Intervals may be bounded or half-bounded (double-dots at start or end).\nExamples:\n\n - A date-time: \"2018-02-12T23:20:50Z\"\ \n - A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n - Half-bounded intervals: \"2018-02-12T00:00:00Z/..\"\ \ or \"../2018-03-18T12:31:12Z\"\n - Duration objects: \"P1M\" for data from the past month or \"PT36H\" for\ \ the last 36 hours\n\nOnly features that have a `end_utc` that intersects the value of datetime are selected.\n" title: Time series most recent observation timestamp - UTC type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/TimeSeriesRevisionsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series revisions items tags: - time-series-revisions options: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: optionsTime-series-revisionsFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time series revisions items tags: - time-series-revisions post: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: getCQL2Time-series-revisionsFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/TimeSeriesRevisionsFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series revisions items with CQL2 tags: - time-series-revisions /collections/time-series-revisions/items/{featureId}: get: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: getTime-series-revisionsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/TimeSeriesRevisionsFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series revisions item by id tags: - time-series-revisions options: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: optionsTime-series-revisionsFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time series revisions item by id tags: - time-series-revisions /collections/time-series-revisions/queryables: get: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: getTime-series-revisionsQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - monitoring_location_id - time_series_id - revision_note - begin - end type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series revisions queryables tags: - time-series-revisions /collections/time-series-revisions/schema: get: description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' operationId: getTime-series-revisionsSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time series revisions schema tags: - time-series-revisions /collections/time-zone-codes: get: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: describeTime-zone-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Time zone codes metadata tags: - time-zone-codes /collections/time-zone-codes/items: get: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: getTime-zone-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - time_zone_name - time_zone_description - time_zone_utc_offset - time_zone_daylight_savings_time_code - time_zone_daylight_savings_time_name - time_zone_daylight_savings_utc_offset type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - description: Time zone code. An NWIS time zone code. explode: false in: query name: id required: false schema: description: Time zone code. An NWIS time zone code. type: string style: form - description: Time zone name. An English name for a world time zone. explode: false in: query name: time_zone_name required: false schema: description: Time zone name. An English name for a world time zone. type: string style: form - description: Time zone description. explode: false in: query name: time_zone_description required: false schema: description: Time zone description. type: string style: form - description: Coordinated Universal Time (UTC) offset time. The number of hours offset from UTC time, in ISO format. explode: false in: query name: time_zone_utc_offset required: false schema: description: Coordinated Universal Time (UTC) offset time. The number of hours offset from UTC time, in ISO format. type: string style: form - description: Time zone Daylight Saving Time code. explode: false in: query name: time_zone_daylight_savings_time_code required: false schema: description: Time zone Daylight Saving Time code. type: string style: form - description: Time zone Daylight Saving Time name. explode: false in: query name: time_zone_daylight_savings_time_name required: false schema: description: Time zone Daylight Saving Time name. type: string style: form - description: Daylight Saving Time offset time. The number of hours offset from UTC time when Daylight Saving Time is in effect, in ISO format. explode: false in: query name: time_zone_daylight_savings_utc_offset required: false schema: description: Daylight Saving Time offset time. The number of hours offset from UTC time when Daylight Saving Time is in effect, in ISO format. type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/TimeZoneCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time zone codes items tags: - time-zone-codes options: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: optionsTime-zone-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time zone codes items tags: - time-zone-codes post: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: getCQL2Time-zone-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/TimeZoneCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time zone codes items with CQL2 tags: - time-zone-codes /collections/time-zone-codes/items/{featureId}: get: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: getTime-zone-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/TimeZoneCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time zone codes item by id tags: - time-zone-codes options: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: optionsTime-zone-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Time zone codes item by id tags: - time-zone-codes /collections/time-zone-codes/queryables: get: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: getTime-zone-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - time_zone_name - time_zone_description - time_zone_utc_offset - time_zone_daylight_savings_time_code - time_zone_daylight_savings_time_name - time_zone_daylight_savings_utc_offset type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time zone codes queryables tags: - time-zone-codes /collections/time-zone-codes/schema: get: description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' operationId: getTime-zone-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Time zone codes schema tags: - time-zone-codes /collections/topographic-codes: get: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: describeTopographic-codesCollection parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/Collection '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: Get Topographic codes metadata tags: - topographic-codes /collections/topographic-codes/items: get: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: getTopographic-codesFeatures parameters: - description: The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. explode: false in: query name: f required: false schema: default: json enum: - json - html - jsonld - csv type: string style: form - $ref: '#/components/parameters/lang' - $ref: '#/components/parameters/bbox' - description: The optional limit parameter limits the number of items that are presented in the response document (maximum=50000, default=10000). explode: false in: query name: limit required: false schema: default: 10000 maximum: 50000 minimum: 1 type: integer style: form - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/bbox-crs' - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - topography_name - short_topography_description - full_topography_description type: string type: array style: form - $ref: '#/components/parameters/skipGeometry' - $ref: https://raw.githubusercontent.com/opengeospatial/ogcapi-records/master/core/openapi/parameters/sortby.yaml - $ref: '#/components/parameters/offset' - explode: false in: query name: id required: false schema: type: string style: form - explode: false in: query name: topography_name required: false schema: type: string style: form - explode: false in: query name: short_topography_description required: false schema: type: string style: form - explode: false in: query name: full_topography_description required: false schema: type: string style: form - $ref: '#/components/parameters/filter' responses: '200': $ref: '#/components/responses/TopographicCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Topographic codes items tags: - topographic-codes options: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: optionsTopographic-codesFeatures responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Topographic codes items tags: - topographic-codes post: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: getCQL2Topographic-codesFeatures requestBody: content: application/json: schema: $ref: https://schemas.opengis.net/cql2/1.0/cql2.json description: Get items with CQL2 required: true responses: '200': $ref: '#/components/responses/TopographicCodesFeatures' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Topographic codes items with CQL2 tags: - topographic-codes /collections/topographic-codes/items/{featureId}: get: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: getTopographic-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId - $ref: '#/components/parameters/crs' - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/TopographicCodesFeature' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Topographic codes item by id tags: - topographic-codes options: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: optionsTopographic-codesFeature parameters: - $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/parameters/featureId responses: '200': description: options response security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Options for Topographic codes item by id tags: - topographic-codes /collections/topographic-codes/queryables: get: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: getTopographic-codesQueryables parameters: - description: The properties that should be included. The parameter value is a comma-separated list of property names. explode: false in: query name: properties required: false schema: items: enum: - id - topography_name - short_topography_description - full_topography_description type: string type: array style: form - $ref: '#/components/parameters/f' - description: The profile to be applied to a given request explode: false in: query name: profile required: false schema: enum: - actual-domain - valid-domain type: string style: form - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Topographic codes queryables tags: - topographic-codes /collections/topographic-codes/schema: get: description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' operationId: getTopographic-codesSchema parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: '#/components/responses/Queryables' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '404': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/NotFound '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError security: - ApiKeyQuery: [] - ApiKeyHeader: [] summary: Get Topographic codes schema tags: - topographic-codes /conformance: get: description: API conformance definition operationId: getConformanceDeclaration parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' responses: '200': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/LandingPage '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' '500': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/ServerError summary: API conformance definition tags: - server /openapi: get: description: This document operationId: getOpenapi parameters: - $ref: '#/components/parameters/f' - $ref: '#/components/parameters/lang' - description: UI to render the OpenAPI document explode: false in: query name: ui required: false schema: default: swagger enum: - swagger - redoc type: string style: form responses: '200': $ref: '#/components/responses/200' '400': $ref: https://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml#/components/responses/InvalidParameter '403': $ref: '#/components/responses/Forbidden403' '429': $ref: '#/components/responses/TooManyRequests429' default: $ref: '#/components/responses/default' summary: This document tags: - server servers: - description: 'The United States Geological Survey (USGS) collects water data at monitoring locations across the United States using both automated sensors and manual data collection. These APIs provide access to that data, alongside metadata about data collections and monitoring locations, in standardized machine-readable formats. ' url: https://api.waterdata.usgs.gov/ogcapi/v0 tags: - description: 'The United States Geological Survey (USGS) collects water data at monitoring locations across the United States using both automated sensors and manual data collection. These APIs provide access to that data, alongside metadata about data collections and monitoring locations, in standardized machine-readable formats. ' externalDocs: description: information url: https://api.waterdata.usgs.gov name: server - description: 'This endpoint provides the most recent observation for each time series of continuous data. Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code. These data might also be referred to as "instantaneous values" or "IV" ' name: latest-continuous - description: 'Continuous data are collected via automated sensors installed at a monitoring location. They are collected at a high frequency and often at a fixed 15-minute interval. Depending on the specific monitoring location, the data may be transmitted automatically via telemetry and be available on WDFN within minutes of collection, while other times the delivery of data may be delayed if the monitoring location does not have the capacity to automatically transmit data. Continuous data are described by parameter name and parameter code (pcode). These data might also be referred to as "instantaneous values" or "IV". ' name: continuous - description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' name: latest-daily - description: 'Daily data provide one data value to represent water conditions for the day. Throughout much of the history of the USGS, the primary water data available was daily data collected manually at the monitoring location once each day. With improved availability of computer storage and automated transmission of data, the daily data published today are generally a statistical summary or metric of the continuous data collected each day, such as the daily mean, minimum, or maximum value. Daily data are automatically calculated from the continuous data of the same parameter code and are described by parameter code and a statistic code. These data have also been referred to as “daily values” or “DV”. ' name: daily - description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' name: latest-field-measurements - description: 'Field measurements are physically measured values collected during a visit to the monitoring location. Field measurements consist of measurements of gage height and discharge, and readings of groundwater levels, and are primarily used as calibration readings for the automated sensors collecting continuous data. They are collected at a low frequency, and delivery of the data in WDFN may be delayed due to data processing time. ' name: field-measurements - description: 'Channel measurements taken as part of streamflow field measurements. ' name: channel-measurements - description: 'This endpoint combines metadata from timeseries and field measurements collections by site. ' name: combined-metadata - description: 'This endpoint provides metadata about field measurement collections, including when the earliest and most recent observations for a parameter occurred at a monitoring location and its units. ' name: field-measurements-metadata - description: 'Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred. ' name: time-series-metadata - description: 'Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC). ' name: monitoring-locations - description: 'Annual peak flow values are the maximum instantaneous streamflow values recorded at a particular site for the entire water year from October 1 to September 30. Note that the annual peak flow value may not occur at the same time the maximum water level occurs due to conditions such as backwater, tidal fluctuations, etc. ' name: peaks - description: 'Approved water data are considered published record, but on occasion changes or deletions (revisions) must be made to data after they are approved. Data revisions are rare because of USGS quality assurance practices, including documentation of all data before they are officially approved. This field contains text explanations for data revisions on a specific time series. Changes to data also are indicated with revision qualifier codes alongside the data. Text explanations before 2017 are not necessarily available online, but can be requested. This collection is non-spatial: revision records carry no geometry, so bbox/spatial filters are not supported. ' name: time-series-revisions - description: 'Code identifying the agency or organization used for site information, data sources, and permitting agencies. Agency codes are fixed values assigned by the National Water Information System (NWIS). ' name: agency-codes - description: 'The recommended vertical datum is NAVD88 (North American Vertical Datum of 1988) where applicable as stated in Office of Information Technical Memo 2002.01. NGVD29 (National Geodetic Vertical Datum of 1929) and NAVD88 are the only datums that can be converted on output. NWIS uses the North American Vertical Datum Conversions (VERTCON) of the National Geodetic Survey to convert from NGVD29 to NAVD88 or vice versa. Conversions to or from other vertical datums are not available. ' name: altitude-datums - description: 'Local aquifers in USGS data are identified by an aquifer name and geohydrologic unit code (a three-digit number related to the age of the formation, followed by a 4 or 5 character abbreviation for the geologic unit or aquifer name). For the age of formation (aquifer age), generally the smaller the number represents the younger the geohydrologic unit. Aquifer names and the definition of an aquifer can be very subjective. One rock unit may be called different aquifer names by different people. Local aquifers and layered aquifers are often grouped into larger named regional aquifers or aquifer systems. For example, the National Northern Atlantic Coastal Plain aquifer system (National aquifer) consists of five layered regional aquifers. Each regional aquifer is divided into two or more aquifers which may have a different name in each of the states in which the aquifer is found. ' name: aquifer-codes - description: 'Groundwater occurs in aquifers under two different conditions. Where water only partly fills an aquifer, the upper surface is free to rise and decline. These aquifers are referred to as unconfined (or water-table) aquifers. Where water completely fills an aquifer that is overlain by a confining bed, the aquifer is referred to as a confined (or artesian) aquifer. When a confined aquifer is penetrated by a well, the water level in the well will rise above the top of the aquifer (but not necessarily above land surface). ' name: aquifer-types - description: 'Appropriate code on the schedule to indicate the accuracy of the latitude-longitude values. ' name: coordinate-accuracy-codes - description: 'Horizontal datum code for the latitude/longitude coordinates. There are currently more than 300 horizontal datums available for entry. ' name: coordinate-datum-codes - description: 'Methods used to determine latitude-longitude values. ' name: coordinate-method-codes - description: 'The name of the county or county equivalent (parish, borough, planning reagion, etc.) in which the site is located. List includes Census Bureau FIPS county codes, names and associated Country and State. ' name: counties - description: 'FIPS country codes and names. ' name: countries - description: 'Hydrologic units are geographic areas representing part or all of a surface drainage basin or distinct hydrologic feature identified by a unique number (HUC), and a name. The United States is divided and sub-divided into successively smaller hydrologic units which are classified into four levels: regions, sub-regions, accounting units, and cataloging units. Each unit consists of two to eight digits based on the four levels of classification in the hydrologic unit system. Additional information can be found at <https://water.usgs.gov/GIS/huc.html>. ' name: hydrologic-unit-codes - description: 'Medium refers to the specific environmental medium from which the sample was collected. Medium type differs from site type because one site type, such as surface water, could have data for several media, such as water, bottom sediment, fish tissue, and others. ' name: medium-codes - description: 'Water measurement or water-quality analytical methods. Codes and descriptions defining a method for calculating or measuring the value of a water quality or quantity parameter. Method codes are associated with one or many parameter codes. ' name: methods - description: 'Categorical standards for methods describing the associated data''s appropriateness for an intended use. ' name: method-categories - description: 'Citation identifiers for water measurement methods. ' name: method-citations - description: 'Citations associated with water measurement methods. ' name: citations - description: 'National aquifers are the principal aquifers or aquifer systems in the United States, defined as regionally extensive aquifers or aquifer systems that have the potential to be used as a source of potable water. ' name: national-aquifer-codes - description: 'Parameter codes are 5-digit codes and associated descriptions used to identify the constituent measured and the units of measure. Some parameter code definitions include information about the sampling matrix, fraction, and methods used to measure the constituent. Some parameters are fixed-value (fxd) numeric codes having textual meaning (for example: parameter code 00041 is a weather code parameter, code of 60 means rain), but more commonly represent a numeric value for chemical, physical, or biological data. ' name: parameter-codes - description: 'Code indicating the reliability of the data available for the site. ' name: reliability-codes - description: 'The hydrologic cycle setting or a man-made feature thought to affect the hydrologic conditions measured at a site. Primary and secondary site types associated with data collection sites. All sites have a primary site type, and may additionally have a secondary site type that further describes the location. ' name: site-types - description: 'State name or territory. Includes U.S. states and foreign entities classified under FIPS as ''Principal Administrative Divisions''. ' name: states - description: 'Statistic codes. ' name: statistic-codes - description: 'The code that best describes the topographic setting in which the site is located. Topographic setting refers to the geomorphic features in the vicinity of the site. ' name: topographic-codes - description: 'The ISO 8601 standard defines time zone offsets as a numerical value added to a local time to convert it to Coordinated Universal Time (UTC), either as +hh:mm or -hh:mm, or represented by the letter Z to explicitly indicate UTC. For example, +05:30 means 5 hours and 30 minutes ahead of UTC, while -08:00 means 8 hours behind UTC. The offset Z specifically signifies UTC. ' name: time-zone-codes