Changelog
Back to All
Improved

[Breaking] Support Multiple Types of Telematics

20 days ago by Root Insurance

We've previously added the ability to opt a quote into various telematics programs offered by Root. This breaking change now separates programs into two distinct types: test_drives and electives.

Affected Endpoints

🔍 What's New

Before: All available telematics programs lived in options.telematics.programs.

Now: Programs are now broken into two distinct keys:

  • options.telematics.test_drives - These are test drive programs which, when telematics are enabled, require at least one enrollment. For backwards compatibility, we can offer a no_test_drive no-op program. This no-op program is not automatically enrolled in, so your integration must explicitly set this to enrolled.
  • options.telematics.electives - These are telematics addons which are completely optional. Zero or more may be selected.

Sample Response

{
  "quote": {
    ....,
    "options": {
      ....,
      "telematics": {
        "status": "available",
        "test_drives": [
          {
            "program": "arity",
            "name": "Arity",
            "description": "Telematics provided by Arity",
            "enrollment": {
              "value": "declined",
              "valid": true,
              "messages": null,
              "requirements": []
            },
            "consented_at": null
          },
          {
            "program": "cas",
            "name": "CAS",
            "description": "Telematics provided by CAS",
            "enrollment": {
              "value": "declined",
              "valid": true,
              "messages": null,
              "requirements": []
            },
            "consented_at": null
          },
					{
            "program": "no_test_drive",
            "name": "No Test Drive",
            "description": "Opt Out of Telematics",
            "enrollment": {
              "value": "enrolled",
              "valid": true,
              "messages": null,
              "requirements": []
            },
            "consented_at": "2025-06-19T16:20:36Z"
          }
        ]
      },
      "electives": [
          {
            "program": "continuous_connectivity",
            "name": "Root Continuous Telematics",
            "description": "Root Continuous Telematics Program",
            "enrollment": {
              "value": null,
              "valid": true,
              "messages": null,
              "requirements": []
            },
            "consented_at": null
          }
        ]
      },
      ....
    },
    ....
  },
  ....
}

Migration Notes

  • This is a non-backwards compatible change if you are currently using the telematics.options.programs key. In order to continue using telematics in a quote, you must update to the new format.
  • test_drives has a new requirement type, required_exclusive, which requires opting in to at least one program in the test_drives array.
  • The shape of each program within their new keys is the same as before.

Related