profile-instance

What it does

Lists all available profile instances (datasets) and their versions. Use it to see what instances exist before retrieving a specific one.

A profile instance is data recorded by one full cycle of the sensor as it sweeps through the key parameter range. This includes the timestamps for each reading. If the recorded data includes parameters not specified in the time series profile definition, the profile instance data stored in the CWMS database will be a subset of the overall recorded data.

Profile instances are identified by location, key parameter, version identifier, first recorded time, and version date. This means:

Multiple first recorded times can exist for a single location, key parameter, version identifier, and version date combination.
Multiple version identifiers can exist for a single location, key parameter, first recorded time, and version date combination.
Multiple version dates can exist for a single location, key parameter, version identifier, and first recorded time combination

When to use

Browse available instances by location/parameter
Find the latest or a specific version of an instance

GET /timeseries/profile-instanceEndpoint Parameters
Parameter	Description	Required
version-mask	A regular expression used to filter the version field for time series retrieval.
office-mask	office-mask
location-mask	location-mask
parameter-id-mask	parameter-id-mask

Note

Detailed documentation for Regex usage in CDA is currently in development and will be available at https://cwms-data.usace.army.mil/cwms-data/regexp in a future release.

Examples

List instances for a parameter at locations starting with ABC:

GET /timeseries/profile-instance?location-mask=ABC*&parameter-id-mask=Flow*&office=HQ

See the consolidated API documentation: API References.