Trackunit Webhook Event Types

This is the list of event types that we currently send.

Event Types

alerts.asset

data-feeds

faults.asset

fleet-data-health.asset.issues

inspection.inspection-response.submitted

rental.asset

service-management.service-status.updated

sites.asset

state.device

trip.has.ended

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AlertEventData

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "alertConfigurationId": "15dedb88-57a1-4aa7-9237-e976f15af116",
    "name": "My Movement Alert"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "alerts.asset.off"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AlertEventData

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "alertConfigurationId": "15dedb88-57a1-4aa7-9237-e976f15af116",
    "name": "My Movement Alert"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-09T15:31:05.843Z",
  "eventType": "alerts.asset.on"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Optional

Identifier for an asset

entityId

string

(uuid)

Optional

Entity identifier. For integration status change events, this is the integration ID.

entityType

string

Optional

Type of entity this event relates to.

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AssetSelectionRepresentation

Optional

3 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
    "integrationId": "e62824ba-6e60-48cf-b4d1-07204fe9bb54",
    "selected": true
  },
  "eventId": "eeba6427-3c44-4691-8e74-446403db8867",
  "eventTime": "2021-08-31T10:00:00Z",
  "eventType": "data-feeds.asset.selection-updated"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Optional

Identifier for an asset

entityId

string

(uuid)

Optional

Entity identifier. For integration status change events, this is the integration ID.

entityType

string

Optional

Type of entity this event relates to.

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

UnsuccessfulIntegrationRepresentation

Optional

5 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "data": {
    "dataFeedStatus": "RATE_LIMITED",
    "integrationId": "eeba6427-3c44-4691-8e74-446403db8867",
    "integrationName": "Data Feed name",
    "lastExecutionTimestamp": 1744638487679,
    "lastSuccessfulTimestamp": 1744638487679
  },
  "entityId": "eeba6427-3c44-4691-8e74-446403db8867",
  "entityType": "data-feed",
  "eventId": "eeba6427-3c44-4691-8e74-446403db8867",
  "eventTime": "2021-08-31T10:00:00Z",
  "eventType": "data-feeds.integration.status.change.beta"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AssetFaultData

4 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "description": "Exhaust Emission Control - Generator Average Line-Neutral AC RMS Voltage - Data Valid But Above Normal Operating Range - Least Severe Level",
    "j1939": {
      "fmi": 15,
      "sa": 44,
      "spn": 2444
    },
    "severity": 35
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "faults.asset.off"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AssetFaultData

4 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "description": "Exhaust Emission Control - Generator Average Line-Neutral AC RMS Voltage - Data Valid But Above Normal Operating Range - Least Severe Level",
    "j1939": {
      "fmi": 15,
      "sa": 44,
      "spn": 2444
    },
    "severity": 35
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "faults.asset.on"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

FleetDataHealthIssue

7 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "category": "DEVICE_BATTERY_ISSUES",
    "criticality": "CRITICAL",
    "deviceId": "245f704a-aca3-4d1c-ae85-5a92e1dcafcb",
    "issueId": "e294ad3a-acc1-477c-889e-08d927296fd5",
    "issueType": "LOW_DEVICE_BATTERY_VOLTAGE",
    "resolvedAt": null,
    "state": "OPEN"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "fleet-data-health.asset.issues"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

data

InspectionResponse

A data representation of the response to an inspection, detailing the outcome and relevant information collected during the inspection process.

7 Items

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "answers": [
      {
        "answer": "string",
        "id": "9306fd52-c2ce-43e7-b3bd-9da594b9e23c",
        "imageReferences": [
          {
            "id": "da91470f-b303-44db-99b5-d36da6357a4d",
            "imageId": "5a5e666e-7ed4-4fd4-a4d5-c38c7ef549e7",
            "imageUrl": "https://images.iris.trackunit.com/eyJrZXkiOiI1YTVlNjY2ZS03ZWQ0LTRmZDQtYTRkNS1jMzhjN2VmNTQ5ZTcifQ=="
          },
          {
            "id": "2cfd348d-be3e-47ee-afe5-69e418f30ea3",
            "imageId": "aad6915c-d35e-4b4f-8f55-979bc0233b7d",
            "imageUrl": "https://images.iris.trackunit.com/eyJrZXkiOiJhYWQ2OTE1Yy1kMzVlLTRiNGYtOGY1NS05NzliYzAyMzNiN2QifQ=="
          }
        ],
        "questionId": "4a831aef-283a-4c44-aff6-e8884f9e5c5e",
        "type": "string"
      }
    ],
    "inspectionResponseId": "a8b7d20c-1093-4f20-9a41-defea6e5c6c4",
    "inspectionTemplateVersionId": "3e236c79-bc7f-4a43-bac6-ed987b16d0b6",
    "inspectionTime": "2023-10-10T13:25:03.321Z",
    "location": {
      "latitude": 39.564569,
      "longitude": 2.6542945
    },
    "operatorId": "1e605626-c6c2-483c-9496-933c727e6f16",
    "status": "PASSED"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "inspection.inspection-response.submitted"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

ExcessUsageRepresentation

Optional

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "5c22c30e-14a8-44a6-bf77-4c2fcf08fe1a",
  "data": {
    "asset": {
      "contractItem": {
        "contract": {
          "customerId": "123e4567-e89b-12d3-a456-426614174000",
          "endDate": "2021-08-31T23:59:59Z",
          "externalReference": "605P1600003",
          "startDate": "2021-08-01T00:00:00Z",
          "status": "CANCELLED"
        },
        "deliveryAddress": {
          "address": "123 Main St.",
          "city": "Springfield",
          "country": "United States of America",
          "postalCode": "60031"
        },
        "externalReference": "123654",
        "offRentDate": "2021-09-30T10:00:00Z",
        "onRentDate": "2021-08-31T10:00:00Z",
        "pickupAddress": {
          "address": "123 Main St.",
          "city": "Springfield",
          "country": "United States of America",
          "postalCode": "60031"
        },
        "rentalRate": {
          "currency": "GBP",
          "interval": "WEEKLY_5_DAYS",
          "unitPrice": 100
        },
        "scheduledDeliveryDate": "2021-08-31T10:00:00Z",
        "scheduledPickupDate": "2021-09-30T10:00:00Z"
      },
      "rentalStatus": "ON_RENT"
    },
    "excessUsageInHours": 124.53
  },
  "eventId": "eeba6427-3c44-4691-8e74-446403db8867",
  "eventTime": "2021-08-31T10:00:00Z",
  "eventType": "rental.asset.off-rent.beta"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

AssetRepresentation

Optional

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "contractItems": {
      "contract": {
        "customerId": "123e4567-e89b-12d3-a456-426614174000",
        "endDate": "2021-08-31T23:59:59Z",
        "externalReference": "605P1600003",
        "startDate": "2021-08-01T00:00:00Z",
        "status": "CANCELLED"
      },
      "deliveryAddress": {
        "address": "123 Main St.",
        "city": "Springfield",
        "country": "United States of America",
        "postalCode": "60031"
      },
      "externalReference": "123654",
      "offRentDate": "2021-09-30T10:00:00Z",
      "onRentDate": "2021-08-31T10:00:00Z",
      "pickupAddress": {
        "address": "123 Main St.",
        "city": "Springfield",
        "country": "United States of America",
        "postalCode": "60031"
      },
      "rentalRate": {
        "currency": "GBP",
        "interval": "WEEKLY_5_DAYS",
        "unitPrice": 100
      },
      "scheduledDeliveryDate": "2021-08-31T10:00:00Z",
      "scheduledPickupDate": "2021-09-30T10:00:00Z"
    },
    "rentalStatus": "ON_RENT"
  },
  "eventId": "eeba6427-3c44-4691-8e74-446403db8867",
  "eventTime": "2021-08-31T10:00:00Z",
  "eventType": "rental.asset.updated.beta"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

PlannedServiceStatus

12 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "cumulativeOperatingHoursCriteria": {
      "criteria": {
        "id": "6037a205-927c-4937-8b05-602c4f677929",
        "notifyHoursBefore": 75,
        "serviceHours": 700
      },
      "triggered": false
    },
    "distanceCriteria": {
      "criteria": {
        "id": "6037a205-927c-4937-8b05-602c4f677929",
        "notifyDistanceBefore": 50,
        "serviceDistance": 500
      },
      "triggered": true
    },
    "name": "Regular Service",
    "plannedServiceId": "e62824ba-6e60-48cf-b4d1-07204fe9bb54",
    "predictedAt": "2021-09-20T06:09:09.621736Z",
    "predictedServiceTime": "2021-09-20T06:09:09.621736Z",
    "predictionCriteria": "CUMULATIVE_OPERATING_HOURS",
    "servicePlanId": "eeba6427-3c44-4691-8e74-446403db8867",
    "serviceProviderAccountId": "e62824ba-6e60-48cf-b4d1-07204fe9ab56",
    "status": "OVERDUE",
    "timeCriteria": {
      "criteria": {
        "notifyDaysBefore": 50,
        "serviceTime": "2021-09-25T12:14:03.321736Z"
      },
      "triggered": false
    },
    "triggeredAt": "2021-09-20T06:09:09.621736Z"
  },
  "eventId": "eeba6427-3c44-4691-8e74-446403db8867",
  "eventTime": "2023-11-30T05:44:16.081Z",
  "eventType": "service-management.service-updated"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

SiteData

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reason": "View permission was revoked",
    "siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-12-15T15:10:53.123Z",
  "eventType": "sites.asset.archive"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

SiteData

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reason": "Asset location updated",
    "siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-10-10T13:25:03.321Z",
  "eventType": "sites.asset.enter"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

SiteData

2 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reason": "Asset location updated",
    "siteId": "967679e8-ccf0-48b2-a2a4-c3595576c583"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2023-11-10T23:20:15.232Z",
  "eventType": "sites.asset.leave"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

data

CanProfileChangeData

Telematics device CAN profile change data containing device information and the reported state changes

3 Items

eventId

string

(uuid)

Unique identifier for this event instance

eventTime

string

(date-time)

Timestamp when the profile change occurred

eventType

string

Event type identifier (either state.device.canbus-can1-profile or state.device.canbus-can2-profile)

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reported": {
      "current": {
        "id": 123
      },
      "previous": {
        "id": 100
      }
    },
    "telematicDeviceId": "f3e36f77-25e0-8f97-295f-2f6faa0f5865",
    "telematicSerialNumber": "12345678"
  },
  "eventId": "c3e25f55-03c8-6f75-073f-0f4fee8d3643",
  "eventTime": "2025-01-01T01:00:00.000Z",
  "eventType": "state.device.canbus-can1-profile"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

data

CanProfileChangeData

Telematics device CAN profile change data containing device information and the reported state changes

3 Items

eventId

string

(uuid)

Unique identifier for this event instance

eventTime

string

(date-time)

Timestamp when the profile change occurred

eventType

string

Event type identifier (either state.device.canbus-can1-profile or state.device.canbus-can2-profile)

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reported": {
      "current": {
        "id": 123
      },
      "previous": {
        "id": 100
      }
    },
    "telematicDeviceId": "f3e36f77-25e0-8f97-295f-2f6faa0f5865",
    "telematicSerialNumber": "12345678"
  },
  "eventId": "d4f36g66-14d9-7g86-184g-1g5gff9e4754",
  "eventTime": "2025-01-01T01:00:00.000Z",
  "eventType": "state.device.canbus-can2-profile"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

data

OperatingHoursOffsetChangeData

Telematics device operating hours offset change data containing device information and the reported state changes

3 Items

eventId

string

(uuid)

Unique identifier for this event instance

eventTime

string

(date-time)

Timestamp when the offset change occurred

eventType

string

Event type identifier

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reported": {
      "current": {
        "offset": 7200
      },
      "previous": {
        "offset": 3600
      }
    },
    "telematicDeviceId": "f3e36f77-25e0-8f97-295f-2f6faa0f5865",
    "telematicSerialNumber": "12345678"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2025-01-01T01:00:00.000Z",
  "eventType": "state.device.io-input1-offset"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

data

DistanceOffsetChangeData

Telematics device distance offset change data containing device information and the reported state changes

3 Items

eventId

string

(uuid)

Unique identifier for this event instance

eventTime

string

(date-time)

Timestamp when the offset change occurred

eventType

string

Event type identifier

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "reported": {
      "current": {
        "offset": 5000
      },
      "previous": {
        "offset": 4000
      }
    },
    "telematicDeviceId": "f3e36f77-25e0-8f97-295f-2f6faa0f5865",
    "telematicSerialNumber": "12345678"
  },
  "eventId": "b2d14f44-92b7-5e64-962e-9e3edd7c2532",
  "eventTime": "2025-01-01T01:00:00.000Z",
  "eventType": "state.device.sensor-distance-offset"
}

accountId

AccountId

(uuid)

Identifier for an account

assetId

AssetId

(uuid)

Identifier for an asset

eventId

string

(uuid)

Identifier for an event. Unique for each event

eventTime

string

(date-time)

eventType

string

Event type is used to identify the both the nature of the event and the component it belongs to

data

TripData

6 Items

Example

JSON

{
  "accountId": "e294ad3a-acc1-477c-889e-08d927296fd5",
  "assetId": "eeba6427-3c44-4691-8e74-446403db8867",
  "data": {
    "cumulativeMovingHours": 0.25,
    "distanceTravelled": 2.56,
    "endDataPoint": {
      "address": {
        "city": "Holzgerlingen",
        "country": "DE",
        "street": "Sophiastraße 23",
        "zipCode": "71088"
      },
      "latitude": 48.643523,
      "longitude": 9.004017,
      "speed": 1.5,
      "timestamp": "2024-10-09T09:25:25Z"
    },
    "startDataPoint": {
      "address": {
        "city": "Calw",
        "country": "DE",
        "street": "Jahnstraße 19 Stammheim",
        "zipCode": "75365"
      },
      "latitude": 48.692345,
      "longitude": 8.76637,
      "speed": 4.5,
      "timestamp": "2024-10-09T08:30:54Z"
    },
    "topSpeed": 16,
    "tripId": "9b4db9e0-2ad6-49ea-ac1d-523673f46bdd"
  },
  "eventId": "a9c01033-83a6-4d53-851d-8d2dcc6b1421",
  "eventTime": "2024-10-10T13:25:03.321Z",
  "eventType": "trip.has.ended"
}

Trackunit Webhook Event Types

Event Types

alerts.asset.off

accountId

assetId

eventId

eventTime

eventType

data

alerts.asset.on

accountId

assetId

eventId

eventTime

eventType

data

data-feeds.asset.management.beta

accountId

assetId

entityId

entityType

eventId

eventTime

eventType

data

data-feeds.integration.status.change.beta

accountId

assetId

entityId

entityType

eventId

eventTime

eventType

data

faults.asset.off

accountId

assetId

eventId

eventTime

eventType

data

faults.asset.on

accountId

assetId

eventId

eventTime

eventType

data

fleet-data-health.asset.issues

accountId

assetId

eventId

eventTime

eventType

data

inspection.inspection-response.submitted

accountId

assetId

data

eventId

eventTime

eventType

rental.asset.off-rent.beta

accountId

assetId

eventId

eventTime

eventType

data

rental.asset.updated.beta

accountId

assetId

eventId

eventTime

eventType

data

service-management.service-status.updated

accountId

assetId

eventId