GET metrics/{metricId}/values?archiveId={archiveId}&startDate={startDate}&endDate={endDate}&deleted={deleted}&tz={tz}

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Name	Description
metricId `globally unique identifier` Required Guid ID of the metric for which to read data.	`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.	`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".	`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".	`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.	`byte` Add ?deleted=0, 1, or 2 for not deleted, deleted, or all.
tz `string` Optional parameter to set time zone information.	`string` Optional parameter to set time zone information.

Body Parameters

None.

Response Information

Resource Description (TrendValue)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Name	Description
ID `globally unique identifier` Required on Update ID of the Metric Data.	`globally unique identifier` Required on Update ID of the Metric Data.
MetricID `globally unique identifier` Required on Create ID of the metric.	`globally unique identifier` Required on Create ID of the metric.
Date `date` Required Date of the metric data	`date` Required Date of the metric data
Value `decimal number` Required Value of the metric data	`decimal number` Required Value of the metric data
MetricName `string` ReadOnly Name of the metric.	`string` ReadOnly Name of the metric.
ArchiveID `globally unique identifier` ReadOnly ID of the archive were the metric data is stored.	`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.	`string` ReadOnly Name of the archive were the metric data is stored.
ArchiveDate `date` ReadOnly Date the metric data was archived.	`date` ReadOnly Date the metric data was archived.

Response Formats

application/xml, text/xml

Sample

<TrendValue xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>10eb1ac0-26a6-4e14-b6b1-5d7bd7ff2e0e</ID>
  <MetricID>f4451aab-ad74-4a45-a4c2-e2cef9f8139a</MetricID>
  <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-04-18T20:58:09.2016174Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </Date>
  <Value>1</Value>
  <MetricName>sample string 1</MetricName>
  <ArchiveID>7a4ae372-d007-4c7f-8cf6-d3229f807253</ArchiveID>
  <ArchiveName>sample string 2</ArchiveName>
  <ArchiveDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-04-18T20:58:09.2016174Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ArchiveDate>
</TrendValue>

application/json, text/json

Sample

{
  "ID": "10eb1ac0-26a6-4e14-b6b1-5d7bd7ff2e0e",
  "MetricID": "f4451aab-ad74-4a45-a4c2-e2cef9f8139a",
  "Date": "2025-04-18T20:58:09.2016174+00:00",
  "Value": 1.0,
  "MetricName": "sample string 1",
  "ArchiveID": "7a4ae372-d007-4c7f-8cf6-d3229f807253",
  "ArchiveName": "sample string 2",
  "ArchiveDate": "2025-04-18T20:58:09.2016174+00:00"
}