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>80673e3a-f8d3-40be-9d55-416379471393</ID> <MetricID>53370d5e-eef7-4c8d-bb8b-6d871749deb3</MetricID> <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-27T09:47:13.4149881Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </Date> <Value>1</Value> <MetricName>sample string 1</MetricName> <ArchiveID>e4fd7a00-ead6-41da-8cdd-27e8e876abe8</ArchiveID> <ArchiveName>sample string 2</ArchiveName> <ArchiveDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-27T09:47:13.4149881Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </ArchiveDate> </TrendValue>
{ "ID": "80673e3a-f8d3-40be-9d55-416379471393", "MetricID": "53370d5e-eef7-4c8d-bb8b-6d871749deb3", "Date": "2025-08-27T09:47:13.4149881+00:00", "Value": 1.0, "MetricName": "sample string 1", "ArchiveID": "e4fd7a00-ead6-41da-8cdd-27e8e876abe8", "ArchiveName": "sample string 2", "ArchiveDate": "2025-08-27T09:47:13.4149881+00:00" }