Vehicle Connections

curl -X GET "https://management.smartcar.com/v2.0/management/connections" \
  -H "Authorization: Basic $(echo -n "default:$SMARTCAR_APP_MANAGEMENT_TOKEN" | base64)" \
  -H "Content-Type: application/json"

import os
import base64
import requests

token = os.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN")
auth_header = base64.b64encode(f"default:{token}".encode()).decode()

headers = {
    "Authorization": f"Basic {auth_header}",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://management.smartcar.com/v2.0/management/connections",
    headers=headers
)

const basicAuth = Buffer.from(`default:${process.env.SMARTCAR_APP_MANAGEMENT_TOKEN}`).toString('base64');

const response = await fetch(
    "https://management.smartcar.com/v2.0/management/connections",
    {
        method: 'GET',
        headers: {
            'Authorization': `Basic ${basicAuth}`,
            'Content-Type': 'application/json'
        }
    }
);

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

String token = System.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN");
String auth = Base64.getEncoder().encodeToString(("default:" + token).getBytes());

URL url = new URL("https://management.smartcar.com/v2.0/management/connections");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Basic " + auth);
conn.setRequestProperty("Content-Type", "application/json");

int responseCode = conn.getResponseCode();

require 'net/http'
require 'uri'
require 'base64'

token = ENV['SMARTCAR_APP_MANAGEMENT_TOKEN']
auth = Base64.strict_encode64("default:#{token}")

uri = URI("https://management.smartcar.com/v2.0/management/connections")
request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Basic #{auth}"
request['Content-Type'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

{
  "connections": [
    {
      "userId": "<string>",
      "externalId": "<string>",
      "vehicleId": "<string>",
      "connectedAt": "<string>",
      "mode": "<string>"
    }
  ],
  "paging": {
    "cursor": "<string>"
  }
}

GET

v2.0

management

connections

curl -X GET "https://management.smartcar.com/v2.0/management/connections" \
  -H "Authorization: Basic $(echo -n "default:$SMARTCAR_APP_MANAGEMENT_TOKEN" | base64)" \
  -H "Content-Type: application/json"

import os
import base64
import requests

token = os.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN")
auth_header = base64.b64encode(f"default:{token}".encode()).decode()

headers = {
    "Authorization": f"Basic {auth_header}",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://management.smartcar.com/v2.0/management/connections",
    headers=headers
)

const basicAuth = Buffer.from(`default:${process.env.SMARTCAR_APP_MANAGEMENT_TOKEN}`).toString('base64');

const response = await fetch(
    "https://management.smartcar.com/v2.0/management/connections",
    {
        method: 'GET',
        headers: {
            'Authorization': `Basic ${basicAuth}`,
            'Content-Type': 'application/json'
        }
    }
);

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

String token = System.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN");
String auth = Base64.getEncoder().encodeToString(("default:" + token).getBytes());

URL url = new URL("https://management.smartcar.com/v2.0/management/connections");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Basic " + auth);
conn.setRequestProperty("Content-Type", "application/json");

int responseCode = conn.getResponseCode();

require 'net/http'
require 'uri'
require 'base64'

token = ENV['SMARTCAR_APP_MANAGEMENT_TOKEN']
auth = Base64.strict_encode64("default:#{token}")

uri = URI("https://management.smartcar.com/v2.0/management/connections")
request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Basic #{auth}"
request['Content-Type'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

{
  "connections": [
    {
      "userId": "<string>",
      "externalId": "<string>",
      "vehicleId": "<string>",
      "connectedAt": "<string>",
      "mode": "<string>"
    }
  ],
  "paging": {
    "cursor": "<string>"
  }
}

Request

Header

string

required

In the format Basic base64(default:{application_management_token}). You can find your application_management_token under your Application Configuration in the Smartcar Dashboard.

Query

integer

default:"10"

Number of connections to return per page. Max: 100

string

Used for accessing pages other than the first page. Each page returned has a cursor value that can be passed here to fetch the “next” page.

string

Filter for connections created by the provider user ID.

string

Filter for connections created with the provided external_id, your application’s own identifier for the vehicle owner.

string

Filter for connections to the provided vehicle ID.

string

Filter for connections by either live, simulated, or the deprecated test mode.

curl -X GET "https://management.smartcar.com/v2.0/management/connections" \
  -H "Authorization: Basic $(echo -n "default:$SMARTCAR_APP_MANAGEMENT_TOKEN" | base64)" \
  -H "Content-Type: application/json"

import os
import base64
import requests

token = os.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN")
auth_header = base64.b64encode(f"default:{token}".encode()).decode()

headers = {
    "Authorization": f"Basic {auth_header}",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://management.smartcar.com/v2.0/management/connections",
    headers=headers
)

const basicAuth = Buffer.from(`default:${process.env.SMARTCAR_APP_MANAGEMENT_TOKEN}`).toString('base64');

const response = await fetch(
    "https://management.smartcar.com/v2.0/management/connections",
    {
        method: 'GET',
        headers: {
            'Authorization': `Basic ${basicAuth}`,
            'Content-Type': 'application/json'
        }
    }
);

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

String token = System.getenv("SMARTCAR_APP_MANAGEMENT_TOKEN");
String auth = Base64.getEncoder().encodeToString(("default:" + token).getBytes());

URL url = new URL("https://management.smartcar.com/v2.0/management/connections");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Basic " + auth);
conn.setRequestProperty("Content-Type", "application/json");

int responseCode = conn.getResponseCode();

require 'net/http'
require 'uri'
require 'base64'

token = ENV['SMARTCAR_APP_MANAGEMENT_TOKEN']
auth = Base64.strict_encode64("default:#{token}")

uri = URI("https://management.smartcar.com/v2.0/management/connections")
request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Basic #{auth}"
request['Content-Type'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

Response

array

An array of connections

Show connections

string

ID of the user that authorized this connection (UUID v4).

string

Your application’s own identifier for the vehicle owner, if one was provided in the Connect URL. null if none was set.

string

ID of the vehicle connected (UUID v4).

string

Time at which the connection was created in UTC.

string

Vehicle mode: live, simulated, or test (deprecated).

Object

Metadata about the current query

Show child attributes

string

The cursor parameter that should be used to fetch the next page of results. This field will be null if there are no more pages.

⌘I

Introduction

Authorization

Connections

Webhooks

Vehicle Data

Vehicle Commands

Compatibility

API 2.0 Reference (Legacy)

Vehicle Commands (Legacy)

Management API (Legacy)

Compatibility API (Legacy)

Vehicle Connections

Request

Response

​Request

​Response

Request

Response