Sections

  • Basics
  • API reference
  • Release notes
  • Deprecations
  • Examples
Sign in / Sign up
  • Sign in / Sign up
Mutate to create a new connected vehicle
Mutate to authorize a connected vehicle

Subscribe to a connected vehicle

After creating a connected vehicle, it's advised to open a GraphQL subscription. Whenever making changes such as finishing the authorization or renaming the vehicle, updates are sent over this subscription.

Subscription

The subscription service needs to be initiated with the id of a connected vehicle. After the subscription is established, updates will be provided until the connection is closed.

Arguments

id • ID

• Required

Frequently used fields

status • ConnectedVehicleStatus

Status of the connected vehicle

Show ConnectedVehicleStatus enum values

pending_authorization

Vehicle was added to the Chargetrip Connect platform but not yet authorized

authorized

Vehicle was authorized. Chargetrip can retrieve data on behave of the user

pending_removal

Pending vehicle removal

removed

Vehicle was removed and access has been revoked

label • String

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

Other fields

id • ID

Unique ID of the connected vehicle

vehicle_id • ID

Unique ID of the vehicle

authorization_url • String

URL to connect the vehicle to the connectivity provider

provider • CarConnectivityProvider

Connectivity provider

Show CarConnectivityProvider enum values

Enode

scope • ConnectScope

Scope for accessing the vehicle

Show ConnectScope enum values

location

Vehicle location, applicable for: Enode

charge_state

Charge state, applicable for: Enode

odometer

Odometer reading, applicable for: Enode

vin • 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

  • Basics

    API Basics GraphQL Basics EV basics
  • API reference

    API Vehicles Stations Routes Navigation Vehicle connectivity Tile service Isolines
  • Products

    Website Dashboard Help center SDKs
  • Tooling

    Playground Voyager Examples API Status
  • Legal

    Terms & Conditions Privacy Policy Cookie Policy SLA Security
Mission Statement State of charge Try Chargetrip Go

© Chargetrip 2023

Build with love in

Amsterdam ❤️

API reference

  • API
  • Vehicles
  • Stations
  • Routes
  • Navigation
  • Vehicle connectivity
  • Tile service
  • Isolines

Sections

  • Quick setup guide
  • Pagination
  • Vehicle introduction
  • Query vehicles
  • Query vehicle details
  • Query premium vehicle details
  • Station introduction
  • Query stations
  • Query station details
  • Query stations around a GeoJSON point
  • Query station reviews
  • Mutate to create a station review
  • Query station operators
  • Query station operator details
  • Query station tariffs
  • Query station tariff details
  • Query station amenities
  • Query station statistics
  • Route introduction
  • Mutate to create a new route
  • Subscribe to route updates
  • Query route details
  • Query route path
  • Navigation introduction
  • Mutate to start a new navigation session
  • Subscribe to navigation updates
  • Query navigation session
  • Mutate to update a navigation session
  • Mutate to recalculate navigation
  • Mutate to finish navigation
  • Introduction
  • Mutate to create a new connected vehicle
  • Subscribe to a connected vehicle
  • Mutate to authorize a connected vehicle
  • Query connected vehicle list
  • Query data from vehicle
  • Query connected vehicle
  • Mutate to update a connected vehicle
  • Mutate to remove a connected vehicle
  • Tile service introduction
  • Properties
  • Filters
  • Integration
  • Isoline introduction
  • Mutation to create an isoline
  • Subscribe to isoline details
  • Query isoline details