BMW Guide

Here is a guide to supported BMW models and regions, information on the necessary connectivity subscriptions, API pricing and datapoints, and relevant links to telematics information on BMW's connected car website.

Table of Contents

Available data points

You can find a breakdown of all available data points in the Auto API availability for BMW & MINI table.

Eligible Models

All European-market BMW models produced since July 2017 have connection capabilities, and come with three years of ConnectedDrive services at no cost.

Supported Markets

BMW and MINI customers in the following countries can grant 3rd-party access to vehicle data: Austria, Belgium, Bulgaria, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, and the United Kingdom.

BMW Data Plans

In order for a BMW customer to supply data through HIGH MOBILITY's Auto APIs, he or she must have a ConnectedDrive subscription with BMW or MINI, and the ConnectedDrive "Remote Services" service. Four different ConnectedDrive packages are available: Connected Package, Connected Package Plus, Connected Package Professional, and Connected Package Excellence. Prices and services offered vary. Each package includes "Remote Services"; any package will provide all the data necessary for any of the services built with HIGH MOBILITY's Auto APIs.

API Refresh Rate

All eligible BMW models can reliably send data at what might be considered the beginning and end of a trip. An update is sent when a driver unlocks and opens his door, and another occurs when the driver leaves the car and locks the doors. Another update is sent whether or not the car has been driven.

The newest BMW models also send data during the trip, every two minutes or three kilometers, whichever comes first.

API Pricing

For example pricing, please visit our pricing page. You are presented with the pricing for your data points selection within the platform when creating a production app.

Data Points

You can find a breakdown of all available data points in the Auto API availability for BMW & MINI table. Each request returns a timestamp with each data point; it indicates the moment the data was transferred from the vehicle.

Webhooks

The webhooks below are currently in production.

  1. Each webhook callback costs €0,12 until price cap of €6,69 per month per car (this price cap includes calls to the Auto API as well). authorization_changed and authorization_changed are free of charge.
  2. We offer volume discounts for accounts which connect large numbers of vehicles. The discount is calculated at the end of each month, and is based on the number of vehicles which received requests that month.
WebhookTriggerUpdated Properties
Accident ReportedTriggered when the driver confirms a minor accident (without deployment of the airbags)Vehicle Location: Latitude, Longitude, and Heading
Engine: Ignition, Engine On
Diagnostics: Mileage, Battery Level
Lights: Front Exterior Lights
Mobile: Connection
Race: Vehicle Moving
Vehicle Time: Vehicle Time
Navi Destination: Arrival Duration, and Coordinates
Authorization ChangedWhen an access token’s authorization state changes – for instance, from “pending” to “active”, the authorization_changed webhook is sent, and includes the new authorization statusAuthorization state
Battery Guard WarningSent when the 12V battery runs low.
Emergency ReportedTriggered when there is an emergency callVehicle Location: Latitude, Longitude, and Heading
Engine: Ignition, Engine On
Diagnostics: Mileage, Battery Level
Lights: Front Exterior Lights
Mobile: Connection
Race: Vehicle Moving
Vehicle Time: Vehicle Time
Fleet Clearance ChangedSent when the clearance status of a fleet vehicle changes.
Maintenance ChangedTriggered when the Condition based services changes
Vehicle Location ChangedTriggered when the Condition based services changes

Example webhook

The following example shows the JSON content of an accident_reported event being delivered.

{
    "vehicle": {
        "vin": "1HMCF6112HA3FBBCC",
        "serial_number": "BB5EAC44D33F205A87"
    },
    "event": {
        "type": "accident_reported",
        "received_at": "2019-02-20T09:13:33.563772Z",
        "action": "automatic"
    },
    "application": {
        "id": "A77294AC8DA324FB46DA98921"
    }
}

More Information

BMW's page for ConnectedDrive subscriptions.

If you have any questions, please contact us on Slack.