Query connected vehicle

To retrieve a single connected vehicle use the connectedVehicle operation.

Query

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.

Arguments

id non_null ID

Required

Connected vehicle id

Frequently used fields

id non_null ID

Unique ID of the connected vehicle

vehicle_id non_null ID

Unique ID of the vehicle

status non_null ConnectedVehicleStatus

Status of the connected vehicle

Other fields

authorization_url scalar String

URL to connect the vehicle to the connectivity provider

provider non_null CarConnectivityProvider

Connectivity provider

scope list ConnectScope

Scope for accessing the vehicle

label scalar String

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

vin scalar String

Vehicle identification number, unique identifier for a vehicle

Response

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.

Error

AUTH_TOKEN_EXPIRED

The token you provided is expired

Error

AUTH_TOKEN_INVALID

The token you provided is invalid

Error

CONNECTED_VEHICLE_NOT_FOUND

The connected vehicle was not found