Skip to content

api-evangelist/bmw-connecteddrive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BMW ConnectedDrive (bmw-connecteddrive)

BMW ConnectedDrive is BMW Group's umbrella for connected vehicle services spanning navigation, remote services, intelligent emergency call, ConnectedDrive Store add-ons, and the My BMW app. Programmatic access for customers, third-party developers, and the repair-and-maintenance ecosystem is consolidated under the BMW Open Data Platform / BMW CarData. CarData exposes an OAuth 2.0 Device Code Flow protected REST API at api-cardata.bmwgroup.com for retrieving static vehicle metadata (basicData), telematics, charging history, smart maintenance tyre diagnosis, location-based charging settings, vehicle images, and managing data "containers" that scope which telematics descriptors a client is authorized to read. A companion MQTT 3.1.1 streaming service at customer.streaming-cardata.bmwgroup.com:9000 (TLS) pushes live container data on the per-VIN topic {gcid}/{vin}. CarData is the EU regulatory successor to the legacy BMW ConnectedDrive REST endpoints used by the My BMW app and is the canonical surface for third-party automotive integrations, including independent repair, fleet, charging, and home-automation use cases.

APIs.json: https://raw.githubusercontent.com/api-evangelist/bmw-connecteddrive/refs/heads/main/apis.yml

Scope

  • Type: Provider
  • Position: Provider
  • Access: 3rd-Party

Tags

  • Automotive
  • Connected Vehicle
  • Telematics
  • Vehicle Data
  • CarData
  • ConnectedDrive
  • Electric Vehicles
  • Charging
  • MQTT
  • Streaming
  • OAuth
  • Device Code Flow
  • GDPR
  • Right To Repair
  • Mobility

Timestamps

  • Created: 2026-05-25
  • Modified: 2026-05-25

APIs

BMW CarData Customer API

The BMW CarData Customer API lets an authenticated BMW customer (or a delegate acting on their behalf via the customer portal) read vehicle metadata and telematics for the VINs mapped to their BMW ID account. Endpoints cover vehicle mappings, basic data, telematic data, charging history, smart-maintenance tyre diagnosis, location-based charging settings, vehicle images, and CRUD over CarData "containers" that define which descriptors a client subscribes to. Authentication uses the GCDM (Global Customer Data Management) bearer token obtained via the OAuth 2.0 Device Code Flow against the cardata:api:read scope. The base URL is https://api-cardata.bmwgroup.com with header x-version: v1. ID tokens are valid for one hour and must be refreshed via the standard OAuth refresh-token grant.

Tags

  • CarData
  • Vehicles
  • Telematics
  • Containers
  • Charging
  • OAuth

Properties

BMW CarData Streaming API

The BMW CarData Streaming API delivers near-real-time vehicle telematics over MQTT 3.1.1 with TLS. Clients connect to customer.streaming-cardata.bmwgroup.com on port 9000, authenticate with their GCID as the MQTT username and a GCDM access token (scope cardata:streaming:read) as the password, and subscribe to the per-vehicle topic {gcid}/{vin}. The set of descriptors streamed is controlled by the container(s) the client has registered via the CarData REST API, allowing a customer to scope exactly which signals (e.g. state of charge, mileage, doors, location) flow to each third-party integration. The streaming surface is the recommended path for charging optimizers, home-automation hubs, and fleet telematics back-ends that need event-driven updates instead of polled reads.

Tags

  • CarData
  • Streaming
  • MQTT
  • Telematics
  • Real-Time

Properties

BMW CarData Third-Party API

The third-party variant of BMW CarData targets independent service providers — repair shops, charging operators, fleet platforms, insurance, and aftermarket integrators — who consume vehicle data on behalf of customers who have explicitly consented through the BMW Open Data Platform. Third parties register a client, subscribe to one or more CarData services (which assigns the corresponding scope to the client ID), and then drive their users through the OAuth 2.0 Device Code Flow to obtain customer consent. The third-party surface reuses the same REST and MQTT endpoints as the Customer API but is bounded by the data-minimization rules of the BMW Open Data Platform and the EU Data Act / right-to-repair framework.

Tags

  • CarData
  • Third-Party
  • Vehicles
  • Telematics
  • Right To Repair

Properties

Common Properties

Maintainers

FN: Kin Lane Email: kin@apievangelist.com URL: https://apievangelist.com

Releases

No releases published

Packages

 
 
 

Contributors