Dates and Times

Use supported date and time formats consistently when sending Signal API requests.

Date and time format

Signal API examples use ISO 8601-style date-time strings with an explicit timezone offset for DateTime fields.

{
  "fromDateTime": "2016-07-13T00:00:00-07:00",
  "toDateTime": "2016-08-11T00:00:00-07:00"
}

Common fields that use date or date-time values include:

• fromDateTime
• toDateTime
• tariffEffectiveOn
• startDateTime
• endDateTime

Usage intervals

For time-series usage data, dataSeries values are paired with a fromDateTime and a duration in milliseconds. The duration defines the interval represented by each value.

For example, 3600000 represents a 60-minute interval.

"propertyInputs": [
    {
        "dataSeries": [
            1,
            2,
            3,
            4,
            5,...
        ],
        "fromDateTime": "2026-05-01T00:00:00-05:00",
        "duration": 3600000,
        "keyName": "consumption",
        "unit": "kWh"
    }
]

Related pages