Query connected vehicle

To retrieve a single connected vehicle use the connectedVehicle operation.

Querying for a connected vehicle requires authentication. This is currently not supported in the developer portal.


To query a single connected vehicle provide its id as an argument. It's strongly recommended to use a subscription instead of a query when making changes to a connected vehicle. This way updates will be automatically received.


id ID


Connected vehicle id

Frequently used fields

id ID

Unique ID of the connected vehicle

vehicle_id ID

Unique ID of the vehicle

status ConnectedVehicleStatus

Status of the connected vehicle

Show ConnectedVehicleStatus enum values

Other fields

authorization_url String

URL to connect the vehicle to the connectivity provider

provider CarConnectivityProvider

Connectivity provider

Show CarConnectivityProvider enum values

scope ConnectScope

Scope for accessing the vehicle

Show ConnectScope enum values

label String

Custom label for a connected vehicle that can be assigned by a user

vin String

Vehicle identification number, unique identifier for a vehicle


A response can either contain a data or an errors object. The response header will always return 200 as a status code.

Data object

When successful, a data object will be returned with the requested fields. If there are no fields present the data object will return the operation name with the appropriate return type. If the operation was a query, this output will be an object of the schema’s query root type; if the operation was a mutation, this output will be an object of the schema’s mutation root type.

Error object

If unsuccessful, an errors object will be returned with more details in the extensions object. The error object can contain any of the following objects.



The token you provided is expired



The token you provided is invalid



The connected vehicle was not found