# U.S. Geological Survey Time Series Revisions API

**Canonical:** https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-time-series-revisions-api/  
**Provider:** U.S. Geological Survey — https://apis.io/providers/u-s-geological-survey/  
**Base URL:** https://earthquake.usgs.gov/fdsnws/event/1  
**Documentation:** https://www.usgs.gov/tools/asset-identifier-service-ais

U.S. Geological Survey Time Series Revisions API is one of 47 APIs that [U.S. Geological Survey](https://apis.io/providers/u-s-geological-survey/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include time-series-revisions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, a JSON-LD context, authentication docs, and 3 JSON Schemas.

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.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/collections/time-series-revisions` | Get Time series revisions metadata |
| GET | `/collections/time-series-revisions/items` | Get Time series revisions items |
| OPTIONS | `/collections/time-series-revisions/items` | Options for Time series revisions items |
| POST | `/collections/time-series-revisions/items` | Get Time series revisions items with CQL2 |
| GET | `/collections/time-series-revisions/items/{featureId}` | Get Time series revisions item by id |
| OPTIONS | `/collections/time-series-revisions/items/{featureId}` | Options for Time series revisions item by id |
| GET | `/collections/time-series-revisions/queryables` | Get Time series revisions queryables |
| GET | `/collections/time-series-revisions/schema` | Get Time series revisions schema |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/openapi/u-s-geological-survey-time-series-revisions-api-openapi.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/conformance/u-s-geological-survey-conformance.yml
- **Documentation** — https://earthquake.usgs.gov/fdsnws/event/1/
- **GettingStarted** — https://earthquake.usgs.gov/earthquakes/feed/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-schema/usgs-earthquake-api-earthquake-properties-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-ld/usgs-earthquake-api-context.jsonld
- **Examples** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/examples/usgs-earthquake-api-earthquake-properties-example.json
- **Documentation** — https://api.waterdata.usgs.gov/docs/
- **Authentication** — https://api.waterdata.usgs.gov/signup/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-schema/usgs-water-data-api-monitoring-location-properties-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-schema/usgs-water-data-api-time-series-properties-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-ld/usgs-water-data-api-context.jsonld
- **Examples** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/examples/usgs-water-data-api-monitoring-location-properties-example.json

## Other U.S. Geological Survey APIs (12)

- [USGS Water Data APIs](https://apis.io/apis/u-s-geological-survey/water-data-ogc-api/)
- [Asset Identifier Service (AIS)](https://apis.io/apis/u-s-geological-survey/asset-identifier-service-ais/)
- [Seismic Design Web Service](https://apis.io/apis/u-s-geological-survey/seismic-design-web-service/)
- [ScienceBase](https://apis.io/apis/u-s-geological-survey/sciencebase/)
- [StreamStats Web Services](https://apis.io/apis/u-s-geological-survey/streamstats-web-services/)
- [USGS Water Services (Legacy)](https://apis.io/apis/u-s-geological-survey/usgs-water-services/)
- [U.S. Geological Survey Catalog API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-catalog-api/)
- [U.S. Geological Survey Earthquakes API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-earthquakes-api/)
- [U.S. Geological Survey Monitoring Locations API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-monitoring-locations-api/)
- [U.S. Geological Survey Reference Data API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-reference-data-api/)
- [U.S. Geological Survey Time Series Data API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-time-series-data-api/)
- [U.S. Geological Survey Agency Codes API](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-agency-codes-api/)

## Tags

time-series-revisions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-time-series-revisions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/u-s-geological-survey/.