Read metric data.
metricId
globally unique identifier
Required
Guid ID of the metric for which to read data. |
archiveId
globally unique identifier
Guid ID of the archive for which metric data is to be read. |
startDate
date
Start date of the metric data, in the format "yyyy-mm-dd". |
endDate
date
End date of the metric data, in the format "yyyy-mm-dd". |
deleted
byte
Add ?deleted=0, 1, or 2 for not deleted, deleted, or all. |
tz
string
Optional parameter to set time zone information. |
None.
ID
globally unique identifier
Required on Update
ID of the Metric Data. |
MetricID
globally unique identifier
Required on Create
ID of the metric. |
Date
date
Required
Date of the metric data |
Value
decimal number
Required
Value of the metric data |
MetricName
string
ReadOnly
Name of the metric. |
ArchiveID
globally unique identifier
ReadOnly
ID of the archive were the metric data is stored. |
ArchiveName
string
ReadOnly
Name of the archive were the metric data is stored. |
ArchiveDate
date
ReadOnly
Date the metric data was archived. |
<TrendValue xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>2065e829-d8cd-49b7-a24a-421bd77cecf6</ID> <MetricID>af953921-aa05-4360-b08b-e0d8d0358b19</MetricID> <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T14:47:02.373725Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </Date> <Value>1</Value> <MetricName>sample string 1</MetricName> <ArchiveID>1e35f5f3-a8b3-4925-a8fb-38df5e5097b0</ArchiveID> <ArchiveName>sample string 2</ArchiveName> <ArchiveDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T14:47:02.3893248Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </ArchiveDate> </TrendValue>
{ "ID": "2065e829-d8cd-49b7-a24a-421bd77cecf6", "MetricID": "af953921-aa05-4360-b08b-e0d8d0358b19", "Date": "2025-08-26T14:47:02.373725+00:00", "Value": 1.0, "MetricName": "sample string 1", "ArchiveID": "1e35f5f3-a8b3-4925-a8fb-38df5e5097b0", "ArchiveName": "sample string 2", "ArchiveDate": "2025-08-26T14:47:02.3893248+00:00" }