Buying a Tesla? Get 1,000 miles of free supercharging with my referral code.

C# Tesla API Client

This is an unofficial .NET client implementation of the Tesla JSON API used by the Android and iOS apps. The API provides functionality to monitor and control the Tesla vehicles remotely.

Tim Dorr API Documentation

API Documentation GitHub

Installation

.NET CLI

dotnet add package 'Tesla-API'

Setup

Dependency Injection

When registering your services, call the method below to allow all required services to be dependency injected.

services.AddTeslaApi();

Usage

To make a request with the Tesla API, you'll need to create a HttpClient and set the User-Agent header to an identifier for your application.

Authenticating with Tesla

Follow the standard OAuth process as documented by Tim Dorr to get an access token. After getting an access token, add it to the Authorization header on the HttpClient, which is passed into data API calls.

You can use the TeslaAuth package that provides a .NET implementation to obtain a refresh token.

Example Code

public class TeslaService
{
    private readonly ITeslaAPI _teslaAPI;
    private readonly HttpClient _client = new HttpClient();
    
    /// <summary>
    /// Initializes a new instance of the <see cref="TeslaService"/> class.
    /// </summary>
    /// <param name="teslaClient">The TeslaAPI client.</param>
    public TeslaService(ITeslaAPI teslaAPI)
    {
        _teslaAPI = teslaAPI;
        _client.DefaultRequestHeaders.Add("User-Agent", "MyApplication");
    }
    
    /// <summary>
    /// Get all vehicles in the user's account.
    /// </summary>
    /// <returns>A list containing~~~~ all vehicles.</returns>
    public async Task<List<Vehicle>> GetVehiclesAsync(string clientId, string clientSecret, string bearerToken)
    {
        TeslaAccessToken accessToken = await _teslaAPI.GetAccesTokenAsync(_client, clientId, clientSecret, bearerToken);
        _client.DefaultRequestHeaders.Add("Authorization", $"Bearer {accessToken.AccessToken}");
        
        return await _teslaAPI.GetAllVehiclesAsync(_client);
    }
}

Tests

To run tests you will need a Tesla access token along with additional vehicle and/or energy site information. These tests make actuall calls to the Tesla API, thus Tesla products are required on your account. i.e. to test the vehicle endpoints, you have to have a vehicle registered to your Tesla account.

1. Generate a Tesla access token. There's a handy Chrome plugin for this.
2. Copy the appsettings.json file to appsettings.Development.json and fill in the Tesla.AccessToken field along with any other fields required by the test(s) you want to run.
3. Run the test(s).