GET apioauth/matrixv2/services/{serviceId}/telemetry?startDate={startDate}&endDate={endDate}

Get the telemetry for a service

Request Information

URI Parameters

NameDescriptionTypeAdditional information
serviceId

The service id queried, max 31 days

unsigned integer

Required

startDate

The start date being queried yyyyMMddHHmmss

string

Required

endDate

The end date being queried yyyyMMddHHmmss

string

Required

Body Parameters

None.

Response Information

Resource Description

Collection of TelemetryResponse
NameDescriptionTypeAdditional information
Timestamp

The record time in UTC

date

None.

Latitude

The latitude in degrees

decimal number

None.

Longitude

The longitude in degrees

decimal number

None.

Heading

The heading in degrees

decimal number

None.

Address

The telemetry address

TelemetryAddress

None.

SpeedKmph

The speed in kilometres per hour

decimal number

None.

SpeedMph

The speed in miles per hour

decimal number

None.

MessageType

The message type

event_t

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "Timestamp": "2026-09-19T09:40:57.716761+00:00",
    "Latitude": 1.1,
    "Longitude": 1.1,
    "Heading": 1.1,
    "Address": {
      "Street": "sample string 1",
      "Town": "sample string 2",
      "Postcode": "sample string 3",
      "County": "sample string 4",
      "Country": "sample string 5",
      "SpeedLimit": 1
    },
    "SpeedKmph": 1.1,
    "SpeedMph": 1.1,
    "MessageType": 0
  },
  {
    "Timestamp": "2026-09-19T09:40:57.716761+00:00",
    "Latitude": 1.1,
    "Longitude": 1.1,
    "Heading": 1.1,
    "Address": {
      "Street": "sample string 1",
      "Town": "sample string 2",
      "Postcode": "sample string 3",
      "County": "sample string 4",
      "Country": "sample string 5",
      "SpeedLimit": 1
    },
    "SpeedKmph": 1.1,
    "SpeedMph": 1.1,
    "MessageType": 0
  }
]

application/xml, text/xml

Sample:
<ArrayOfTelemetryResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <TelemetryResponse>
    <Timestamp>2026-09-19T09:40:57.716761+00:00</Timestamp>
    <Latitude>1.1</Latitude>
    <Longitude>1.1</Longitude>
    <Heading>1.1</Heading>
    <Address>
      <Street>sample string 1</Street>
      <Town>sample string 2</Town>
      <Postcode>sample string 3</Postcode>
      <County>sample string 4</County>
      <Country>sample string 5</Country>
      <SpeedLimit>1</SpeedLimit>
    </Address>
    <SpeedKmph>1.1</SpeedKmph>
    <SpeedMph>1.1</SpeedMph>
    <MessageType>NO_EVENT</MessageType>
  </TelemetryResponse>
  <TelemetryResponse>
    <Timestamp>2026-09-19T09:40:57.716761+00:00</Timestamp>
    <Latitude>1.1</Latitude>
    <Longitude>1.1</Longitude>
    <Heading>1.1</Heading>
    <Address>
      <Street>sample string 1</Street>
      <Town>sample string 2</Town>
      <Postcode>sample string 3</Postcode>
      <County>sample string 4</County>
      <Country>sample string 5</Country>
      <SpeedLimit>1</SpeedLimit>
    </Address>
    <SpeedKmph>1.1</SpeedKmph>
    <SpeedMph>1.1</SpeedMph>
    <MessageType>NO_EVENT</MessageType>
  </TelemetryResponse>
</ArrayOfTelemetryResponse>