# U.S. Geological Survey Topographic Codes API

**Canonical:** https://apis.io/apis/u-s-geological-survey/u-s-geological-survey-topographic-codes-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 Topographic Codes 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 topographic-codes. 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.

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.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/collections/topographic-codes` | Get Topographic codes metadata |
| GET | `/collections/topographic-codes/items` | Get Topographic codes items |
| OPTIONS | `/collections/topographic-codes/items` | Options for Topographic codes items |
| POST | `/collections/topographic-codes/items` | Get Topographic codes items with CQL2 |
| GET | `/collections/topographic-codes/items/{featureId}` | Get Topographic codes item by id |
| OPTIONS | `/collections/topographic-codes/items/{featureId}` | Options for Topographic codes item by id |
| GET | `/collections/topographic-codes/queryables` | Get Topographic codes queryables |
| GET | `/collections/topographic-codes/schema` | Get Topographic codes schema |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/openapi/u-s-geological-survey-topographic-codes-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

topographic-codes

---

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