# Introduction This is unofficial documentation of the Tesla JSON API used by their iOS and Android apps. It features functionality to monitor and control their vehicle (Models S, 3, X, Y) and power (Powerwall) products. We currently have documentation for their vehicles, but always accept [pull requests](https://github.com/timdorr/tesla-api/pulls) for improvements and additions. If you want to use Tesla's Bluetooth Low Energy (BLE) protocol to communicate with the car instead, [there is a separate documentation project for it](https://teslabtapi.lexnastin.com). ## Before You Begin The base URI for all requests is `https://owner-api.teslamotors.com/` (except for the Streaming and Autopark APIs) > If you are in China, the URI for requests is going to be `owner-api.vn.cloud.tesla.cn` for you.\ > Keep in mind to replace all `auth.tesla.com` URLs to `auth.tesla.cn` as well. *All requests require a* `User-Agent` *header with any value provided.* For Tesla's sake, it's recommended you identify your application in some way using this header. ## API Organization The API for vehicles is organized into 3 primary surfaces: ### State and commands Gives point-in-time data about the state of the vehicle and basic controls over certain functions of the vehicle. The state and command APIs loosely adhere to the REST standard, but differ in some crucial ways. As a result, you may not be able to use it with many REST tools and libraries out of the box. ### Streaming telemetry Streams in data about the car's telemetry at up to half second increments. The underlying protocol is simply a streaming HTTP API that provides JSON objects at regular intervals. ### Autopark ("Summon") A streaming command mode to control the automatic parking of HW1 (older Autopilot-only) and HW2/3 (FSD-capable) cars. This API uses a standard WebSocket that exchanges JSON objects to convey state information and issue commands during the Autopark session. # Authentication The authentication process for the Tesla API Tesla uses a separate SSO service (auth.tesla.com) for authentication across their app and website. This service is designed around a browser-based flow using OAuth 2.0, but also appears to have support for Open ID Connect. This supports both obtaining an access token and refreshing it as it expires. {% hint style="warning" %} Tesla's SSO service has a WAF (web application firewall) that may temporarily block you if you make repeated, execessive requests. This is to prevent bots from attacking the service, either as a brute force or denial-of-service attack. This normally presents as a "challenge" page, which requires running some non-trivial JavaScript code to validate that you have a full browser engine available. While you can potentially fully evaluate this page to remove the block, the best practice for now is to reduce your calls to the SSO service to a minimum and avoid things like automatic request retries. The service also expects TLS 1.2 or lower connections, so avoid connecting with TLS 1.3. {% endhint %} ## Logging in ### Step 1: Obtain the login page Subsequent requests to the SSO service will require a "code verifier" and "code challenge". These are a random 86-character alphanumeric string and its SHA-256 hash encoded in URL-safe base64 (base64url). Here is an example of generating them in Ruby, but you can apply this same process to other languages. ```ruby code_verifier = random_string(86) code_challenge = Base64.urlsafe_encode64(Digest::SHA256.hexdigest(code_verifier)) ``` You will also need a stable `state` value for requests, which is a random string of any length. Avoid setting a `User-Agent` header that looks like a browser (such as Chrome or Safari). The SSO service has protections in place that will require executing JavaScript if a browser-like user agent is detected. #### GET `https://auth.tesla.com/oauth2/v3/authorize` The first request returns HTML intended for display in the browser. You will need to parse this HTML for hidden input fields. The request is made with a `redirect_url` of "", which is a non-existent page. The Tesla app intercepts the request to this page to capture the authorization code. **Request parameters** | Field | Type | Example | Description | | ----------------------- | ---------------- | -------------------------------------- | ----------------------------------------------------------------- | | `client_id` | String, required | `ownerapi` | The OAuth client ID. Always "ownerapi" | | `code_challenge` | String, required | `123` | The "code challenge" | | `code_challenge_method` | String, required | `S256` | The code challenge hash method. Always "S256" (SHA-256) | | `redirect_uri` | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "" | | `response_type` | String, required | `code` | The type of expected response. Always "code" | | `scope` | String, required | `openid email offline_access` | The authentication scope. Always "openid email offline\_access" | | `state` | String, required | `123` | The OAuth state value. Any random string. | | `login_hint` | String, optional | `elon@tesla.com` | The email for the authenticating Tesla account | **Response** This returns an HTML response body. There will be a `
` with hidden `` elements that contain session-based information to prevent CSRF attacks. At the moment, they appear to be `_csrf`, `_phase`, `_process`, `transaction_id`, and `cancel`, but they may change due to server-side changes by Tesla. These must be provided in the POST body to validate the following request. The response will also include a `set-cookie` header that includes a session ID cookie. This should be provided to the following request as a `Cookie` header so that the SSO service can match up your request with private data it has in that session. When the optional `login_hint` parameter is supplied with the `GET` request and the email is registered with a Tesla SSO service in another region this will respond with a 303 HTTP response code (See Other), which will redirect you to the Tesla SSO service in that region (e.g. auth.tesla.cn). Should this redirect happen you should continue using the region specific Tesla SSO host name in all subsequent steps. Easy way to test this is to use `auth.tesla.cn` with `login_hint` using an email registered under `auth.tesla.com`. ### Step 2: Obtain an authorization code This will simulate a user submitting the form from the previous request in their browser. Ensure that the hidden ``s are provided as POST body parameters and the `Cookie` header is set. #### POST `https://auth.tesla.com/oauth2/v3/authorize` ```http Cookie: {cookie value from set-cookie header} ``` **Request parameters** > Note: These are query parameters, not part of the POST body | Field | Type | Example | Description | | ----------------------- | ---------------- | -------------------------------------- | ----------------------------------------------------------------- | | `client_id` | String, required | `ownerapi` | The OAuth client ID. Always "ownerapi" | | `code_challenge` | String, required | `123` | The "code challenge" | | `code_challenge_method` | String, required | `S256` | The code challenge hash method. Always "S256" (SHA-256) | | `redirect_uri` | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "" | | `response_type` | String, required | `code` | The type of expected response. Always "code" | | `scope` | String, required | `openid email offline_access` | The authentication scope. Always "openid email offline\_access" | | `state` | String, required | `123` | The OAuth state value. Any random string. | > Note: This is the contents of the POST body. These should be form encoded (`application/x-www-form-urlencoded`). | Field | Type | Example | Description | | ------------------ | ------------------- | ------------------- | ------------------------------------------------- | | hidden input names | String\[], required | hidden input values | The fields from the HTML's hidden ``s | | `identity` | String, required | `elon@tesla.com` | The email for the authenticating Tesla account | | `credential` | String, required | `brbgoingtomars` | The password for the authenticating Tesla account | **Response** This will respond with a 302 HTTP response code, which will attempt to redirect to the redirect\_uri with additional query parameters added. This new URL is located in the `location` header. You should not follow it, as it is non-existent. Instead, you should parse this URL and extract the `code` query parameter, which is your authorization code. ```http Location: https://auth.tesla.com/void/callback?code=c7dc7f8196d001632558d6632558d6243632558d6b6d60f82c0632558d67&state=aGZzZGpzZnNk&issuer=https%3A%2F%2Fauth.tesla.com%2Foauth2%2Fv3 ``` ### Step 3: Exchange authorization code for bearer token #### POST `https://auth.tesla.com/oauth2/v3/token` This is a standard [OAuth 2.0 Authorization Code exchange](https://oauth.net/2/grant-types/authorization-code/). This endpoint uses JSON for the request and response bodies. **Request parameters** | Field | Type | Example | Description | | --------------- | ---------------- | -------------------------------------- | ----------------------------------------------------------------- | | `grant_type` | String, required | `authorization_code` | The type of OAuth grant. Always "authorization\_code" | | `client_id` | String, required | `ownerapi` | The OAuth client ID. Always "ownerapi" | | `code` | String, required | `123` | The authorization code from the last request. | | `code_verifier` | String, required | `123` | The code verifier string generated previously. | | `redirect_uri` | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "" | ```json { "grant_type": "authorization_code", "client_id": "ownerapi", "code": "123", "code_verifier": "123", "redirect_uri": "https://auth.tesla.com/void/callback" } ``` **Response** The response varies. If the user has no MFA enabled, the response will be: ```json { "access_token": "eyJaccess", "refresh_token": "eyJrefresh", "expires_in": 300, "state": "of the union", "token_type": "Bearer" } ``` However, if the user has MFA enabled the response will be an HTML document with a `passcode` field inside it. This is for the TOTP (Time-based-One-time Password). To authenticate, you first need to get the list of known factors on the account, by requesting the `/authorize/mfa/factors` endpoint via GET. You also need to supply the `transaction_id` from the `/authorize` endpoint with this request. | Field | Type | Description | | ---------------- | :--------------: | -------------------------------------------------- | | `transaction_id` | String, required | The transaction id from the `/authorize` endpoint. | ```json { "transaction_id": "transaction_id" } ``` After doing this you need to send a POST request to the `/authorize/mfa/verify` endpoint with the `transaction_id`, `factor_id` and the current TOTP `passcode`. Similar to step 1, you also need to pass an additional `_csrf` field to the `/authorize/mfa/verify` endpoint. However, this is a different one from the first request, and has to fetched and parsed from the response of the `/authorize` endpoint that you hit earlier (the same response that had a `passcode` field inside of it). | Field | Type | Description | | ---------------- | :--------------: | ------------------------------------------------------------------ | | `transaction_id` | String, required | The previously used transaction id from the `/authorize` endpoint. | | `factor_id` | String, required | The factor id from the `/authorize/mfa/factors` endpoint. | | `passcode` | String, required | The current TOTP passcode. | | `_csrf` | String, required | The csrf parsed from response of `/authorize` | ```json { "transaction_id": "transaction_id", "factor_id": "factor_id", "passcode": "passcode", "_csrf": "csrf" } ``` This will validate the current `transaction_id` and allow for the previous request to POST successfully with the `transaction_id` as a form body parameter. ## Making requests Requests are made using the `access_token` provided with the response. It is treated as an [OAuth 2.0 Bearer Token](https://oauth.net/2/bearer-tokens/) and expires every eight hours. This token is passed along in an Authorization header with all future requests: ```http Authorization: Bearer {access_token} ``` ## Refreshing an access token #### POST `https://auth.tesla.com/oauth2/v3/token` This uses the SSO `refresh_token` from Step 3 above to do an [OAuth 2.0 Refresh Token Grant](https://oauth.net/2/grant-types/refresh-token/). The refreshed access token is to be used directly with the Owner API as a bearer token as per the above *Making requests* section. This endpoint uses JSON for the request and response bodies. **Request parameters** | Field | Type | Example | Description | | --------------- | ---------------- | ----------------------------- | --------------------------------------------------------------- | | `grant_type` | String, required | `refresh_token` | The type of OAuth grant. Always "refresh\_token" | | `client_id` | String, required | `ownerapi` | The OAuth client ID. Always "ownerapi" | | `refresh_token` | String, required | `123` | The refresh token from a prior authentication. | | `scope` | String, required | `openid email offline_access` | The authentication scope. Always "openid email offline\_access" | ```json { "grant_type": "refresh_token", "client_id": "ownerapi", "refresh_token": "eyJrefresh", "scope": "openid email offline_access" } ``` **Response** ```json { "access_token": "eyJaccess", "refresh_token": "eyJrefresh", "id_token": "id", "expires_in": 300, "token_type": "Bearer" } ``` # Users Endpoints for getting information about the current user These endpoints provide data on the current user. ## GET `/api/1/users/me` Get the current user's information. ### Response ```json { "email": "elon@tesla.com", "full_name": "Elon Musk", "profile_image_url": "https://vehicle-files.prd.euw1.vn.cloud.tesla.com/profile_images/{IMG}.jpg" } ``` ## GET `/api/1/users/vault_profile` {% hint style="info" %} This endpoint is a mystery and it's current purpose is unknown, but we know how to decode it. First of all take the `base64_data` and decode it. Finally, deserialize the message using the `Vault` message from protobuf located at {% endhint %} ### Response ```json { "vault": "base64_data" } ``` ## GET `/api/1/users/feature_config` Get the feature configuration for the mobile app. ### Response ```json { "signaling": { "enabled": true, "subscribe_connectivity": false } } ``` ## POST `/api/1/users/keys` Update the name of a (bluetooth) key in all vehicles linked to the account. Refreshed inside the vehicle everytime the "Locks" menu is opened. `kind` and `public_key` must be set, everything else only needs to be set if you want to change it. ### Parameters | Parameter | Example | Description | | ----------- | -------------- | --------------------------------------------------------------------------------------------------------------- | | kind | mobile\_device | Must be "mobile\_device" | | public\_key | 04ed05567b... | The ANSI X9.62/X9.63 representation of the public key that you wish to change (65 bytes long) - as a hex string | | name | Sam's Phone | The name of the key (main text) | | model | iPhone 14 Pro | The model of the key (sub text) | ### Response ```json { "response": true } ``` # Vehicles Endpoints for getting an account's vehicles A logged in user can have multiple vehicles under their account (congrats on being rich!). This resource is primarily responsible for listing the vehicles and the basic details about them. #### `vehicle_id` vs `id` One potentially confusing part of Tesla's API is the switching use of the `id` and `vehicle_id` of the car. The `id` field is an identifier for the car on the owner-api endpoint. The `vehicle_id` field is for identifying the car across different endpoints, such as the streaming or Autopark APIs. For the state and command APIs, you should be using the `id` field. If your JSON parser doesn't support large numbers (>32 bit), then you can use the `id_s` field for a string version of the ID. ## GET `/api/1/vehicles?page={page}` Retrieve a list of your owned vehicles. The list is limited to a maximum of 100 entries. Use the `page` GET parameter to iterate over the response page and use the response `count` variable to determine if another request should be made. ### Request parameters | Field | Example | Description | Required | Default | | ------ | ------- | --------------- | -------- | ------- | | `page` | `1` | The page number | no | 1 | ### Response ```json { "response": [ { "id": 12345678901234567, "vehicle_id": 1234567890, "vin": "5YJSA11111111111", "display_name": "Nikola 2.0", "color": null, "tokens": ["abcdef1234567890", "1234567890abcdef"], "state": "online", "in_service": false, "id_s": "12345678901234567", "calendar_enabled": true, "api_version": 7, "backseat_token": null, "backseat_token_updated_at": null } ], "count": 1 } ``` ## GET `/api/1/vehicles/{id}` These resources are read-only and determine the state of the vehicle's various sub-systems. ### URL parameters | Field | Example | Description | | ----- | ------------------- | -------------------------------------------- | | `id` | `12345678901234567` | The `id` of the car. (Not the `vehicle_id`!) | ### Response ```json { "response": { "id": 12345678901234567, "vehicle_id": 1234567890, "vin": "5YJSA11111111111", "display_name": "Nikola 2.0", "color": null, "tokens": ["abcdef1234567890", "1234567890abcdef"], "state": "online", "in_service": false, "id_s": "12345678901234567", "calendar_enabled": true, "api_version": 7, "backseat_token": null, "backseat_token_updated_at": null } } ``` # Energy Products Endpoints for getting an account's energy products A logged in user may have multiple Tesla Energy products (Powerwalls, Solar installations, etc.) under their account (congrats on being rich!). ## GET `/api/1/products` Retrieve a list of your Tesla Energy products. The value of `energy_site_id` is used as `site_id` in the various energy product endpoints. ### Request parameters ### Response ```json { "response": [ { "energy_site_id": 2252147638651575, "resource_type": "solar", "id": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "asset_site_id": "47d04752-9cf1-4e76-88fb-08839a1c41c4", "solar_power": 2320, "solar_type": "pv_panel", "sync_grid_alert_enabled": false, "breaker_alert_enabled": false, "components": { "battery": false, "solar": true, "solar_type": "pv_panel", "grid": true, "load_meter": false, "market_type": "residential" } } ], "count": 1 } ``` # Trip Planner Endpoints for Trip Planner Plans a route based on the vehicle specifications and charge state. Trips that require charging will set waypoints based on Tesla Supercharger locations along the route. * [Share trip to car](/vehicle/commands/sharing) ## POST `trip-planner/api/v1/tripplan` Request a trip plan based on the car model, origin, destination and remaining charge. ### Request body parameters | Field | Example | Description | | ------------- | ----------------------- | ------------------------------------------------------------------------- | | `car_trim` | `74D` | Car Model Variant | | `car_type` | `ModelY` | Car model | | `destination` | `37.485767,-122.240207` | Destination Latitude and Longitude, separated by comma | | `origin` | `37.79307,-125.108` | Origin Latitude and Longitude, separated by comma | | `origin_soe` | `0.64` | State of energy (charging) on the origin. Values goes from `0.0` to `1.0` | | `vin` | `5YJSA11111111111` | Car VIN | ### Request body ```json { "car_trim": "74D", "car_type": "ModelY", "destination": "37.485767,-122.340207", "origin": "37.79307,-125.108", "origin_soe": 0.64, "vin": "5YJSA11111111111" } ``` ### Reponse ```json { "destination_soe": 0.064, "origin_soe": 0.65, "polylines": [ "usccFlbhhV~HD?aEAkLbQjOjV|Sbp@pn@|MrSoB`Ac@aCrP_KzFiF|FcInEaNpF}Y|IkPhNwKfJeKtCeHhPae@jNqQdUwg@jTg_@tEwKdByKJmNkCeXa@cO`B_PlJ_d@xFsWhGgJ`J}Glj@oLta@{O~N_GnJuHz]gc@bf@{l@d`Aku@tWgU`TcZpSwYfRk\\hNqc@dIa_@bx@ezBfNcb@rEyWnUqaAhRafBbH}r@P_v@UieBYo_AqGyf@uOgw@qEaZ@mXlAocAZgy@zBc[xK{Z~r@yiB~CiPn@gOZceA`Dka@lMsu@lBga@sDcf@yEkk@o@{XxJuZdLwVb_@mw@hZ{n@n^wi@~a@ik@nt@_v@viAw{Btl@a`Ax_@ii@dZyVv[e^|b@ch@jUiR|Q}OnPaUnSgWrYsXbaAe_Atj@kf@dkAil@v`@_Sl\\eTvcAkuAlQgQpj@iX~zBecA~pBgq@niBao@deA{c@rR_Gt@sAo@_CaEcOqF{OiPwm@cd@{_BmFqVnByH`SwR~[iSnw@af@f`@mThJcEdDwGtWwY~e@gi@l_@}^xVeYvZoeAjLasAWsTsH_MaLwWoCmMKkQiEiMw@aJ`AwGvMuZlHmPdJgKdF}CzP{DtRoM`OgJ~DqLIsPkBiOnAoLtQwv@`GaNfViYxOqTpDwPFgK{AsIaEmHwQa_@cPkn@{GaJmIqBik@sE{JrCw[`NyKnAmJqAwf@w]{HeHmRiXk`@eb@yWyt@wMks@iIku@mDaLeLcP_QsUuSgYgHsGcJuBeKcAoIwDoQ{OwHwV_FiZqMkm@wGqm@hAcWiBwR}CaFgKqG}PeLkJeP}CyMPsTxD}^|DgTiBqUpCkYWqNsDyHqS_NgTeYyDeVqEmP{V{i@ob@alAcHyZ}Fy`@kFiZwDwFeK}EkWgJ{FcEyFgQq@sb@qGeP{ZeZuEkIsAcQTy^aC}PwIyg@IqNrByc@yD{XyJcOmPwMyWaTiFaLgKy^{V{|@sIg]f@oMjG{OhGqMrKuG~ZyJvYsQnIoHpGuLhKsTnHmb@~Lc`AfvAktCdo@mqAlKeZjI}cAVegB@y_A?{x@TyyCf@cn@lFmTnDoIvU}Uz`@w_@rs@ar@|iAmgAlvAqsA|m@gl@t|@_v@pcAa{@faA{x@|[k]h|A_qBpfBq}Bt`@ug@v^q`@d~@o`Azk@qn@``Asw@vy@mq@`kAws@~~AaaAjmA}t@d_CmwAhwEwsCdhLwbH|jBenAjnDueC|hFgrDpHaDhGX`BLpDxJuEvBq@wDOm@", "ucs~Ebwf_VQOMJBLZbAd@dAZpAj@WnAk@xAs@u@oCyAuFJKFIDINc@|@cD|@cDp@qBt@gApAoAr@k@DUlAy@n@e@jAw@hFuD|TyOnYiS`H}ErEoDvGmGjD_EfCeDzOiUxb@mn@dj@gx@xsAqoBfsAqnBtaEs`GhgCgsDxReYzKuOvEwFfGoGnNqNd\\o\\|b@gc@|_Ai`AlJqIfI_HrSyPzSaQxVaTxKoJfLsKfPmOhg@qe@vTySzrA}nAjaAqz@tj@af@`|@wu@bi@ud@vX}Uru@ap@rr@cm@jj@ue@nYyVvSmQne@qa@pm@wh@raEulDxb@__@pIiHjMcKfs@wj@`d@}]dO}LfM}Ktc@o`@fKgJdHgG|E{DxDmCxHoEj`@_TbSwKvWoNdsBmhAlw@ub@jr@g_@tfBk`A~|@}e@v_CcpAxmAop@xh@kYbFcDhGaFfMeLjW}TrvAkoAz_BqwAbjBy`BdmBscBxxAcqAzhAmbA~GcHdG{HjE{GbFmJ`GiLpSea@dKiSls@_vAj\\uo@`\\eo@z[ao@n\\it@l\\st@`[ar@lMsXrNqWt`@ms@da@ct@jP{YjNuV`M_UrKkRtEyGxCuD|CiDvG}G`IkIhQuQhQyQfb@gc@dd@ae@`fAwgAhfAahAv|Cs`Db`D{cDtqAosAre@qf@zS_TfVgUfk@{h@zf@wd@v|@qy@tt@yq@bMuKfRuNfPaMlr@_i@hWeRl\\gUlL}HfQuLjqAs|@xdBakAlCkBnEwDjDwC~BaBdi@i^bUoOtLeIjMkI~QiMtT_O`NkJfToNnHgF~Q}LbCaBfFoD~DsB^Un@e@dDuBtFyDfUwOfHyEfKcH`XuQzz@qk@dZkSv`@cXrbAkq@|{DskCnoBwrA|RqMfp@}c@je@o[|s@if@~rBguAlo@}b@`WyPfJaHhFoEfG{FxXwW~JoJdk@ki@tk@}i@`_Ai|@lIcInJ}JzT{VxxAw`BzcAajAhxFinGxTuVjIqJvHiKnSc[xTa]rQwXtr@efAbfEeqGttCwlEtxAoyBrr@keAvt@ciAb}@cuAhQmXnUq^zt@akA`qBa`D~sAyvB`hA}eBja@io@nP{V`QiVhh@ct@lPoUbHoJpG}HlIoJj]k_@ls@{v@vg@kj@xiDytD`cBqiBbjAynAdnCgwCba@_e@vaAyhAtv@u|@~a@se@nXk[dgBkrBpk@ep@jRmTfk@_p@zlAguAp~@{dA~e@_j@rHkIn@s@f@i@LML?@?r@o@zBqBj@c@t@[`ASvBAH??t@?j@GrB?tE", "_oeuErequUpAoNpD{LnS{UtkAaqAf~AydBtzAk`BrzA{sAlkAcyAli@{Ypw@kWthCkj@fwDcy@xq@aOpp@gKvf@_@lUwJjLBfJgDrHqIxLkD|Y_A~OmGhRlAlZOda@kF`YuLb]__@xIu[lVcn@dRmNhTaNz`@}i@~|@m}@rj@}a@|kBsmAdRSpZjV|q@vs@xr@vr@vMrDhO[zOkHtMqOv_@ie@xSw^rF_w@nLeiBnCo`@rLe[fg@oy@hj@agAxSq_@hi@wh@dp@kYnhA{AphBbQvc@xBza@mAtl@yDtaAu[|i@uQro@s]d|@an@~PwVxEkUpIsVdQeOp]aYlReWjQkGfWUnj@eOzg@gVz\\gu@rE_o@bPs[pVwUrUu[vk@yXvT{J`UqCvs@uEx_@~Bjb@q@b[{F|TeW`c@we@jLsQ`K}^|N}Wzb@qTnq@s`A|f@e~@pe@ycA|v@gr@vd@{HbXwHjh@u]~t@gg@|VkOjUkCdVkHbSaNrh@c^rXuPxPgE~XTri@~H|Xt@jUiFpp@rB`TiFnOeKzVsUjRwc@bTqe@lQiUp]{b@fa@gTvvAki@n~@}Z~zAsXnb@mM|o@m]zc@uXn`@yPvYyK`\\o^jXsy@jPuc@xGuG`PcYhGej@nRwh@`OeXnLqKb`@_O|PoN|b@e{@hp@ef@n_C{zBp_@ek@vc@mZxhA}dA~t@oi@tt@{w@fxAm}AtUw_@tCe\\hDc`@bH{YfO{e@Ssj@rDya@jSa]lE}~@dO_Wnm@er@fZaYp`@qUjWsR|W}g@za@ml@~Sga@lZqXxUg`@dUmIzUoQdUs]~SsY``@qSpQkPdKoTq@s]uLmz@sGm}@B}aB~AuMfKsUtU}]tY_}@fEoj@k@qr@uOcs@DiUrGoSrZwz@lDmY{@qT}Sys@yIcd@cOm`@}Mm_@m@ma@@_`AsCyvFpDe[nNcV|G_XIo^oDi`AWuzBp@o{@tDwn@xi@ytA~RgWdKcf@XqkBMe~BtCm|@lNyv@lRut@Dob@eHee@BwQfKc`@|Jw_@vYmZrJmYuAid@XqsChB}q@jMo`@jEiZoB_x@aBwu@oMad@kBco@fC{n@jBwaCH_bCJ_dBj@ey@oEuq@|A{kEaByvAyX_j@_b@gp@cOwXmG}W}Aes@a@_lDUssCi@isCkHaeDx@wzLK_mM|ByfFyAe`C`Hyn@Fcs@d@s`AsDce@iYud@iXeXgHkQiBmUCiq@l@_fBnDaiCxL}~Af]miAh`@qsAjAe`BrKwj@iQgs@mEqPcFmFsBgAgApFVtH", "wbjoEjnhjULwHxADvErBbGbOjIpf@lErFnIZrLoInTsDjWDj]_D|YiD`U?tv@~E~fAtAr{Aj@xRlAdFw@jImElFeHbHiXnByODw`@V{m@hIy^|Tek@vM_Vjf@i]zU_I|WeLhIgJ|EuJrNye@~Kei@fQck@tIgWvEkh@`IuX|G_g@`GmXdPqZnMgVtK{W~AePDkVfLi`AbHga@zHuMlHgGhWmLpj@yVxr@sb@pj@aX`RsHvNkKjH{J~IgUnLuRpM_PrQ{`@~Te[naA{`BlTy\\rVyVhg@ca@~Xcb@dPi`@xKuMbI{NdC}OJyT_Ams@nAi{BdDqcCrDw_ArDaf@FmyACgoBo@qgBkGag@mIs`@_Lgy@{Fc`@oCgb@n@a[jEsV`[se@zPwV`KcXhLwg@b@w~@?{{@Ae^aCki@iHehAcBqm@wEyY_Ku^yAmLPoKnDq_@fNcxAfAmSiAk]_Mip@eEk[dD_a@jE_c@r@y`@e@am@pCkiAGa^sB}VyB}UqAic@hBkWzFmWrOec@fNweAhOooAvJwx@~WezBxS}jBp@cfAzPu|@fJw]bMqXzM}WhRaVdn@qv@fg@mn@x_@se@jRyUtQqYj_@yu@p[go@x`AgnBjqBm`Epn@koA`j@ky@bf@a|@`Qic@f\\{i@nkA}_CffA_wBn_A{mBdI{XfKug@nP}aAbIsWbJ_d@p`@_wAvIkl@zRkZb_@k{@vIiYbDwXQec@oDm\\hBw~@zAyb@tCmVlD{IxKwMhYwXtZuc@xr@mt@dGgMbEsQhAc|@j@}_AdIkc@jSsbAhh@adCvMceAlI_v@bGct@kEyt@wDqi@eAg]j@c\\vDm`A|Je_@t]g|@hPo~@pj@ytD~Jku@nEm\\bBe^cCyuAS{`@bD}_@|MgvAdJa`A`Um_CpRwpB`RitBnMqyEdLyeE|BwhAF}cADu_CNa_EJo|Au@sz@aGyy@_OqbBsKmqA{KcpDsSsxG}HkgCsAw^uEmb@wJgs@i`@orCi^wiCgv@_tF_WyiBkIo}@yi@g}DeLsy@w@gp@a@eaBIsqA~O_gCt]glFzGmcAxNcx@zl@k{CfmGwp[l\\{cBzRmmAlZmiB~IaT`PiU~Iq[hOa_Ab\\sqBl_@etBdVemAti@iwC~BcUn@m]@saBD_fCBw|AwIq~ByCwpCyF}mFe@eoESa}Dz@m]~Co[OwgB}@gfCh@wcAvG}`@fDua@By]BybALeuEN}xEeBokCeAusEqAsjCbBaa@nTixAbEsZjBsNbBuFp@jBiAvDm@|D", "i|alEpo~yTQKrAsEj@wANgBIuAFKF[E_@UWa@GE?a@k@QoBScFGkDKcGKyDKQE{ACq@Q}EYmFs@mJqAoLcAaHeBqJ_GwZsJ_g@qMkq@sV{pA{Oyy@_Iga@{UenAcIib@oFsX{BwLoF{XaFoWkHe`@kBiLkAkIeCeS}H_p@kG_h@qAaJm@}Cu@}CcB}FwB{FyAcDaCmEoDqFkDgEiDkDuCcCkCoBsH}FuCyCgB}BaBiCmCqFuL{YuAyDgAcE{@kEg@oDe@eGMwEWy]MaPMe[HkIZ}JhA}WtDs}@j@qPHqF?wHIqJ_@}Kk@oJeC_\\{BmZgH}~@eOapBgb@_vFa_@s_FuFgu@_Ck[gBiZyEq{@aFy}@iHarA_BkW}BkWaMipAaMgpAaE_b@iDa`@wAwRyA_U_BgZkAiZgAw`@e@c[UaZC{_@Tu_@h@y]lAec@|A_c@p@wMhAyL|A{KpBeK~BkJpDgLjDuInBeEzD{HnL_UbGkLtDwHhC{F~BmGnCeIvBwH|AuGnAeGvAeIfB_Nn@wGd@aHj@eJpB_]`Fcz@rMayBzEuv@`AePjBq\\vCgf@dB{YbAuPlJy}A~Emy@fGmcAfKkdBpa@e}GdUwuD~F}`AzB{[~BeZzNsjB~G{{@~Fiu@|OsqBzAcRpBoWlDwc@fK{qAxVs_DvbAufMrK_tAdVqzCzl@uqHp_@oxEvDud@fJojAzAuSnBsTbI{bAdN_dBfO_jBnWgbDfl@sjHxIyfAjFmo@jc@}nFfb@agFnKiqAr]}gElb@mgF~M_aBtA_OzA_NxDuYfNebA~RmwAp]{eCfFw^rEw]hCwV`BiQdDq]`Jq`AfKqgA``@kbEnv@gfIfVygC~U{eC`CaSbEg[xQosA~`@mwCzG}f@hJuq@bVifBfS{yAvDyXhHmh@lVygBze@slDvr@}eFfiB}wMfa@awCnGae@fBeMtAeI|CiOzGi\\|AiK`AqHhBiShDya@`BkMhDoVzCcUf@}Er@eJn@kNP_K@{KUeN[yHa@sGkAeMiB_N}AuIaC{KoFeViHuZcFcTyCyM}@kEaEsRsCyMqBsIgEmRaEuQ_Pus@yGgZy@cEEi@@OQ_Ai@}C_@wCc@cEq@aGCYFa@NSTI~@ApACdAG", "yvbkExu~mTr@AlAOJOFI@E?EeCCi@@k@G{BQ}@EQC[WGa@Ko@YgAe@{Aw@mBoC_HuBiG{@{CAAMAUeAu@eDm@qC}@}DcD{NwOyr@aLsg@wO}r@_H}ZgPmt@_CmKeA}E_A_FQkAQeA]{Cc@sDU_Cc@wEm@{JSmFIwCKuIAmR@ie@BycBA_ICqED}EJiFFgBVeF~@uLd@eGXiFLeG?oYAi\\?ad@DcT?iD@iD?_E?kUK_PQqNWiQ]aYIiK?yJJwNLiHXuLh@kSN}IH{ID{JBc[BmWFop@BuN?uEFaFFoCRsDZ_ETuB\\gCf@yCfGkZvAmHXeBd@oDd@sEJ_BLcCL{CDkFHwg@LwcAHis@BiXJkp@Dke@@oNAeBI}EMkDYoFWcDa@{DeB}PaAuJsAoMkEcc@mA{LYwDSeEQeHCkIIoX?cAI]A{ECsHCqEGqQMyZOi_@GmGOkJa@aTk@eZQeJMsMGiH?kA@cPB{KD_SFkZBiLCmIKcPEoGAsPEmLGqHE_NGuMU{OGmOIq\\Ga`@EqXCcKA{CEaEEqGCeMCuREoPAyNBmIFiGB_HJom@Hqk@@yKBsFFkED_BHaC^{O|@ab@JmHPiHTaLLyM@iIAaECsEMmKKoESqDWaDe@sEk@aF]wDUoDGiBEiC@mEJqETsDv@kIZkDVcETqFFwBFkF@yEFuQDsQ@aBAkCBaE@eCAq@?uBBuDDaODqKHsWBkNCgMDu@?uB?uEAgJAwMCaFLyHPkE`@_IlAkUNgE?yDKuEOaC}@cIUcCIqAKaCCgG?uGAwFEaBQgDw@yHg@wEE]LS@CBmBHuBLgBn@uGh@eFJ]PULCf@EzHD|CATKd@AvC?nEA~EC|D?pBAzCG|C@tDEvGChBAVLdEB^??rECtJ?bCBvHB`I?bJAp@" ], "status": "TRIP_PLAN_SUCCESS_WITH_STOPS", "stops": [ { "addr": "W Panoche Rd, Firebaugh", "arrival_soe": 0.123, "charge_dur_s": 1180.79, "charge_kWh": 52.013, "id": "2768", "location": { "lat": 36.639154, "lng": -120.625877 }, "name": "Firebaugh, CA", "trt_id": "11676" }, { "addr": "Copus Rd, Bakersfield", "arrival_soe": 0.108, "charge_dur_s": 1351.903, "charge_kWh": 55.878, "id": "4506", "location": { "lat": 35.094359, "lng": -119.040751 }, "name": "Bakersfield, CA – Copus Road (No Amenities)", "trt_id": "16818" }, { "addr": "Highland Ave, Highland", "arrival_soe": 0.112, "charge_dur_s": 1506.139, "charge_kWh": 58.946, "id": "2898", "location": { "lat": 34.135162, "lng": -117.195175 }, "name": "Highland, CA", "trt_id": "12324" }, { "addr": "Frontage Rd, Ehrenberg", "arrival_soe": 0.12, "charge_dur_s": 960.943, "charge_kWh": 46.249, "id": "1888", "location": { "lat": 33.601995, "lng": -114.522011 }, "name": "Ehrenberg, AZ", "trt_id": "5637" }, { "addr": "S Watson Rd, Buckeye", "arrival_soe": 0.098, "charge_dur_s": 300, "charge_kWh": 14.564, "id": "55", "location": { "lat": 33.443011, "lng": -112.556876 }, "name": "Buckeye, AZ", "trt_id": "2145" } ], "total_charge_dur_s": 5299.774, "total_charge_kWh": 227.65, "total_drive_dur_s": 40274.0, "total_drive_kWh": 229.461, "total_drive_mi": 729.106 } ``` # State These endpoints give the state of the various subsystems of the car. {% content-ref url="/pages/-LNhj\_dO18U\_siIuG8U8" %} [Data](/vehicle/state/data) {% endcontent-ref %} {% hint style="warning" %} All `data_request` endpoints have been deprecated in favor of the `vehicle_data` endpoint. All of the data they return is found in the response of `vehicle_data` within sub-categories and the documentation of these/what the different fields mean, still applies. {% endhint %} A rollup of all the `data_request` endpoints plus vehicle configuration. {% content-ref url="/pages/-LNhjgd9T\_FAlYIPJsCO" %} [Charge State](/vehicle/state/chargestate) {% endcontent-ref %} Information on the state of charge in the battery and its various settings. {% content-ref url="/pages/-LNhjgdAeslnbBfiiB0Z" %} [Climate State](/vehicle/state/climatestate) {% endcontent-ref %} Information on the current internal temperature and climate control system. {% content-ref url="/pages/-LNhjgdBPbSy\_GKwQjTt" %} [Drive State](/vehicle/state/drivestate) {% endcontent-ref %} Returns the driving and position state of the vehicle. {% content-ref url="/pages/-LNhjgdCr86GiVWzHQK6" %} [GUI Settings](/vehicle/state/guisettings) {% endcontent-ref %} Returns various information about the GUI settings of the car, such as unit format and range display. {% content-ref url="/pages/-LNhjgdD6Aix5oaux0IF" %} [Vehicle State](/vehicle/state/vehiclestate) {% endcontent-ref %} Returns the vehicle's physical state, such as which doors are open. {% content-ref url="/pages/-LU26Abcj7JXdGhMI5pA" %} [Vehicle Config](/vehicle/state/vehicleconfig) {% endcontent-ref %} Returns the vehicle's configuration information including model, color, badging and wheels. {% content-ref url="/pages/-LNhjgdECOj2UhFRSxTS" %} [Mobile Enabled](/vehicle/state/mobileenabled) {% endcontent-ref %} Lets you know if the Mobile Access setting is enabled in the car. {% content-ref url="/pages/-LTQIo\_wwoX1xxjQgorq" %} [Nearby Charging Sites](/vehicle/state/nearbychargingsites) {% endcontent-ref %} Returns a list of nearby Tesla-operated charging stations. {% content-ref url="/pages/7rmYQ1xTipG6FEP3gjFT" %} [Miscellaneous](/vehicle/state/misc) {% endcontent-ref %} Other miscellaneous data # Data ## GET `/api/1/vehicles/{id}/vehicle_data` A rollup of all the `data_request` endpoints plus vehicle configuration. *Note:* all `*_range` values are in miles, irrespective of GUI configuration. ### Response ```json { "response": { "id": 12345678901234567, "user_id": 123, "vehicle_id": 1234567890, "vin": "5YJSA11111111111", "display_name": "Nikola 2.0", "color": null, "access_type": "OWNER", "tokens": ["abcdef1234567890", "1234567890abcdef"], "state": "online", "in_service": false, "id_s": "12345678901234567", "calendar_enabled": true, "api_version": 13, "backseat_token": null, "backseat_token_updated_at": null, "drive_state": { "gps_as_of": 1607623884, "heading": 5, "latitude": 33.111111, "longitude": -88.111111, "native_latitude": 33.111111, "native_location_supported": 1, "native_longitude": -88.111111, "native_type": "wgs", "power": -9, "shift_state": null, "speed": null, "timestamp": 1607623897515 }, "climate_state": { "battery_heater": false, "battery_heater_no_power": false, "bioweapon_mode": false, "climate_keeper_mode": "off", "defrost_mode": 0, "driver_temp_setting": 21.1, "fan_status": 0, "inside_temp": 22.1, "is_auto_conditioning_on": false, "is_climate_on": false, "is_front_defroster_on": false, "is_preconditioning": false, "is_rear_defroster_on": false, "left_temp_direction": -66, "max_avail_temp": 28.0, "min_avail_temp": 15.0, "outside_temp": 18.0, "passenger_temp_setting": 21.1, "remote_heater_control_enabled": false, "right_temp_direction": -66, "seat_heater_left": 0, "seat_heater_right": 0, "side_mirror_heaters": false, "timestamp": 1607623897515, "wiper_blade_heater": false }, "charge_state": { "battery_heater_on": false, "battery_level": 59, "battery_range": 149.92, "charge_current_request": 40, "charge_current_request_max": 40, "charge_enable_request": true, "charge_energy_added": 2.42, "charge_limit_soc": 90, "charge_limit_soc_max": 100, "charge_limit_soc_min": 50, "charge_limit_soc_std": 90, "charge_miles_added_ideal": 10.0, "charge_miles_added_rated": 8.0, "charge_port_cold_weather_mode": null, "charge_port_door_open": true, "charge_port_latch": "Engaged", "charge_rate": 28.0, "charge_to_max_range": false, "charger_actual_current": 40, "charger_phases": 1, "charger_pilot_current": 40, "charger_power": 9, "charger_voltage": 243, "charging_state": "Charging", "conn_charge_cable": "SAE", "est_battery_range": 132.98, "fast_charger_brand": "", "fast_charger_present": false, "fast_charger_type": "", "ideal_battery_range": 187.4, "managed_charging_active": false, "managed_charging_start_time": null, "managed_charging_user_canceled": false, "max_range_charge_counter": 0, "minutes_to_full_charge": 165, "not_enough_power_to_heat": false, "scheduled_charging_pending": false, "scheduled_charging_start_time": null, "time_to_full_charge": 2.75, "timestamp": 1607623897515, "trip_charging": false, "usable_battery_level": 59, "user_charge_enable_request": null }, "gui_settings": { "gui_24_hour_time": false, "gui_charge_rate_units": "mi/hr", "gui_distance_units": "mi/hr", "gui_range_display": "Rated", "gui_temperature_units": "F", "show_range_units": true, "timestamp": 1607623897515 }, "vehicle_state": { "api_version": 13, "autopark_state_v2": "standby", "autopark_style": "standard", "calendar_supported": true, "car_version": "2020.48.10 f8900cddd03a", "center_display_state": 0, "df": 0, "dr": 0, "fd_window": 0, "fp_window": 0, "ft": 0, "homelink_device_count": 2, "homelink_nearby": true, "is_user_present": false, "last_autopark_error": "no_error", "locked": false, "media_state": { "remote_control_enabled": true }, "notifications_supported": true, "odometer": 57869.762487, "parsed_calendar_supported": true, "pf": 0, "pr": 0, "rd_window": 0, "remote_start": false, "remote_start_enabled": true, "remote_start_supported": true, "rp_window": 0, "rt": 0, "sentry_mode": false, "sentry_mode_available": true, "smart_summon_available": true, "software_update": { "download_perc": 0, "expected_duration_sec": 2700, "install_perc": 1, "status": "", "version": "" }, "speed_limit_mode": { "active": false, "current_limit_mph": 85.0, "max_limit_mph": 90, "min_limit_mph": 50, "pin_code_set": false }, "summon_standby_mode_enabled": false, "sun_roof_percent_open": 0, "sun_roof_state": "closed", "timestamp": 1607623897515, "valet_mode": false, "valet_pin_needed": true, "vehicle_name": null }, "vehicle_config": { "can_accept_navigation_requests": true, "can_actuate_trunks": true, "car_special_type": "base", "car_type": "models2", "charge_port_type": "US", "default_charge_to_max": false, "ece_restrictions": false, "eu_vehicle": false, "exterior_color": "White", "has_air_suspension": true, "has_ludicrous_mode": false, "motorized_charge_port": true, "plg": true, "rear_seat_heaters": 0, "rear_seat_type": 0, "rhd": false, "roof_color": "None", "seat_type": 2, "spoiler_type": "None", "sun_roof_installed": 2, "third_row_seats": "None", "timestamp": 1607623897515, "trim_badging": "p90d", "use_range_badging": false, "wheel_type": "AeroTurbine19" } } } ``` ## GET `/api/1/vehicles/{id}/data` A "legacy" version of the data endpoint. ### Response Currently, this has the exact same response structure as the newer vehicle\_data endpoint. ## GET `/api/1/vehicles/{id}/latest_vehicle_data` {% hint style="warning" %} This endpoint was deprecated in favor of the `vehicle_data` endpoint and returns 404. {% endhint %} This is cached data, pushed by the vehicle on sleep, wake and around OTAs. ### Response ```json { "response": { "version": 9, "pb_data": "Appears to be Base64 encoded protobuf data (malformed b64 string)", "data": { "charge_state": { "battery_heater_on": false, "battery_level": 0, "battery_range": 0.0, "charge_current_request": 0, "charge_current_request_max": 0, "charge_enable_request": false, "charge_energy_added": 0.0, "charge_limit_soc": 0, "charge_limit_soc_max": 0, "charge_limit_soc_min": 0, "charge_limit_soc_std": 0, "charge_miles_added_ideal": 0.0, "charge_miles_added_rated": 0.0, "charge_port_cold_weather_mode": false, "charge_port_color": "Off", "charge_port_door_open": false, "charge_port_latch": "Blocking", "charge_rate": 0, "charge_to_max_range": false, "charger_actual_current": 0, "charger_phases": 0, "charger_pilot_current": 0, "charger_power": 0, "charger_voltage": 0, "charge_amps": 0, "charging_state": "Disconnected", "conn_charge_cable": "IEC", "est_battery_range": 0.0, "fast_charger_brand": "SNA", "fast_charger_present": false, "fast_charger_type": "Supercharger", "ideal_battery_range": 0.0, "managed_charging_active": false, "managed_charging_start_time": 0, "managed_charging_user_canceled": false, "max_range_charge_counter": 0, "minutes_to_full_charge": 0, "time_to_full_charge": 0.0, "not_enough_power_to_heat": false, "off_peak_charging_enabled": false, "off_peak_charging_times": "all_week", "off_peak_hours_end_time": 0, "preconditioning_enabled": false, "preconditioning_times": "all_week", "scheduled_charging_mode": "Off", "scheduled_charging_pending": false, "scheduled_charging_start_time": 0, "scheduled_charging_start_time_app": 0, "scheduled_charging_start_time_minutes": 0, "scheduled_departure_time": 1656223200000, "scheduled_departure_time_minutes": 0, "supercharger_session_trip_planner": false, "timestamp": 1665664828457, "trip_charging": false, "usable_battery_level": 0, "user_charge_enable_request": false }, "climate_state": { "allow_cabin_overheat_protection": false, "auto_seat_climate_left": false, "auto_seat_climate_right": false, "battery_heater": false, "battery_heater_no_power": false, "bioweapon_mode": false, "cabin_overheat_protection": "Off", "cabin_overheat_protection_actively_cooling": false, "climate_keeper_mode": "unknown", "defrost_mode": 0, "driver_temp_setting": 0.0, "hvac_auto_request": "On", "fan_status": 0, "inside_temp": 0.0, "is_auto_conditioning_on": false, "is_climate_on": false, "is_front_defroster_on": false, "is_preconditioning": false, "is_rear_defroster_on": false, "left_temp_direction": 0, "max_avail_temp": 0.0, "min_avail_temp": 0.0, "outside_temp": 0.0, "passenger_temp_setting": 0.0, "remote_heater_control_enabled": false, "right_temp_direction": 0, "seat_fan_front_left": 0, "seat_fan_front_right": 0, "seat_heater_left": 0, "seat_heater_rear_center": 0, "seat_heater_rear_left": 0, "seat_heater_rear_left_back": 0, "seat_heater_rear_right": 0, "seat_heater_rear_right_back": 0, "seat_heater_right": 0, "seat_heater_third_row_left": 0, "seat_heater_third_row_right": 0, "side_mirror_heaters": false, "supports_fan_only_cabin_overheat_protection": false, "timestamp": 1665664828457, "wiper_blade_heater": false, "steering_wheel_heater": null }, "closures_state": { "timestamp": 1665664828458 }, "drive_state": { "power": 0, "speed": 0 }, "gui_settings": { "gui_24_hour_time": false, "gui_charge_rate_units": "km/hr", "gui_distance_units": "km/hr", "gui_range_display": "Ideal", "gui_temperature_units": "C", "show_range_units": false, "timestamp": 1665664828459 }, "vehicle_config": { "aux_park_lamps": "NaBase", "badge_version": 0, "bioweapon_mode_supported": false, "can_accept_navigation_requests": false, "can_actuate_trunks": false, "car_special_type": "base", "car_type": "modelx", "charge_port_type": "EU", "dashcam_clip_save_supported": false, "default_charge_to_max": false, "driver_assist": "ParkerPascal2_5", "ece_restrictions": false, "efficiency_package": "Default", "eu_vehicle": false, "exterior_color": "MetallicBlack", "front_drive_unit": "NoneOrSmall", "has_air_suspension": false, "has_ludicrous_mode": false, "pws": false, "headlamp_type": "Premium", "has_seat_cooling": false, "interior_trim_type": "AllBlack", "is_raven": false, "key_version": 0, "motorized_charge_port": false, "plg": false, "range_plus_badging": false, "rear_drive_unit": "Small", "rear_seat_heaters": 3, "rear_seat_type": 3, "rhd": false, "roof_color": "None", "seat_type": 0, "spoiler_type": "Passive", "sun_roof_installed": 0, "supports_qr_pairing": false, "third_row_seats": "FuturisFoldFlat", "timestamp": 1665664828459, "trim_badging": "plaid", "use_range_badging": false, "utc_offset": 0, "webcam_supported": false, "wheel_type": "Turbine22" }, "vehicle_state": { "homelink_device_count": 0, "tpms_pressure_fl": 0.0, "tpms_pressure_fr": 0.0, "tpms_pressure_rl": 0.0, "tpms_pressure_rr": 0.0, "webcam_available": false, "api_version": 0, "autopark_state_v2": "ready", "autopark_style": "dead_man", "calendar_supported": false, "center_display_state": 0, "dashcam_clip_save_available": false, "dashcam_state": "Unavailable", "df": false, "dr": false, "fd_window": false, "feature_bitmask": "1047039,0", "fp_window": false, "ft": false, "is_user_present": false, "locked": false, "media_state": { "remote_control_enabled": false }, "notifications_supported": false, "odometer": 0.0, "parsed_calendar_supported": false, "patsy_mode": false, "pf": false, "pr": false, "rd_window": false, "remote_start": false, "remote_start_enabled": false, "remote_start_supported": false, "rp_window": false, "rt": false, "sentry_mode": null, "sentry_mode_available": null, "service_mode": false, "service_mode_plus": false, "smart_summon_available": false, "software_update": { "download_perc": 0, "expected_duration_sec": 0, "install_perc": 0, "scheduled_time_ms": 0, "warning_time_remaining_ms": 0 }, "speed_limit_mode": { "active": false, "current_limit_mph": 0.0, "max_limit_mph": 0.0, "min_limit_mph": 0.0, "pin_code_set": false }, "summon_standby_mode_enabled": false, "sun_roof_percent_open": 0, "timestamp": 1665664828459, "valet_mode": false, "valet_pin_needed": false, "vehicle_self_test_progress": 0, "vehicle_self_test_requested": false }, "session_id": 0, "proto_json_version": 42, "id": 1234567890123456, "user_id": 123456, "vehicle_id": 1234567890, "vin": "7SAX..", "display_name": "Nikola", "color": null, "access_type": "OWNER", "tokens": ["12abcd3efgh4i5jk", "12a34bcd5678e900"], "state": "online", "in_service": false, "id_s": "1234567890123456", "calendar_enabled": true, "api_version": 48, "backseat_token": null, "backseat_token_updated_at": null }, "legacy": { "id": 1234567890123456, "user_id": 123456, "vehicle_id": 1234567890, "vin": "7SA..", "display_name": "Nikola", "color": null, "access_type": "OWNER", "tokens": ["12abcd3efgh4i5jk", "12a34bcd5678e900"], "state": "online", "in_service": false, "id_s": "1234567890123456", "calendar_enabled": true, "api_version": 48, "backseat_token": null, "backseat_token_updated_at": null, "charge_state": { "battery_heater_on": false, "battery_level": 75, "battery_range": 242.3, "charge_amps": 24, "charge_current_request": 24, "charge_current_request_max": 24, "charge_enable_request": true, "charge_energy_added": 20.86, "charge_limit_soc": 100, "charge_limit_soc_max": 100, "charge_limit_soc_min": 50, "charge_limit_soc_std": 90, "charge_miles_added_ideal": 60.0, "charge_miles_added_rated": 75.0, "charge_port_cold_weather_mode": null, "charge_port_color": "Off", "charge_port_door_open": false, "charge_port_latch": "Blocking", "charge_rate": 0.0, "charger_actual_current": 0, "charger_phases": null, "charger_pilot_current": 24, "charger_power": 0, "charger_voltage": 0, "charging_state": "Disconnected", "conn_charge_cable": "", "est_battery_range": 190.79, "fast_charger_brand": "", "fast_charger_present": false, "fast_charger_type": "", "ideal_battery_range": 194.06, "managed_charging_active": false, "managed_charging_start_time": null, "managed_charging_user_canceled": false, "max_range_charge_counter": 0, "minutes_to_full_charge": 0, "not_enough_power_to_heat": false, "off_peak_charging_enabled": false, "off_peak_charging_times": "all_week", "off_peak_hours_end_time": 360, "preconditioning_enabled": false, "preconditioning_times": "all_week", "scheduled_charging_mode": "Off", "scheduled_charging_pending": false, "scheduled_charging_start_time": null, "scheduled_departure_time": 1656223200, "scheduled_departure_time_minutes": 480, "supercharger_session_trip_planner": false, "time_to_full_charge": 0.0, "timestamp": 1665666097920, "trip_charging": false, "usable_battery_level": 75, "user_charge_enable_request": null }, "climate_state": { "allow_cabin_overheat_protection": false, "battery_heater": false, "battery_heater_no_power": false, "bioweapon_mode": false, "cabin_overheat_protection": "Off", "climate_keeper_mode": "off", "cop_activation_temperature": "High", "defrost_mode": 0, "driver_temp_setting": 20.0, "fan_status": 0, "hvac_auto_request": "Override", "inside_temp": 22.3, "is_auto_conditioning_on": false, "is_climate_on": false, "is_front_defroster_on": false, "is_preconditioning": false, "is_rear_defroster_on": false, "left_temp_direction": -240, "max_avail_temp": 28.0, "min_avail_temp": 15.0, "outside_temp": 14.0, "passenger_temp_setting": 20.0, "remote_heater_control_enabled": false, "right_temp_direction": -240, "seat_heater_left": 0, "seat_heater_rear_left": 0, "seat_heater_rear_right": 0, "seat_heater_right": 0, "seat_heater_third_row_left": 0, "seat_heater_third_row_right": 0, "side_mirror_heaters": false, "steering_wheel_heater": false, "supports_fan_only_cabin_overheat_protection": false, "timestamp": 1, "wiper_blade_heater": false }, "drive_state": { "active_route_latitude": 1, "active_route_longitude": 1, "active_route_traffic_minutes_delay": 0.0, "gps_as_of": 1, "heading": 212, "latitude": 1, "longitude": 1, "native_latitude": 1, "native_location_supported": 1, "native_longitude": 1, "native_type": "wgs", "power": 0, "shift_state": "P", "speed": null, "timestamp": 1665666097920 }, "gui_settings": { "gui_24_hour_time": true, "gui_charge_rate_units": "km/hr", "gui_distance_units": "km/hr", "gui_range_display": "Ideal", "gui_temperature_units": "C", "gui_tirepressure_units": "Bar", "show_range_units": true, "timestamp": 1665666097920 }, "vehicle_config": { "can_accept_navigation_requests": true, "can_actuate_trunks": true, "car_special_type": "base", "car_type": "modelx", "charge_port_type": "EU", "cop_user_set_temp_supported": false, "dashcam_clip_save_supported": true, "default_charge_to_max": false, "driver_assist": "ParkerPascal2_5", "ece_restrictions": true, "efficiency_package": "Default", "eu_vehicle": true, "exterior_color": "MetallicBlack", "exterior_trim_override": "Chrome", "front_drive_unit": "NoneOrSmall", "has_air_suspension": true, "has_ludicrous_mode": false, "has_seat_cooling": false, "headlamp_type": "Led", "interior_trim_type": "AllBlack", "motorized_charge_port": true, "paint_color_override": "14,14,14,0.9,0.01", "plg": true, "pws": false, "rear_drive_unit": "Small", "rear_seat_heaters": 3, "rear_seat_type": 3, "rhd": false, "roof_color": "None", "seat_type": 0, "spoiler_type": "Passive", "sun_roof_installed": 0, "supports_qr_pairing": false, "third_row_seats": "FuturisFoldFlat", "timestamp": 1665666097920, "trim_badging": "plaid", "use_range_badging": false, "utc_offset": 7200, "webcam_supported": false, "wheel_type": "Turbine22" }, "vehicle_state": { "allow_authorized_mobile_devices_only": false, "api_version": 48, "autopark_state_v2": "ready", "autopark_style": "dead_man", "calendar_supported": true, "car_version": "2022.36.2 7a23b0656de1", "center_display_state": 0, "dashcam_clip_save_available": true, "dashcam_state": "Recording", "df": 0, "dr": 0, "fd_window": 0, "feature_bitmask": "ff9ff,0", "fp_window": 0, "ft": 0, "homelink_device_count": 1, "homelink_nearby": false, "is_user_present": false, "last_autopark_error": "no_error", "locked": true, "media_info": { "a2dp_source_name": "iPhone", "audio_volume": 2.0, "audio_volume_increment": 0.333333, "audio_volume_max": 10.333333, "media_playback_status": "Stopped", "now_playing_album": "", "now_playing_artist": "", "now_playing_duration": 0, "now_playing_elapsed": 0, "now_playing_source": "TuneIn", "now_playing_station": "", "now_playing_title": "" }, "media_state": { "remote_control_enabled": true }, "notifications_supported": true, "odometer": 1323.436653, "parsed_calendar_supported": true, "pf": 0, "pr": 0, "rd_window": 0, "remote_start": false, "remote_start_enabled": true, "remote_start_supported": true, "rp_window": 0, "rt": 0, "santa_mode": 0, "sentry_mode": true, "sentry_mode_available": true, "service_mode": false, "service_mode_plus": false, "smart_summon_available": true, "software_update": { "download_perc": 0, "expected_duration_sec": 2700, "install_perc": 1, "status": "", "version": " " }, "speed_limit_mode": { "active": false, "current_limit_mph": 90.0, "max_limit_mph": 120, "min_limit_mph": 50.0, "pin_code_set": true }, "summon_standby_mode_enabled": false, "timestamp": 1665666097920, "tpms_hard_warning_fl": false, "tpms_hard_warning_fr": false, "tpms_hard_warning_rl": false, "tpms_hard_warning_rr": false, "tpms_last_seen_pressure_time_fl": 1665665960, "tpms_last_seen_pressure_time_fr": 1665665960, "tpms_last_seen_pressure_time_rl": 1665665960, "tpms_last_seen_pressure_time_rr": 1665665960, "tpms_pressure_fl": 2.925, "tpms_pressure_fr": 2.925, "tpms_pressure_rl": 2.9, "tpms_pressure_rr": 2.925, "tpms_rcp_front_value": 2.9, "tpms_rcp_rear_value": 2.9, "tpms_soft_warning_fl": false, "tpms_soft_warning_fr": false, "tpms_soft_warning_rl": false, "tpms_soft_warning_rr": false, "valet_mode": false, "valet_pin_needed": false, "vehicle_name": "Nikola", "webcam_available": false } } } } ``` # Charge State {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/charge_state` Information on the state of charge in the battery and its various settings. ### Response ```json { "response": { "battery_heater_on": false, "battery_level": 90, "battery_range": 224.47, "charge_amps": 12, "charge_current_request": 40, "charge_current_request_max": 40, "charge_enable_request": true, "charge_energy_added": 29.41, "charge_limit_soc": 90, "charge_limit_soc_max": 100, "charge_limit_soc_min": 50, "charge_limit_soc_std": 90, "charge_miles_added_ideal": 118.5, "charge_miles_added_rated": 95.0, "charge_port_cold_weather_mode": null, "charge_port_color": "", "charge_port_door_open": true, "charge_port_latch": "Engaged", "charge_rate": 0.0, "charge_to_max_range": false, "charger_actual_current": 0, "charger_phases": null, "charger_pilot_current": 40, "charger_power": 0, "charger_voltage": 0, "charging_state": "Complete", "conn_charge_cable": "SAE", "est_battery_range": 171.24, "fast_charger_brand": "", "fast_charger_present": false, "fast_charger_type": "", "ideal_battery_range": 280.59, "managed_charging_active": false, "managed_charging_start_time": null, "managed_charging_user_canceled": false, "max_range_charge_counter": 0, "minutes_to_full_charge": 0, "not_enough_power_to_heat": false, "off_peak_charging_enabled": false, "off_peak_charging_times": "all_week", "off_peak_hours_end_time": 360, "preconditioning_enabled": false, "preconditioning_times": "all_week", "scheduled_charging_mode": "Off", "scheduled_charging_pending": false, "scheduled_charging_start_time": null, "scheduled_charging_start_time_app": 665, "scheduled_departure_time": 1652090400, "scheduled_departure_time_minutes": 720, "supercharger_session_trip_planner": false, "time_to_full_charge": 0.0, "timestamp": 1604977209418, "trip_charging": false, "usable_battery_level": 90, "user_charge_enable_request": null } } ``` # Climate State {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/climate_state` Information on the current internal temperature and climate control system. ### Response ```json { "response": { "allow_cabin_overheat_protection": true, "auto_seat_climate_left": true, "auto_seat_climate_right": false, "battery_heater": false, "battery_heater_no_power": false, "cabin_overheat_protection": "FanOnly", "cabin_overheat_protection_actively_cooling": false, "climate_keeper_mode": "off", "cop_activation_temperature": "High", "defrost_mode": 0, "driver_temp_setting": 22.8, "fan_status": 0, "hvac_auto_request": "On", "inside_temp": 27.0, "is_auto_conditioning_on": false, "is_climate_on": false, "is_front_defroster_on": false, "is_preconditioning": false, "is_rear_defroster_on": false, "left_temp_direction": -232, "max_avail_temp": 28.0, "min_avail_temp": 15.0, "outside_temp": 23.0, "passenger_temp_setting": 22.8, "remote_heater_control_enabled": false, "right_temp_direction": -232, "seat_heater_left": 0, "seat_heater_right": 0, "side_mirror_heaters": false, "supports_fan_only_cabin_overheat_protection": true, "timestamp": 1604977244530, "wiper_blade_heater": false } } ``` # Drive State {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/drive_state` Returns the driving and position state of the vehicle. ### Response ```json { "response": { "gps_as_of": 1543187664, "heading": 8, "latitude": 33.111111, "longitude": -88.111111, "native_latitude": 33.111111, "native_location_supported": 1, "native_longitude": -88.111111, "native_type": "wgs", "power": 0, "shift_state": null, "speed": null, "timestamp": 1543187666472 } } ``` # GUI Settings {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/gui_settings` Returns various information about the GUI settings of the car, such as unit format and range display. ### Response ```json { "response": { "gui_24_hour_time": false, "gui_charge_rate_units": "mi/hr", "gui_distance_units": "mi/hr", "gui_range_display": "Rated", "gui_temperature_units": "F", "show_range_units": true, "timestamp": 1543187561462 } } ``` # Vehicle State {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/vehicle_state` Returns the vehicle's physical state, such as which doors are open. For the trunk (rt) and frunk (ft) fields, you should interpret a zero (0) value as closed and a non-zero value as open (partially or fully). Here are the currently known values for the `center_display_state` field: | State | Description | | ----- | ------------------------ | | 0 | Off | | 2 | On, standby or Camp Mode | | 3 | On, charging screen | | 4 | On | | 5 | On, Big charging screen | | 6 | On, Ready to unlock | | 7 | Sentry Mode | | 8 | Dog Mode | | 9 | Media | Here are the descriptions for the shorthand fields: | Field | Description | | ----- | --------------- | | df | driver front | | dr | driver rear | | pf | passenger front | | pr | passenger rear | | ft | front trunk | | rt | rear trunk | ### Response ```json { "response": { "api_version": 10, "autopark_state_v2": "standby", "autopark_style": "standard", "calendar_supported": true, "car_version": "2020.36.16 3e9e4e8dd287", "center_display_state": 0, "df": 0, "dr": 0, "ft": 0, "homelink_device_count": 2, "homelink_nearby": true, "is_user_present": false, "last_autopark_error": "no_error", "locked": false, "media_state": { "remote_control_enabled": true }, "notifications_supported": true, "odometer": 57509.856033, "parsed_calendar_supported": true, "pf": 0, "pr": 0, "remote_start": false, "remote_start_enabled": true, "remote_start_supported": true, "rt": 0, "sentry_mode": false, "sentry_mode_available": true, "smart_summon_available": true, "software_update": { "download_perc": 0, "expected_duration_sec": 2700, "install_perc": 1, "status": "", "version": "" }, "speed_limit_mode": { "active": false, "current_limit_mph": 50.0, "max_limit_mph": 90, "min_limit_mph": 50, "pin_code_set": true }, "summon_standby_mode_enabled": false, "sun_roof_percent_open": 0, "sun_roof_state": "closed", "timestamp": 1604977470379, "tpms_pressure_fl": 0.0, "tpms_pressure_fr": 0.0, "tpms_pressure_rl": 0.0, "tpms_pressure_rr": 0.0, "valet_mode": false, "valet_pin_needed": true, "vehicle_name": "Nikola 2.0" } } ``` # Vehicle Config {% hint style="warning" %} This endpoint was deprecated and returns 404. {% endhint %} ## GET `/api/1/vehicles/{id}/data_request/vehicle_config` Returns the vehicle's configuration information including model, color, badging and wheels. ### Response ```json { "response": { "can_accept_navigation_requests": true, "can_actuate_trunks": true, "car_special_type": "base", "car_type": "models2", "charge_port_type": "US", "ece_restrictions": false, "eu_vehicle": false, "exterior_color": "White", "has_air_suspension": true, "has_ludicrous_mode": false, "motorized_charge_port": true, "plg": true, "rear_seat_heaters": 0, "rear_seat_type": 0, "rhd": false, "roof_color": "None", "seat_type": 2, "spoiler_type": "None", "sun_roof_installed": 2, "third_row_seats": "None", "timestamp": 1604977445448, "trim_badging": "p90d", "use_range_badging": false, "wheel_type": "AeroTurbine19" } } ``` # Mobile Enabled ## GET `/api/1/vehicles/{id}/mobile_enabled` Lets you know if the Mobile Access setting is enabled in the car. ### Response ```json { "response": true } ``` # Nearby Charging Sites ## GET `/api/1/vehicles/{id}/nearby_charging_sites` Returns a list of nearby Tesla-operated charging stations. (Requires car software version 2018.48 or higher.) ### Response ```json { "response": { "congestion_sync_time_utc_secs": 1604976488, "destination_charging": [ { "location": { "lat": 34.010854, "long": -84.574979 }, "name": "Hilton Garden Inn Atlanta NW/Kennesaw Town Center", "type": "destination", "distance_miles": 6.430447 }, { "location": { "lat": 34.011213, "long": -84.575745 }, "name": "Homewood Suites by Hilton Atlanta NW-Kennesaw", "type": "destination", "distance_miles": 6.48008 }, { "location": { "lat": 33.881785, "long": -84.473461 }, "name": "Hyatt Place Atlanta/Cobb Galleria", "type": "destination", "distance_miles": 6.778101 }, { "location": { "lat": 33.991767, "long": -84.351229 }, "name": "European Collision Repair", "type": "destination", "distance_miles": 6.805893 } ], "superchargers": [ { "location": { "lat": 33.848756, "long": -84.36434 }, "name": "Atlanta, GA - Peachtree Road", "type": "supercharger", "distance_miles": 10.868304, "available_stalls": 4, "total_stalls": 5, "site_closed": false }, { "location": { "lat": 33.846487, "long": -84.360172 }, "name": "Atlanta, GA - Lenox Road", "type": "supercharger", "distance_miles": 11.131691, "available_stalls": 16, "total_stalls": 16, "site_closed": false }, { "location": { "lat": 34.075818, "long": -84.652184 }, "name": "Acworth, GA", "type": "supercharger", "distance_miles": 12.403464, "available_stalls": 11, "total_stalls": 11, "site_closed": false }, { "location": { "lat": 34.071365, "long": -84.275362 }, "name": "Alpharetta, GA", "type": "supercharger", "distance_miles": 12.772961, "available_stalls": 6, "total_stalls": 10, "site_closed": false } ], "timestamp": 1604977312943 } } ``` # Miscellaneous ## GET `/api/1/vehicles/{vehicle_id}/release_notes` Get the current software version or upcoming software update's release notes. ### Parameters | Parameter | Example | Description | | --------- | ------- | --------------------------------------------------------------------------------------------------------------- | | staged | true | If there is currently a pending software update, this will return the upcoming software update's release notes. | ### Response ```json { "response": { "release_notes": [ { "title": "Feature 1", "subtitle": "A bit more info", "description": "What changed?", "customer_version": "2022.40", "image_url": "https://vehicle-files.teslamotors.com/release_notes/{id}?__gda__=exp={unix_timestamp}~acl=/release_notes/{id}~hmac={id}" } ], "deployed_version": "2022.40.4.2", "staged_version": null } } ``` # Commands These endpoints issue various commands to the car. These commands alter the vehicles state and return a boolean `result` to indicate success. {% content-ref url="/pages/-LNi3K-B2jCZ1UfVWDCz" %} [Wake](/vehicle/commands/wake) {% endcontent-ref %} Wakes up the car from a sleeping state. {% content-ref url="/pages/-LNi3K-CyA43VpTjw-ku" %} [Alerts](/vehicle/commands/alerts) {% endcontent-ref %} Controls for honking the horn and flashing the lights. {% content-ref url="/pages/-LNi3K-KAcN\_LFF4-Wlf" %} [Remote Start](/vehicle/commands/remotestart) {% endcontent-ref %} Start the car remotely. {% content-ref url="/pages/-Lpzeu1CZ4LL4CcbBH0g" %} [Homelink](/vehicle/commands/homelink) {% endcontent-ref %} Open or close the primary garage door via Homelink. {% content-ref url="/pages/-LNi3K-M\_xvgpt8U-mFl" %} [Speed Limit](/vehicle/commands/speedlimit) {% endcontent-ref %} Limit the maximum speed of the car. {% content-ref url="/pages/-LNi3K-NQdMxr0N5rsXQ" %} [Valet Mode](/vehicle/commands/valet) {% endcontent-ref %} Enable Valet Mode and reset the in-car PIN. {% content-ref url="/pages/-LNi3K-DewMAxCrXyiur" %} [Doors](/vehicle/commands/doors) {% endcontent-ref %} Lock and unlock the car. {% content-ref url="/pages/-LNi3K-E3KbtJHeGuZeK" %} [Frunk/Trunk](/vehicle/commands/trunk) {% endcontent-ref %} Open and close the trunk and frunk. {% content-ref url="/pages/-Lpzeu1IU81w0VK4l2an" %} [Windows](/vehicle/commands/windows) {% endcontent-ref %} Open and vent the windows. {% content-ref url="/pages/-LNi3K-Fn7\_17j56Ra0t" %} [Sunroof](/vehicle/commands/sunroof) {% endcontent-ref %} Open and close the panoramic sunroof. {% content-ref url="/pages/-LNi3K-GNGoknTLF2fF2" %} [Charging](/vehicle/commands/charging) {% endcontent-ref %} Control the charging of the car. {% content-ref url="/pages/-LNi3K-HTn5NeZ0yRApS" %} [Climate](/vehicle/commands/climate) {% endcontent-ref %} Adjust the temperature settings of the car. {% content-ref url="/pages/-LNi3K-IGAm7ZftofdLi" %} [Media](/vehicle/commands/media) {% endcontent-ref %} Control the media playing in the car. {% content-ref url="/pages/-LpzkSD-oB-qr\_dvGun\_" %} [Sharing](/vehicle/commands/sharing) {% endcontent-ref %} Share a location to navigate to or video to play in theatre mode. {% content-ref url="/pages/-LNi3K-L2ifZRLJbDqI9" %} [Software Updates](/vehicle/commands/softwareupdate) {% endcontent-ref %} Start an update of the car's software. {% content-ref url="/pages/-LcXKOfoO2Fq3whzHzNO" %} [Sentry Mode](/vehicle/commands/sentrymode) {% endcontent-ref %} Enable or disable Sentry Mode. {% content-ref url="/pages/-LNi3K-OtEp0Y-Fe\_ZIM" %} [Calendar](/vehicle/commands/calendar) {% endcontent-ref %} Synchronize a calendar with the car. {% content-ref url="/pages/H8deG9X3Q9acnKP57cAD" %} [Miscellaneous](/vehicle/commands/misc) {% endcontent-ref %} Miscellaneous features. (Changing vehicle name etc.) # Wake ## POST `/api/1/vehicles/{id}/wake_up` Wakes up the car from a sleeping state. The API will return a response immediately, however it could take several seconds before the car is actually online and ready to receive other commands. One way to deal with this is to call this endpoint in a loop until the returned state says "online", with a timeout to give up. In some cases, the wake up can be slow, so consider using a timeout of atleast 30 seconds. ### Response ```json { "response": { "id": 12345678901234567, "user_id": 12345, "vehicle_id": 1234567890, "vin": "5YJSA11111111111", "display_name": "Nikola 2.0", "color": null, "tokens": ["abcdef1234567890", "1234567890abcdef"], "state": "online", "in_service": false, "id_s": "12345678901234567", "calendar_enabled": true, "api_version": 7, "backseat_token": null, "backseat_token_updated_at": null } } ``` # Alerts Controls for honking the horn and flashing the lights. ## POST `/api/1/vehicles/{id}/command/honk_horn` Honks the horn twice. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/flash_lights` Flashes the headlights once. ### Response ```json { "reason": "", "result": true } ``` # Remote Start ## POST `/api/1/vehicles/{id}/command/remote_start_drive` Enables keyless driving. There is a two minute window after issuing the command to start driving the car. ### Response ```json { "reason": "", "result": true } ``` # Homelink ## POST `/api/1/vehicles/{id}/command/trigger_homelink` Opens or closes the primary Homelink device. The provided location must be in proximity of stored location of the Homelink device. ### Parameters | Parameter | Example | Description | | --------- | ------------------ | ------------------ | | lat | 36.98765432109876 | Current latitude. | | lon | -77.12345678901234 | Current longitude. | ### Response ```json { "reason": "", "result": true } ``` # Speed Limit ## POST `/api/1/vehicles/{id}/command/speed_limit_set_limit` Sets the maximum speed allowed when Speed Limit Mode is active. ### Parameters | Parameter | Example | Description | | ---------- | ------- | ---------------------------------------------- | | limit\_mph | 65 | The speed limit in MPH. Must be between 50-90. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/speed_limit_activate` Activates Speed Limit Mode at the currently set speed. ### Parameters | Parameter | Example | Description | | --------- | ------- | ---------------------------------------------------------- | | pin | 1234 | The existing PIN, if previously set, or a new 4 digit PIN. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/speed_limit_deactivate` Deactivates Speed Limit Mode if it is currently active. ### Parameters | Parameter | Example | Description | | --------- | ------- | -------------------------------------------------- | | pin | 1234 | The 4 digit PIN used to activate Speed Limit Mode. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/speed_limit_clear_pin` Clears the currently set PIN for Speed Limit Mode. ### Parameters | Parameter | Example | Description | | --------- | ------- | -------------------------------------------------- | | pin | 1234 | The 4 digit PIN used to activate Speed Limit Mode. | ### Response ```json { "reason": "", "result": true } ``` # Valet Mode Valet Mode limits the car's top speed to 70MPH and 80kW of acceleration power. It also disables Homelink, Bluetooth and Wifi settings, and the ability to disable mobile access to the car. It also hides your favorites, home, and work locations in navigation. Note: the `password` parameter isn't required to turn on or off Valet Mode, even with a previous PIN set. If you clear the PIN and activate Valet Mode without the parameter, you will only be able to deactivate it from your car's screen by signing into your Tesla account. ## POST `/api/1/vehicles/{id}/command/set_valet_mode` Activates or deactivates Valet Mode. ### Parameters | Parameter | Example | Description | | --------- | ------- | ------------------------------------------------------------------------------- | | on | true | true to activate, false to deactivate. | | password | 1234 | A PIN to deactivate Valet Mode. Please see note about the `password` parameter. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/reset_valet_pin` Clears the currently set PIN for Valet Mode when deactivated. A new PIN will be required when activating from the car screen. See the note above about activating via the API without a PIN set. ### Response ```json { "reason": "", "result": true } ``` # Sentry Mode ## POST `/api/1/vehicles/{id}/command/set_sentry_mode` Turns sentry mode on or off. ### Request This endpoint requires a singular parameter `on`, inside the POST body with the value set to `true` for enabling and `false` for disabling sentry mode. ### Example ```json { "on": "true" } ``` ### Response ```json { "reason": "", "result": true } ``` # Doors ## POST `/api/1/vehicles/{id}/command/door_unlock` Unlocks the doors to the car. Extends the handles on the S. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/door_lock` Locks the doors to the car. Retracts the handles on the S, if they are extended. ### Response ```json { "reason": "", "result": true } ``` # Frunk/Trunk ## POST `/api/1/vehicles/{id}/command/actuate_trunk` Opens either the front or rear trunk. On the Model S and X, it will also close the rear trunk. ### Parameters | Parameter | Example | Description | | ------------ | ------- | ------------------------------------------------------------------- | | which\_trunk | rear | Which trunk to open/close. `rear` and `front` are the only options. | ### Response ```json { "reason": "", "result": true } ``` # Windows ## POST `/api/1/vehicles/{id}/command/window_control` Controls the windows. Will vent or close all windows simultaneously. `lat` and `lon` values must be near the current location of the car for `close` operation to succeed. For `vent`, the `lat` and `lon` values are ignored, and may both be `0` (which has been observed from the app itself). ### Parameters | Parameter | Example | Description | | --------- | ------- | --------------------------------------------------------------------------- | | command | close | What action to take with the windows. Allows the values `vent` and `close`. | | lat | 0 | Your current latitude. See Notes above. | | lon | 0 | Your current longitude. See Notes above. | ### Response ```json { "reason": "", "result": true } ``` # Sunroof ## POST `/api/1/vehicles/{id}/command/sun_roof_control` Controls the panoramic sunroof on the Model S. Note: There were state options for `open` (100%), `comfort` (\~80%), and `move` (combined with a `percent` parameter), but they have since been disabled server side. It is unknown if they will return at a later time. ### Parameters | Parameter | Example | Description | | --------- | ------- | ----------------------------------------------------------------------------------------- | | state | vent | The amount to open the sunroof. Currently this only allows the values `vent` and `close`. | ### Response ```json { "reason": "", "result": true } ``` # Charging Commands related to the charging of the vehicle. ## POST `/api/1/vehicles/{id}/command/charge_port_door_open` Opens the charge port or unlocks the cable. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/charge_port_door_close` For vehicles with a motorized charge port, this closes it. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/charge_start` If the car is plugged in but not currently charging, this will start it charging. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/charge_stop` If the car is currently charging, this will stop it. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/charge_standard` Sets the charge limit to "standard" or \~90%. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/charge_max_range` Sets the charge limit to "max range" or 100%. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_charge_limit` Sets the charge limit to a custom value. ### Parameters | Parameter | Example | Description | | --------- | ------- | --------------------------------------------- | | percent | 75 | The percentage the battery will charge until. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_charging_amps` Sets the charge amps limit to a custom value. ### Parameters | Parameter | Example | Description | | -------------- | ------- | ------------------------------------ | | charging\_amps | 32 | The max amps to use during charging. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_scheduled_charging` Set the scheduled charge. ### Parameters | Parameter | Example | Description | | --------- | ------- | ------------------------------------------ | | enable | true | true for on, false for off. | | time | 1410 | time in minutes since midnight local time. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_scheduled_departure` Set the scheduled departure. ### Parameters | Parameter | Example | Description | | ----------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ | | enable | true | true for on, false for off. | | departure\_time | 540 | true if (preconditioning\_enabled or off\_peak\_charging\_enabled), false otherwise (this condition may change in the future). | | preconditioning\_enabled | true | true for on, false for off. | | preconditioning\_weekdays\_only | true | true for on, false for off. | | off\_peak\_charging\_enabled | true | true for on, false for off. | | off\_peak\_charging\_weekdays\_only | true | true for on, false for off. | | end\_off\_peak\_time | 450 | time in minutes since midnight local time. | ### Response ```json { "reason": "", "result": true } ``` # Climate Commands related to the climate control (HVAC) system. ## POST `/api/1/vehicles/{id}/command/auto_conditioning_start` Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature. ### Parameters | Body Parameter | Example | Description | | ---------------- | -------- | --------------------------------------------------------- | | manual\_override | socdoors | Optional, to override the low\_soc failure reason (<20%). | ### Example ```json { "manual_override": "socdoors" } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/auto_conditioning_stop` Stop the climate control (HVAC) system. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_temps` Sets the target temperature for the climate control (HVAC) system. Note: Despite accepting two parameters, only the `driver_temp` will be used to set the target temperature, unless the "split" option is activated within the climate controls menu. Note: The parameters are always in celsius, regardless of the region the car is in or the display settings of the car. ### Parameters | Parameter | Example | Description | | --------------- | ------- | ----------------------------------------------------------- | | driver\_temp | 23.4 | The desired temperature on the driver's side in celsius. | | passenger\_temp | 23.4 | The desired temperature on the passenger's side in celsius. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_preconditioning_max` Toggles the climate controls between Max Defrost and the previous setting. ### Parameters | Parameter | Example | Description | | --------- | ------- | ----------------------------------- | | on | true | True to turn on, false to turn off. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/remote_seat_heater_request` Sets the specified seat's heater level. ### Parameters | Parameter | Example | Description | | --------- | ------- | --------------------------------------- | | heater | 0 | The desired seat to heat. (0-5) | | level | 3 | The desired level for the heater. (0-3) | The `heater` parameter maps to the following seats: | Number | Seat | | ------ | ----------- | | 0 | Front Left | | 1 | Front right | | 2 | Rear left | | 4 | Rear center | | 5 | Rear right | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/remote_seat_cooler_request` Sets the specified seat's cooler level. (Refresh Model S & X) ### Parameters These parameters need to be passed via the post body as `JSON`. | Body Parameter | Example | Description | | ------------------- | ------- | --------------------------------------- | | seat\_position | 0 | The desired seat to cool. (0-5) | | seat\_cooler\_level | 3 | The desired level for the cooler. (0-3) | The `seat_position` parameter maps to the following seats: | Number | Seat | | ------ | ----------- | | 0 | Front Left | | 1 | Front right | | 2 | Rear left | | 4 | Rear center | | 5 | Rear right | ### Example ```json { "seat_position": 0, "seat_cooler_level": 3 } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/remote_steering_wheel_heater_request` Turn steering wheel heater on or off. ### Parameters | Parameter | Example | Description | | --------- | ------- | ----------------------------------- | | on | true | True to turn on, false to turn off. | ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_bioweapon_mode` Enable or disable Bioweapon Defense Mode. ### Request This endpoint requires json in the post body, with the singular parameter `on` which is either `true` or `false`. This endpoint will respond with the `result` as `true` even with no parameters or body specified. ```json { "on": "true" "manual_override": "true" } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/set_climate_keeper_mode` Set the Climate Keeper mode. ### Request This endpoint requires json in the post body, with the singular parameter `climate_keeper_mode` and a number as the value. Those map to the values below. | Number | Mode | | ------ | ------------ | | 0 | Off | | 1 | On - Default | | 2 | Dog Mode | | 3 | Camp Mode | ### Example ```json { "climate_keeper_mode": 0 } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{vehicle_id}/command/remote_auto_seat_climate_request` Enables/disables Automatic Seat Climate on the specified seat. ### Parameters These parameters need to be passed via the post body as `JSON`. | Body Parameter | Example | Description | | -------------------- | ------- | ---------------------------------------- | | auto\_seat\_position | 0 | The desired seat for auto climate. (0-5) | | auto\_climate\_on | true | `true` to enable and `false` to disable. | The `auto_seat_position` parameter maps to the following seats: | Number | Seat | | ------ | ----------- | | 0 | Front Left | | 1 | Front right | | 2 | Rear left | | 4 | Rear center | | 5 | Rear right | ### Example ```json { "auto_seat_position": 0, "auto_climate_on": "true" } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{vehicle_id}/command/set_cop_temp` Sets the Cabin Overheat Protection (COP) temperature. {% hint style="info" %} This endpoint appears to be in progress and is not yet fully functional/disabled as of now (12-13-2022, MDY). {% endhint %} ### Parameters These parameters need to be passed via the post body as `JSON`. | Body Parameter | Example | Description | | -------------- | ------- | ---------------------------------------------------------- | | temp | 40 | The COP temperature in Celcius (name is subject to change) | ### Example ```json { "temp": "40" } ``` ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{vehicle_id}/command/set_cabin_overheat_protection` Turns on the Cabin Overheat Protection (COP) and sets its mode. ### Parameters These parameters need to be passed via the post body as `JSON`. | Body Parameter | Example | Description | | -------------- | ------- | ---------------------------------------------- | | on | true | Turns COP on/off. | | fan\_only | true | Use only the fans, do not use/turn on HVAC/AC. | ### Example ```json { "on": true, "fan_only": true } ``` ### Response ```json { "reason": "", "result": true } ``` # Media Controls the currently playing media in the car. For these commands to work, the car must be on. ## POST `/api/1/vehicles/{id}/command/media_toggle_playback` Toggles the media between playing and paused. For the radio, this mutes or unmutes the audio. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_next_track` Skips to the next track in the current playlist. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_prev_track` Skips to the previous track in the current playlist. Does nothing for streaming from Stitcher. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_next_fav` Skips to the next saved favorite in the media system. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_prev_fav` Skips to the previous saved favorite in the media system. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_volume_up` Turns up the volume of the media system. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/media_volume_down` Turns down the volume of the media system. ### Response ```json { "reason": "", "result": true } ``` ## POST `/api/1/vehicles/{id}/command/adjust_volume` Adjusts the volume of the media system to the desired volume. ### Parameters This endpoint needs a single `volume` parameter passed inside of the POST body, and will tell you if it's missing. > Note: the endpoint accepts both a string and a numerical value for the volume parameter. It is also currently not present as a feature inside of the Tesla App despite working. | Parameter | Example | Description | | --------- | ------- | ----------------------------------- | | volume | 1 | Numerical value or string from 0-11 | ```json { "volume": "1" } ``` ```json { "volume": 1 } ``` ### Response ```json { "reason": "", "result": true } ``` # Sharing ## POST `/api/1/vehicles/{id}/command/share` Sends a location for the car to start navigation or play a video in theatre mode. These docs take from the Android app, which sends the data in JSON form. However, a [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding) POST body will work as well. The basic format to a request looks like this: ```json { "type": "share_ext_content_raw", "value": { "android.intent.extra.TEXT": "123 Main St, City, ST 12345\n\nhttps://goo.gl/maps/X" }, "locale": "en-US", "timestamp_ms": "1539465730" } ``` Note: This API was previously `navigation_request`, but has been updated to support video links as well. ### Parameters | Parameter | Example | Description | | --------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | type | share\_ext\_content\_raw | Must be `share_ext_content_raw`. | | locale | en-US | The locale for the navigation request. [ISO 639-1 standard language codes](https://www.andiamo.co.uk/resources/iso-language-codes/) | | timestamp\_ms | 1539465730 | The current UNIX timestamp. | | value\[android.intent.extra.TEXT] | 123 Main St, City, ST 12345 | The address or video URL to set as the navigation destination. | ### Response ```json { "reason": "", "result": true } ``` # Software Updates ## POST `/api/1/vehicles/{id}/command/schedule_software_update` Schedules a software update to be installed, if one is available. ### Parameters | Parameter | Example | Description | | ----------- | ------- | -------------------------------------------------------------------------------------- | | offset\_sec | 7200 | How many seconds in the future to schedule the update. Set to 0 for immediate install. | ### Response ```json { "expected_duration_sec": 3000, "reason": "", "result": true, "scheduled_time_ms": 1685735308001, "status": "scheduled", "warning_time_remaining_ms": 120000 } ``` ## POST `/api/1/vehicles/{id}/command/cancel_software_update` Cancels a software update, if one is scheduled and has not yet started. ### Response ```json { "reason": "", "result": true } ``` # Calendar # Miscellaneous ## Take Drive Note {% hint style="info" %} This endpoint currently returns `not_supported` as a response, due to not being implemented / enabled yet. {% endhint %} ### POST `/api/1/vehicles/{id}/command/take_drivenote` Take a drive note. (This feature might be related to the FSD beta bug reporting system.) #### Request This endpoint requires a singular parameter `note`, inside the POST body with the value being anything you want to note. #### Example ```json { "note": "42" } ``` #### Response ```json { "result": true, "reason": "" } ```
## Set Vehicle Name {% hint style="info" %} Previously the endpoint returned `not_supported` as a response, due to not being implemented / enabled yet. Later in app version 4.19.0-1639, the endpoint was removed from the `ownerapi_endpoints.json` file. As of App version 4.20.5 you can change your vehicle name on software versions 2023.12+ {% endhint %} ### POST `/api/1/vehicles/{id}/command/set_vehicle_name` Set your vehicles name. This endpoint requires a singular parameter `vehicle_name`, inside of the POST body, with any given name as a value. #### Example ```json { "vehicle_name": "Nikola" } ``` #### Response ```json { "result": true, "reason": "" } ```
## Screenshot ### GET `/api/1/vehicles/{id}/screenshot` Take a screenshot of both displays (IC & MCU), which can be retrieved via the vehicle's CAN/OBD interface by Tesla Service.\ This is can be triggered inside of the vehicle as well, by holding the lower left & right buttons (Model S & X pre-refresh) on the steering wheel for around 5-10 seconds, kind of like the scroll wheel MCU restart. > Note: No on-screen message will appear. #### Response ```json { "response": "teleforce-ab1c234d-1a23-12a3-12a3-ab123c456d7e" } ``` ## Remote Boombox ### POST `/api/1/vehicles/{id}/command/remote_boombox` Let the car fart remotely on version 2022.44.25.1 and above or use boombox v2 on supported vehicles. #### Parameters This endpoint does not require a POST body to fart remotely but needs one to use boombox v2. | Parameter | Example | Description | | --------- | ------- | --------------------------------------- | | action | 0 | Numerical value representing the action | The available actions are: | Action | Corresponding numerical value | | ------ | ----------------------------- | | Fart | 0 | #### Example ```json { "action": 0 } ``` #### Response ```json { "result": true, "reason": "" } ``` # Streaming Please help fill this out! # Autopark/Summon # Option Codes The `option_codes` field of a vehicle is a comma-delimited set of codes that represent various options the car was built with. This can include trim options, battery sizes, color, wheel types, and addon packages. **As of August 2019, Option Codes cannot be relied on.** Vehicles now return a generic set of codes related to a Model 3. | Code | Title | Description | | ------ | -------------------------------------------------------- | --------------------------------------------------------- | | MDLS | Model S | This vehicle is a Model S | | MDL3 | Model 3 | This vehicle is a Model 3 | | MDLX | Model X | This vehicle is a Model X | | MDLY | Model Y | This vehicle is a Model Y | | REAP | Region: Asia Pacific | | | REEU | Region: Europe | | | RENA | Region: North America | | | RENC | Region: Canada | | | ACL1 | Ludicrous Mode | Model X | | AD02 | NEMA 14-50 | | | AD04 | European 3-Phase | | | AD05 | European 3-Phase, IT | | | AD06 | Schuko (1 phase, 230V 13A) | | | AD07 | Red IEC309 (3 phase, 400V 16A) | | | AD08 | Blue Charging Adapter | | | AD09 | Adapter, Swiss (1 phase, 10A) | | | AD10 | Adapter, Denmark (1 phase, 13A) | | | AD11 | Adapter, Italy (1 phase, 13A) | | | AD15 | Adapter | J1772 | | ADPX2 | Type 2 Public Charging Connector | | | ADX4 | No European 3-Phase | | | ADX5 | European 3-Phase, IT | | | ADX6 | No - Adapter, Schuko (1 phase, 13A) | | | ADX7 | No - 3-ph Red IEC309 (3 phase, 16A) | | | ADX8 | Blue IEC309 (1 phase, 230V 32A) | | | ADX9 | No - Adapter, Swiss (1 phase, 10A) | | | AF00 | No HEPA Filter | Standard air filter, no air ionizer | | AF02 | HEPA Filter | | | AH00 | No Accessory Hitch | | | AL03 | Interior Accent RGB Lighting | INTERIOR ACCENT LIGHT | | AP04 | Autopilot 4.0 | Model S 02.2023\Model Y from 10May2023 | | APB1 | Autopilot with convenience features | Model S | | APBS | Autopilot | Model 3 Autopilot | | APF0 | Autopilot Firmware 2.0 Base | | | APF1 | Autopilot Firmware 2.0 Enhanced | | | APF2 | Full Self-Driving Hardware (Activated) | Car has active FSD software purchase | | APFB | Full Self-Driving Hardware | Car has FSD hardware, but sofware option is not purchased | | APH1 | Hardware 1.0 | | | APH2 | Hardware 2.0 | | | APH3 | Hardware 2.5 | | | APH4 | Hardware 3.0 | | | APPB | Enhanced Autopilot | Navigate on Autopilot, Auto Lane Change, Autopark, Summon | | APPF | Full Self-Driving Capability | | | AU00 | No Audio Package | | | AU01 | Ultra High Fidelity Sound | | | AU3D | Sound Studio Package | Reduced Audio Package (M3 standard) | | AU3P | Sound Studio Package | Premium audio package | | AUF1 | Premium Speakers Enabled | M3/MY Premium Audio Package (AWD,Perf) | | AUF2 | Premium Speakers Disabled | M3/MY Reduced Audio Package (Standard, mid range) | | BA01 | Brakes actuator | Bosch DPB with ESP10 | | BC00 | Brake Calipers M4.42/44 | MS Plaid E5 | | BC0B | Black Brake Calipers | Model S | | BC0R | Red Brake Calipers | Model S | | BC3B | Black Brake Calipers | Model 3/Y | | BC3R | Black Brake Calipers, Red brake calipers | Model 3/Y Performance | | BC50 | Brakes Performance P2 | Model S/X Plaid | | BCMB | Black Brake Calipers, Mando Brakes | | | BCYR | Performance Brakes | | | BG30 | No Badge | Model 3 | | BG31 | AWD Badge without underline | Model 3/Y | | BG32 | Performance AWD Badge | Model 3 | | BG33 | China Badge | Model 3 for China market | | BP00 | No Ludicrous | | | BP01 | Ludicrous Speed Upgrade | | | BP02 | Uncorked Acceleration | Non-Performance | | BR00 | No Battery Firmware Limit | | | BR03 | Battery Firmware Limit (60kWh) | | | BR05 | Battery Firmware Limit (75kWh) | | | BS00 | Blind Spot Sensor Package | No blind spot detectors | | BS01 | Special Production Flag | | | BT00 | 68 kWh (Model Y) 4680 cells | Model Y SR (Structural Pack with BFF 0.0 cells) | | BT01 | 60kWh BYD 7C "Blade" | Structural Pack with Bladerunner cells | | BT35 | 50 kWh (Model 3/Y) Pre 2021 Panasonic cells | Model 3 Standard Range | | BT36 | 62.5 kWh (Model 3/Y) Pre 2021 Panasonic cells | Model 3 Mid Range | | BT37 | 75 kWh (Model 3/Y) Pre 2021 Panasonic cells | 2017-03.2021 LR+P Model 3/Y (Mostly Fremont build) | | BT38 | 74 kWh (Model 3/Y) LG cells | M3/MY LR/Dual build in China | | BT3D | 50 kWh (Model 3) | 2019 Model 3 Standard Range | | BT40 | 40 kWh | | | BT41 | 55 kWh 2021 E1 2170L Panasonic Battery Pack | M3/Y Standard+ 2021 model year | | BT42 | 82 kWh (Model 3/Y) 2021 Panasonic | M3P (and latest LR Fremont) 2021 model year | | BT43 | 79 kWh (Model 3/Y) 2021 LG NCA | M3/Y LR Q4.2021 | | BT44 | 84–85 kWh netto E3 M53F | MY LR Q3.2025 | | BT47 | E3 2170L RWD Battery Pack | MY RWD Q2.2024 | | BT60 | 60 kWh | | | BT70 | 70 kWh | | | BT85 | 85 kWh | | | BTF0 | 55 kWh 2020 CATL Prismatic | M3 Standard+ China made LFP and Q4.2021 M3 Stdr+ USA | | BTF1 | 60 kWh E1 LFP60 CATL Battery Pack | M3 Standard+ LFP | | BTX4 | 90 kWh | | | BTX5 | 75 kWh | EPA range 237 miles (MX), 259 miles (MS) | | BTX6 | 100 kWh | | | BTX7 | 75 kWh | | | BTX8 | 75 kWh | | | BTX9 | 100 kWh Battery Pack with Weight Reduction | Model S 2020/05 | | BTXA | 18650J2 Battery Cell | Model S/X 2020 | | BTXB | 99kWh 18650 Plaid E5/E6 VIN battery | Model S/X 2021 LR/Plaid | | BY00 | | Model Y | | BY01 | 1 piece cast rear under body legacy | Model Y | | BY02 | 1 piece cast front under body and rear under body | Model Y First found on Austin car | | BY03 | Safety Net Body | Model Y First found on Berlin car | | BY04 | 1 piece cast rear under Safety Net Body | Model Y Berlin car | | CAM1 | AeroRib Side Repeater without Cheetah Camera | | | CC01 | Five Seat Interior | | | CC02 | Six Seat Interior | | | CC03 | Seven Seat Interior | | | CC04 | Seven Seat Interior | | | CC12 | Six Seat Interior with Center Console | | | CDM0 | No CHAdeMO Charging Adaptor | | | CF00 | 72amp High Power Charger | | | CF01 | 48amp charger | | | CH00 | Standard Charger (40 Amp) | | | CH01 | Dual Chargers (80 Amp) | Twin 10kW charge config | | CH04 | 72 Amp Charger Gen3 | Model S/X | | CH05 | 32/48 Amp Charger | Model S/X - 48A, M3 - 32A | | CH06 | 48 Amp Charger | Model 3 CN | | CH07 | 48 Amp Charger | Model 3 | | CH09 | Tesla Standard Charging System 72a (Gen3) | Model S/X 2019-2020 EU | | CH11 | Single phase 48 Amperage Combo 1 | Chargers Single Phase | | CH12 | 48 Amperage Combo 1 Gen 3.5 Charger | Chargers Single Phase (MS/MX 2020-2021) | | CH14 | 32 Amp Charger Hardware (RENA) with Busbar | NA spec M3 2022 SR+ | | CH15 | 48 Amp Charger Hardware (REEU/REAP) with Busbar | EU spec | | CH16 | 48 Amp Charger Hardware (RENA) with Busbar | NA spec | | CH17 | 48 Amp 1PH&3PH,P2 | NA/EU spec Model S/X Palladium | | COL0 | Signature | | | COL1 | Solid | | | COL2 | Metallic | | | COL3 | Tesla Multi-Coat | | | COAT | Country: Austria | | | COAU | Country: Australia | | | COBE | Country: Belgium | | | COCA | Country: Canada | | | COCH | Country: Switzerland | | | COCN | Country: China | | | CODE | Country: Germany | | | CODK | Country: Denmark | | | COES | Country: Spain | | | COFI | Country: Finland | | | COFR | Country: France | | | COGB | Country: Great Britain | | | COHR | Country: Croatia | | | COIE | Country: Ireland | | | COIT | Country: Italy | | | COIL | Country: Israel | | | COJP | Country: Japan | | | COKR | Country: South Korea | | | COLU | Country: Luxembourg | | | CONL | Country: Netherlands | | | CONO | Country: Norway | | | CONZ | Country: New Zealand | | | COPT | Country: Portugal | | | COSE | Country: Sweden | | | COSG | Country: Singapore | | | COTR | Country: Turkey | | | COUS | Country: United States | | | CP00 | NA Chargeport (TPC) | MX/MS 2021 | | CP01 | Charge port Gen? CCS size | MS/MX 2022 | | CP03 | CCS2 Integrated Chargeport | MS/MX 2022 | | CPF0 | Standard Connectivity | 1 month | | CPF1 | Premium Connectivity | 1 year | | CPW1 | 20" Performance Wheels | | | CR01 | Sanden Import Compressor | MY 2023 China | | CR02 | Denso Import Compressor | MY 2023 China | | CW00 | No Weather Package | No Cold Weather Package | | CW02 | Weather Package | Subzero Weather Package | | DA00 | No Autopilot | | | DA01 | Active Safety (ACC,LDW,SA) | Drivers Assistance Package | | DA02 | Autopilot Convenience Features | | | DCF0 | Front Console NO Drop-In Front Console | | | DCF2 | Front Console Inductive Phone Charger | | | DRLH | Left Hand Drive | | | DRRH | Right Hand Drive | | | DSH5 | Dashboard | PUR Dashboard Pad | | DSH7 | Alcantara Dashboard Accents | | | DSHG | Dash with Graphite trim | | | DU00 | Drive Unit - IR | | | DU01 | Drive Unit - Infineon | | | DU02 | Drive Unit - Non-performance front drive unit (raven) | MS 19apr2019-2020 | | DV2W | Rear-Wheel Drive | | | DV4W | All-Wheel Drive | | | EUSB | Safety EU Black | | | FBBB | Front Brake Brembo Black | | | FBBR | Front Brake Brembo Red | Brakes (MS/MX 2021) | | FC01 | Front Console Inductive Phone Charger | Model 3 | | FC02 | Front Console Front Console (Premium) | Model 3/Y 2021 | | FC03 | Front Console Front Console 3.0 | Model 3/Y 2024 | | FCH2 | Front controller hard v2 that supports both non-FSD +FSD | Model 3/Y late 2021 | | FC3P | Front Console Front Console (Premium) | Model 3 | | FD00 | Low Current IGBT IM130 Drive Unit | Front drive unit M3/MY | | FD01 | Low Current IGBT IM130 Drive Unit, CN/DE | Model 3/Y 2021 (China/Germany) | | FD02 | P2 Front Drive Unit | Model S/X 2021 LR | | FD03 | P2 Sleeved Front Drive Unit | Model S/X 2021 P | | FDU2 | Raven Front Drive Unit | Model S/X 2020-2021 | | FG3B | Fog Lamp Cover (No Fog lamps) | Model 3 Standard+ | | FG00 | No Exterior Lighting Package | | | FG01 | Fog Lamps | Exterior Lighting Package | | FG02 | Fog Lamps | Fog Lamps | | FG31 | Fog Lamps | Model Premium Fog Lights | | FGF0 | Fog Lamps Disabled | Model 3 Standard+ | | FGF1 | Fog Lamps Enabled | Model 3/Y with Premium Interior | | FM3B | No Performance Package | Model 3/Y | | FM3S | Semi de-rated firmware | Model 3 Standard+ | | FM3P | Performance Package | Model 3 Performance Firmware | | FM3U | Acceleration Boost | Model 3 Long Range All-Wheel Drive | | FMP6 | Performance Firmware | | | FR01 | Base Front Row | | | FR02 | Ventilated Front Seats | | | FR03 | FR03 | | | FR04 | Front Row Seat | MS 2018-2020 | | FR05 | Front Row Seat | Ventilated Front Seats (MS/MX 10.2020+) | | GLCN | Assembly | Final Assembly China Giga3 Model 3 | | GLFR | Assembly | Final Assembly Fremont | | GLTL | Assembly | Final Assembly Tilburg | | HC00 | No Home Charging installation | | | HC01 | Home Charging Installation | | | HM30 | Teck Package - No Homelink | No Homelink Option | | HM31 | Teck Package - Homelink | Homelink | | HL00 | Head Lamp | Model S/X 2021 | | HL01 | Matrix Head Lamp | Model S/X 2022.03 | | HL31 | Head Lamp | Model 3 Uplevel Headlamps | | HL32 | Matrix Headlights 2021 | Model 3/Y 2021 Uplevel Headlamps | | HL33 | Lamp 1 Headlights 2024 | Model 3 2024 Headlamps | | HL34 | Lamp 1 Headlights 2025 | Model Y 2025 Headlamps | | HP00 | No HPWC Ordered | | | HP01 | HPWC Ordered | | | HP30 | No heat pump assembly | Model 3 Standard+ China made | | HP31 | Heat pump assembly | Model 3 | | I36M | Rear Drive Unit Inverter 600A Mosfet | Model 3 DM/LR | | I38M | Rear Drive Unit Inverter 800A Mosfet | Model 3 Std+, Performance | | IBB0 | All Black Interior | Model 3 Old Door Trim | | IBB1 | All Black Interior | Model 3 New Door Trim (Since Q1 2021) | | IC00 | Black Colorway | Model S/X (Since Q2 2021) | | IC01 | White Colorway Interior | Model S/X (Since Q4 2021) | | IC02 | Cream Colorway Interior | Model S/X (Since Q2 2021) | | ID00 | Ebony Wood Decor | Model S/X (Since Q2 2021) | | ID02 | All Black Premium Interior with Carbon Fiber Décor? | Model S/X (Since Q4 2021) | | ID03 | | Model S/X (Since Q2 2021) | | ID3A | Interior White Aluminum | Model 3/Y | | ID3W | Interior Wood Decor | Model 3/Y | | IDBA | Dark Ash Wood Decor | | | IDBO | Figured Ash Wood Decor Burl Open Pore décor | | | IDCF | Carbon Fiber Decor | | | IDHG | IP Décor Horizontal Gloss | | | IDHM | Matte Obeche Wood Decor | | | IDOK | Oak Decor | | | IDOM | Matte Obeche Wood Decor | | | IDOG | Gloss Obeche Wood Decor | | | IDLW | Lacewood Decor | | | IDPB | Piano Black Decor | | | IN3BB | All Black Partial Premium Interior | | | IBW0 | Black and White Interior | Model 3 Old Door Trim | | IBW1 | Black and White Interior | Model 3 New Door Trim (Since Q1 2021) | | IN3BW | Black and White Interior | Model 3 Interior | | IN3PB | All Black Premium Interior | Model 3 Interior | | IN3PW | All White Premium Interior | Model 3 Interior | | IBE00 | Wood Décor & Black Interior | Model S Refresh 2021 | | ICW00 | Wood Décor & Cream Interior | Model S Refresh 2021 | | IWW00 | Wood Décor & Black and White Interior | Model S Refresh 2021 | | IBC00 | Carbon Fiber Décor & Black Interior | Model S Refresh 2021 | | IWC00 | Carbon Fiber Décor & Black and White Interior | Model S Refresh 2021 | | ICC00 | Carbon Fiber Décor & Cream Interior | Model S Refresh 2021 | | INBBW | White Interior | | | INB3C | Premium beige interior with oak wood finishes | Model X | | INBC3W | Premium black and white interior with Carbon Fiber decor | Model X | | INPB0 | All Black Interior with Wood in door panel | Model Y | | INPB1 | All Black Interior | Model Y | | INPW0 | Black and White Interior with Wood in door panel | Model Y | | INPW1 | Black and White Interior | Model Y | | INBFP | Classic Black Interior | | | INBPP | Black Interior | | | INBPW | White Seats Interior | | | INBTB | Multi-Pattern Black Interior | | | INFBP | Black Premium Interior | | | INLPC | Cream Interior | | | INLPP | Black / Light Headliner Interior | | | INWPT | Tan Interior | | | INYPB | All Black Premium Interior | | | INYPW | Black and White Premium Interior | | | IL31 | Interior Ambient Lighting Interior | Model 3/Y with Premium Interior | | ILF0 | Ambient Lighting Disabled | Model 3 Standard+ | | ILF1 | Ambient Lighting Enabled | Model 3 with Premium Interior | | IPB0 | Black Interior | Model 3 Interior (Left Hand Drive) | | IPB1 | Black Interior | Model 3 Interior (Right Hand Drive) | | IPB2 | Black Interior | Model 3 Interior (Left Hand Drive) | | IPB3 | Black Interior | Model 3 Interior (Right Hand Drive) | | IPW0 | White Interior | Model 3 Interior (Left Hand Drive) | | IPW1 | White Interior | Model 3 Interior (Right Hand Drive) | | IPW2 | White Interior | Model 3 Interior (Left Hand Drive) | | IPW3 | White Interior | Model 3 Interior (Right Hand Drive) | | IVBPP | All Black Interior | | | IVBSW | Ultra White Interior | | | IVBTB | All Black Interior | | | IVLPC | Vegan Cream Interior | | | IX00 | No Extended Nappa Leather Trim | | | IX01 | Extended Nappa Leather Trim | | | LLP1 | License Plate Liftgate Type NA Liftgate | | | LLP2 | License Plate Liftgate Type EU Liftgate | | | LP00 | Lighting Package | No Lighting Package | | LP01 | Lighting Package | Premium Interior Lighting | | LS01 | Mfg Line Shanghai - Phase 1 | Latest 2021 Model 3/Y Perf | | LS02 | Mfg Line Shanghai - Phase 2.2 | Latest 2021 Model 3/Y DM | | LT00 | Vegan interior | | | LT01 | Standard interior | | | LT03 | interior | Common Lower Trim | | LT1B | Lower Trim | Lower Trim | | LT3W | Lower Trim | | | LT4B | LT4B | | | LT4C | LT4C | | | LT4W | LT4W | | | LT5C | LT5C | | | LT5P | Black PUR Premium Lower Trim w/ Black IP | | | LT5W | Lower Trim Black PUR with White interior | 2020 Model S | | LT6P | Black PUR Lower Trim with Performance Stitching | | | LT6W | White Base Lower Trim | | | LTBC | Lower Trim PUR Cream with Black Carpets | | | LTPB | Lower Trim PUR Black | | | LTPW | Lower Trim PUR White | | | LTSB | Lower Trim Standard Black | Model 3 Standard+ | | LVB0 | 12V Acid Low voltage battery | | | LVB1 | 15V Li-Ion Low voltage battery | | | LVB2 | CATL 16V Battery | Model 3/Y (GigaBerlin/China) | | M301 | Generation 1 of 2022 | AMD Ryzen? | | M302 | Generation 2 of 2024 | Model 3 Restyle | | ME01 | Memory Seats | | | ME02 | Seat Memory | Seat Memory LHD Driver | | MI00 | 1st Generation Production | Model 3 (2019), Model S (Nosecone), MX(2016), MY(2021) | | MI01 | 2nd Generation Production | Model 3 (2020), Model S (2016 Facelit), Model X (2017) | | MI02 | 3rd Generation Production | Model 3 (2021), Model X (2017) | | MI03 | 4th Generation Production | Model S (2018), Model X (2018) | | MI04 | 5th Generation Production | Model S (2019/2020), Model X (2020) | | MI07 | 8th Generation Production | Model S (2021), Model X (2021) | | MR30 | Tech Package - Mirror -YES | Base Mirrors (MIC Model 3 CN) | | MR31 | Tech Package - Mirror -YES | Uplevel Mirrors | | MS03 | Model S | This vehicle is a Model S | | MS04 | Model S | This vehicle is a Model S | | MS05 | Model S | This vehicle is a Model S | | MS06 | Model S | Plaid 2021 | | MT300 | Model 3 Standard Range Rear-Wheel Drive | | | MT301 | Model 3 Standard Range Plus Rear-Wheel Drive | | | MT302 | Model 3 Long Range Rear-Wheel Drive | | | MT303 | Model 3 Long Range All-Wheel Drive | | | MT304 | Model 3 Long Range All-Wheel Drive Performance | | | MT305 | Model 3 Mid Range Rear-Wheel Drive | | | MT307 | Model 3 Mid Range Rear-Wheel Drive | | | MT308 | Model 3 Standard Range Plus Rear-Wheel Drive | 2019 Refresh | | MT309 | Model 3 Standard Range Plus Rear-Wheel Drive | 2019 Refresh | | MT310 | Model 3 Long Range All-Wheel Drive | | | MT311 | Model 3 Long Range All-Wheel Drive Performance | | | MT314 | Model 3 Standard Range Plus Rear-Wheel Drive | 2021 Refresh | | MT315 | Model 3 Long Range All-Wheel Drive | 2021 Refresh | | MT316 | Model 3 Long Range All-Wheel Drive | 2021 Refresh | | MT317 | Model 3 Long Range All-Wheel Drive Performance | 2021 Refresh | | MT320 | Model 3 Standard Range Plus Rear-Wheel Drive | 2021 Refresh | | MT322 | Model 3 Standard Range Plus Rear-Wheel Drive | 2021 Refresh | | MT321 | Model 3 Long Range All-Wheel Drive | 2021 Refresh | | MT323 | Model 3 Long Range All-Wheel Drive | 2021 Refresh | | MT324 | Model 3 Long Range All-Wheel Drive | 2021 Refresh | | MT325 | Model 3 Long Range All-Wheel Drive Performance | 2022 Refresh | | MT328 | Model 3 Long Range All-Wheel Drive | 2022 Refresh | | MT331 | Model 3 Standard Range Plus | 2020 Refresh (BT35 Battery) | | MT332 | Model 3 Standard Range Plus | 2020 Refresh (BT35 Battery) | | MT333 | Model 3 Standard Range Plus | 2020 Refresh (BT34 Battery) | | MT334 | Model 3 Long Range Rear-Wheel Drive | 2020 Refresh (BT38 Battery) | | MT336 | Model 3 Standard Range Plus Rear-Wheel Drive | 2020 Refresh | | MT337 | Model 3 Standard Range Plus Rear-Wheel Drive | 2021 Refresh | | MT340 | Model 3 Long Range All-Wheel Drive Performance | 2022 Refresh | | MTS01 | Model S Standard Range | | | MTS17 | Model S Standard Range | 2023 Refresh | | MTS03 | Model S Long Range | | | MTS04 | Model S Performance | | | MTS05 | Model S Long Range | | | MTS06 | Model S Performance | | | MTS07 | Model S Long Range Plus | | | MTS08 | Model S Performance | | | MTS09 | Model S Plaid+ | 2021 Refresh | | MTS10 | Model S Long Range | 2021 Refresh | | MTS11 | Model S Plaid | 2021 Refresh | | MTS12 | Model S Plaid | 2022 Refresh | | MTS13 | Model S Dual Motor All-Wheel Drive | 2022 Refresh | | MTS14 | Model S Plaid Tri Motor All-Wheel Drive | 2022 Refresh | | MTX01 | Model X Standard Range | | | MTX17 | Model X Standard Range | 2023 Refresh | | MTX03 | Model X Long Range | | | MTX04 | Model X Performance | | | MTX05 | Model X Long Range Plus | | | MTX06 | Model X Performance | | | MTX07 | Model X Long Range Plus | | | MTX08 | Model X Performance | | | MTX09 | Model X Plaid+ | 2021 Refresh | | MTX10 | Model X Long Range | 2021 Refresh | | MTX11 | Model X Plaid | 2021 Refresh | | MTX12 | Model X Plaid | 2021 Refresh | | MTX13 | Model X Plaid | 2021 Refresh | | MTX14 | Model X Plaid Tri Motor All-Wheel Drive | 2022 Refresh | | MTY01 | Model Y Standard Range Rear-Wheel Drive | | | MTY02 | Model Y Long Range Rear-Wheel Drive | | | MTY03 | Model Y Long Range All-Wheel Drive | | | MTY04 | Model Y Long Range All-Wheel Drive Performance | | | MTY05 | Model Y Long Range All-Wheel Drive Performance | | | MTY06 | Model Y Long Range All-Wheel Drive | | | MTY07 | Model Y Long Range All-Wheel Drive | | | MTY09 | Model Y Long Range All-Wheel Drive | | | MTY11 | Model Y Long Range All-Wheel Drive | | | MTY12 | Model Y Long Range All-Wheel Drive Performance | | | MTY13 | Model Y Long Range Standard Range Rear-Wheel Drive | 2023 No USS? | | MTY14 | Model Y Long Range All-Wheel Drive | | | MY00 | | Model Y Berlin | | MY01 | | Model Y Austin? | | MY02 | | Model Y Berlin? | | MX06 | | Model X 2021+ | | OSSB | Safety CA Black | | | OSSW | Safety CA White | | | P3WS | Pedestrian warning speaker | | | P85D | P85D | | | PA00 | No Paint Armor | | | PBCW | Solid White Color | | | PBSB | Solid Black Color | | | PBT85 | Performance 85kWh | | | PC30 | No Performance Chassis | | | PC31 | Performance Chassis | | | PF00 | No Performance Legacy Package | | | PF01 | Performance Legacy Package | | | PI00 | No Premium Interior | | | PI01 | Premium Upgrades Package | | | PK00 | Parking Sensors | No Parking Sensors | | PMAB | Anza Brown Metallic Color | | | PMBL | Obsidian Black Multi-Coat Color | | | PMMB | Monterey Blue Metallic Color | | | PMNG | Midnight Silver Metallic Color | | | PMSG | Green Metallic Color | | | PMSS | San Simeon Silver Metallic Color | | | PMTG | Dolphin Grey Metallic Color | | | PN00 | Quicksilver Color | | | PN01 | Stealth Grey Color | | | PPMR | Red Multi-Coat Color | | | PP01 | Pedestrian Protection Ped Pro R127 Compliant | Model S 2020+ Eu | | PP02 | Pedestrian Protection Ped Pro R127 Compliant | Model 3 2021 Eu | | PPSB | Deep Blue Metallic Color | | | PPSR | Signature Red Color | | | PPSW | Pearl White Multi-Coat Color | | | PPTI | Titanium Metallic Color | | | PL30 | No Aluminum Pedal | Model 3/Y | | PL31 | Performance Aluminum Pedals | Model 3/Y | | PR00 | Midnight Cherry Red Color | | | PR01 | Ultra Red Color | | | PRM30 | Partial Premium Interior | | | PRM31 | Premium Interior | | | PRM3S | Standard Interior | | | PRMY1 | Premium Interior | | | PS00 | No Parcel Shelf | | | PS01 | Parcel Shelf | | | PT01 | Trunk Power trunk | Model 3 | | PT00 | Standard trunk | | | PX00 | No Performance Plus Package | | | PX01 | Performance Plus | | | PX4D | 90 kWh Performance | | | PX6D | Zero to 60 in 2.5 sec | | | PW01 | Pedestrian warning speaker | Superhorn | | PWS0 | | Model S 10.2020 | | QLBS | Black Premium Interior | | | QLFC | Cream Premium Interior | | | QLFP | Black Premium Interior | | | QLFW | White Premium Interior | | | QLPW | White Premium Interior | | | QLWS | White Premium Interior | | | QNET | Tan NextGen | | | QPBT | Black Textile Interior | | | QPMP | Black seats | | | QTBS | Black Premium Interior | | | QTBW | White Premium Seats | | | QTFC | Cream Premium Interior | | | QTFP | Black Premium Seats | | | QTFW | White Premium Interior | | | QTPB | Black Leather Tesla Premium Seats | | | QTPC | Cream Premium Seats | | | QTPP | Black Premium Seats | | | QTPT | Tan Premium Seats | | | QTTB | Multi-Pattern Black Seats | | | QTWS | White Premium Interior | | | QVBM | Multi-Pattern Black Seats | | | QVPC | Vegan Cream Seats | | | QVPP | Vegan Cream Seats | | | QVSW | White Tesla Seats | | | QXMB | Black Leather Seat | | | RA00 | No Radar Module Sensor, 7 Pin Perpendicular | Model 3/Y/S/X | | RA01 | Radar Module Sensor, 7 Pin Perpendicular | Model 3/Y | | RA02 | HD Radar Module Sensor, Phoenix | Model S/X 02.2023 | | RBMB | Rear Brake Mando Black | Model X | | RBMR | Rear Brake Mando Red | Model S | | RCX0 | No Rear Console | | | RCX1 | Rear Console | | | RD01 | Low Current MOSFET PM216 Rear Drive Unit (600A) | Model 3 LR/DM (Fremont) | | RD02 | High Current MOSFET PM216 Rear Drive Unit (800A) | Model 3 Std+, Perf | | RD03 | Rear Drive Unit LR | Model S/X 2021 (Rear drive unit) | | RD04 | Rear Drive Unit Plaid | Model S/X 2021 (Rear drive unit) | | RD05 | Low Current MOSFET PM228 Rear Drive Unit | Model 3/Y LR/DM | | RD06 | High Current MOSFET PM228 Rear Drive Unit | Model 3/Y 2022 (Perf version) | | RD07 | 4DU Rear Drive Unit | Model 3/Y 2023 | | RD10 | 4DU Rear Drive Unit uncorked, 950A, CN | Model 3 2024 (Perf version from China) | | RD11 | 4DU Rear Drive Unit uncorked, 950A, US/DE | Model 3 2024 (Perf version) | | RDU2 | Rear large drive unit with elec. oil pump(stator <5kg) | Model S/X 2020 (Perf version) | | RDU3 | Rear small drive unit | Model S/X 2015-2017+- (DM version) | | RDU4 | Rear small drive unit with elec. oil pump(stator <5kg) | Model S/X 2020 (Plus version) | | RF3G | Glass Roof | Model 3/Y | | RFBK | Black Roof | Model S | | RFBC | Body Color Roof | Model S | | RFFG | Glass Roof | Model S 2017 Production Refresh | | RFFR | Fixed Glass Roof (roof rack compatible) | Model S 2020 | | RFPO | All Glass Panoramic Roof | Model S 2015 Production Refresh | | RFP2 | Sunroof | Model S 2016 Production Refresh | | RFPX | Glass Roof | Model X | | RNG0 | Standard Battery Range | Model 3 Standard+ | | RL00 | Rear tail lights | Model S/X 2021 | | RL01 | Rear tail lights (Larger for CCS) | Model S/X 2022.March 473k+- | | RL31 | Rear lights (EU) | Model 3 EU | | RL32 | Rear lights (Global) | Model 3/Y (AWD) | | RL33 | Rear lights Lamp 2 | Model 3 2024 Restyle | | RS3H | Second Row Seat Rear Seats (Heated) | Model 3/Y with Premium Interior | | RSF0 | Rear Heated Seats Disabled | Model 3/Y without Premium Interior | | RSF1 | Rear Heated Seats | Model 3/Y with Premium Interior | | RU00 | No Range Upgrade | | | S01B | Black Textile Seats | | | S02B | Seat | BLK Leather | | S02P | S02P | | | S02T | Seat | Tan Leather | | S02W | White Seats | | | S07W | White Seats | | | S25B | | Model S 2015 | | S31B | S31B | | | S32C | S32C | | | S32P | Black PUR Seats | Model S 2019 | | S32W | S32W | | | S3PB | Seat Black PUR Premium Seats | | | S3PW | Seat White PUR Premium Seats | | | S42C | Seat Cream Plenum Seats | | | S42P | Seat Black Plenum Seats | | | S42W | Seat White Plenum Seats | | | SA3P | Seat Adjustment - Power | Model 3/Y | | SC00 | No access to Supercharger Network | | | SC01 | Unlimited Free Supercharging Enabled | Transfers to the next owner via private sale | | SC04 | Pay Per Use Supercharging | | | SC05 | Unlimited Free Supercharging Currently Enabled | Not transferable to the next owner | | SC06 | Time Bound Unlimited Free Supercharging | | | SG01 | Steering Gear Single Chip | Model 3/Y CN MIC | | SG02 | Steering Gear Dual Chip | Model 3/Y CN MIC (2023) | | SLR0 | No Rear Spoiler | | | SLR1 | Carbon Fibre Spoiler | | | SP00 | No Security Package | | | SP01 | Security Package | | | SPT31 | Performance Upgrade | Model 3 | | SPTY1 | Performance Upgrade | Model Y | | SR01 | Standard 2nd row | Second Row Seat | | SR04 | Second Row Seat | Six Seat Interior | | SR05 | 60/40 Bench Second Row Seat | Second Row Seat (Model Y China) | | SR06 | Seven Seat Interior | | | SR07 | Second Row Seats with Comfort Improvements | | | ST00 | Non-leather Steering Wheel | | | ST01 | Non-heated Leather Steering Wheel | | | ST02 | Heated Leather Steering Wheel | | | ST03 | Regular Steering Wheel | Model X/S Plaid (removed) | | ST0Y | Yoke Steering Wheel | Model X/S Plaid | | ST30 | Base Steering Wheel | Model 3 Standard+ | | ST31 | Steering Wheel | Premium Steering Wheel | | ST33 | Steering Wheel - Round, PUR Heated | Premium Steering Wheel | | STCP | Steering Wheel | Steering Column (Power) | | STY5S | Five Seat Interior | | | STY7S | Seven Seat Interior | | | SU00 | Standard Suspension | | | SU01 | Smart Air Suspension | Model S/X ?-15apr2019 | | SU03 | Suspension Update | Model S/X 19apr2019-2021 | | SU04 | Active Suspension | Model 3 2024 (Perf) | | SU3C | Coil Spring Suspension | | | SWF0 | | Model 3/Y | | SWF1 | Steering Wheel FW Enabled | Model 3/Y | | T30A | Tires Model 3 Perf 2024 | 20" Split Fit Tire | | T30S | Tires Model 3 Perf 2024 | 20" Summer Pirelli R20 235/35/92Y China | | T38Q | Tires M3 | 18" Hankook Ventus S1 A/S | | T3CA | Tires M3 | 19" Continental All Season, Square | | T3HS | Tires M3 | 19" Hankook Summer Square | | T3MA | Tires M3 | 18" Michelin All Season, Square | | T3MC | Tires M3 | 18" China made | | T3P3 | Tires M3 | 20" Michelin PS4 Summer | | T3PS | Tires M3 | 19" PIRELLI PZ4? | | TCU4 | 4G TCU | Model S/X | | TD00 | Tear Down NON-GLIDER | Model S/X | | TIC3 | Tires MS | 21 | | TIC4 | Tires MX | 20" all-weather tires | | TIC6 | Tires MS | 21" Continental CSC5P Staggered | | TIG2 | Summer Tires | | | TIG5 | Goodyear Eagle Touring | | | TIM7 | Summer Tires | 20" MX | | TIM8 | Michelin PS4S | | | TIM9 | Michelin Pilot Sport 4 | | | TIMP | Tires | Michelin Primacy 19" Tire | | TIP0 | All-season Tires | Pirelli Scorpion Zero Asimmetrico 22” Tire | | TM00 | Model Trim | General Production Series Vehicle | | TM02 | General Production Signature Trim | | | TM0A | ALPHA PRE-PRODUCTION NON-SALEABLE | | | TM0B | BETA PRE-PRODUCTION NON-SALEABLE | | | TM0C | PRE-PRODUCTION SALEABLE | | | TP00 | No AP? | | | TP01 | No Technology Package | | | TP02 | Tech Package with Autopilot | | | TP03 | Tech Package with Enhanced Autopilot | | | TR00 | No Rear Facing Seats | | | TR01 | Third Row Seating | | | TRA1 | Third Row HVAC | | | TS10 | 21" Michelin PS4S | Model S/X 2021 | | TS90 | 19" Continental ProContact RX | Model S/X 2022 | | TS91 | | Model S/X 2021 | | TSHP | Heat Pump Thermal Assembly | Model Y 2021 (China) | | TW00 | No Tow Package | | | TW01 | Tow Package | | | TX02 | 20" Michelin Pilot Sport EV | Model X 2022 | | TX20 | | Model X 2021 | | TY0A | 20" All Season Square | Model Y 2022 | | TY0C | 20” Michelin, Pilot Sport EV | Model Y 2023 | | TY1A | 21" | Model Y 2022 | | TY1D | 21" P Zero | Model Y 2022 | | TY9A | Tires MY | Tires 19" All Season Square | | TY9B | 19” Summer Square - Dual Sourcing Hankook | Model Y 2023 | | TY9K | 19” Kumho Majesty 9 Solus TA91 | Model Y 2023 China | | TY9P | 19” Pirelli Scorpion M+S | Model Y 2023 | | UM01 | Universal Mobile Charger - US Port (Single) | | | UT3P | Suede Grey Premium Headliner | Ultrasuede Grey | | UTAB | Black Alcantara Headliner | | | UTAW | Light Headliner | | | UTMF | Headliner | | | UTPB | Dark Headliner | | | UTSB | Black Ultra-Suede Upper Trim Headliner | | | UTZW | Light Headliner | | | US00 | No Ultrasonic Sensor | No Ultrasonic Sensor (m3/my 2023) | | US02 | Ultrasonic Sensor | Test Ultrasonic Sensor (m3/my 2023 Berlin) | | USSB | Safety | Safety US Black | | USSW | US Safety Kit White | | | VC00 | MCU Intel Atom | Model 3/Y (China) | | VC01 | MCU AMD Ryzen | Model 3/Y first found on MYJan2022 | | VS01 | Vent Enabled | Model 3 2024 (Perf) | | W30P | 20" Performance Wheels | Model 3 2024 (Perf) | | W32P | 20" Performance Wheels | Model 3 | | W32D | 20" Gray Performance Wheels | Model 3 | | W33D | 20" Black Performance Wheels 2021 | Model 3 | | W38A | 18" Photon Wheels | Model 3 Highland | | W38B | 18" Aero Wheels | For the Model 3 and Model Y | | W39B | 19" Sport Wheels | | | W39S | 19W Nova Wheels | Model 3 Highland | | W40B | 18" Wheels | Model 3 2021 | | W41B | 19" Wheels | Model 3 2022 | | WPF1 | Wiper Heated Firmware Enabled | | | WR00 | No Wrap | | | WR02 | Wrap 2 (Tilburg bound) | | | WS90 | 19" Tempest Wheels | Model S Refresh 2021 | | WT19 | 19" Wheels | | | WS10 | 21" Arachnid Wheels | Model S Refresh 2021 | | WT20 | 20" Silver Slipstream Wheels | | | WT22 | 22" Silver Turbine Wheels | | | WTAB | 21" Black Arachnid Wheels | | | WTAS | 19" Silver Slipstream Wheels | | | WTD2 | 19" Sonic Carbon Slipstream Wheels (8.5 in) | | | WTDS | 19" Grey Slipstream Wheels | | | WTNN | 20" Nokian Winter Tires (non-studded) | | | WTNS | 20" Nokian Winter Tires (studded) | | | WTP2 | 20" Pirelli Winter Tires | | | WTSC | 20" Sonic Carbon Wheels | | | WTSD | 20" Two-Tone Slipstream Wheels | | | WTSG | 21" Turbine Wheels | | | WTSP | 21" Turbine Wheels | | | WTSS | 21" Turbine Wheels | | | WTHX | 20" Turbine Wheels | | | WTTG | 19" Cyclone Wheels | | | WTTB | 19" Cyclone Wheels | | | WTTC | 21" Sonic Carbon Twin Turbine Wheels | 21" Charcol Twin Turbine Wheels (model S) | | WTUT | 22" Onyx Black Wheels | 22" Ultrasonic Turbine wheels | | WTW2 | 19" Nokian Winter Wheel Set | | | WTW3 | 19" Pirelli Winter Wheel Set | | | WTW4 | 19" Winter Tire Set | | | WTW5 | 21" Winter Tire Set | | | WTW6 | 19" Nokian Winter Tires (studded) | | | WTW7 | 19" Nokian Winter Tires (non-studded) | | | WTW8 | 19" Pirelli Winter Tires | | | WTX1 | 19" Michelin Primacy Tire Upgrade | | | WX00 | 20" Cyberstream Wheels | Model X Refresh 2021 | | WX20 | 22" Turbine Wheels | Model X Refresh 2021 | | WXNN | No 20" Nokian Winter Tires (non-studded) | | | WXNS | No 20" Nokian Winter Tires (studded) | | | WXP2 | No 20" Pirelli Winter Tires | | | WXW2 | No 19" Wheels with Nokian Winter Tyres | | | WXW3 | No 19" Wheels with Pirelli Winter Tyres | | | WXW4 | No 19" Winter Tire Set | | | WXW5 | No 21" Winter Tire Set | | | WXW6 | No 19" Nokian Winter Tires (studded) | | | WXW7 | No 19" Nokian Winter Tires (non-studded) | | | WXW8 | No 19" Pirelli Winter Tires | | | WY0S | 20" Induction | Model Y 2022 | | WY18B | 18" Aero Wheels | | | WY1S | 21” Uberturbine | Model Y 2022 GigaBerlin | | WY9S | 19" Apollo | Model Y | | WY19B | 19" Sport Wheels | | | WY20P | 20" Performance Wheels | | | X001 | Override: Power Liftgate | | | X002 | Override: Manual Liftgate | | | X003 | Maps & Navigation | | | X004 | Override: No Navigation | | | X007 | Exterior Lights Override: Premium exterior lighting YES | | | X010 | Base Mirrors | | | X011 | Override: Homelink | | | X012 | Override: No Homelink | | | X013 | Override: Satellite Radio | | | X014 | Override: No Satellite Radio | | | X019 | Carbon Fiber Spoiler | | | X020 | No Performance Exterior | | | X021 | No Rear Carbon Fiber Spoiler | | | X024 | Performance Package | Performance Motor | | X025 | No Performance Powertrain | Base Motor | | X026 | Door handle | No light handle | | X027 | Lighted Door Handles | Light handle | | X028 | Battery Badge | Normal Badging | | X029 | Remove Battery Badge | | | X030 | Override: No Passive Entry Pkg | | | X031 | Keyless Entry | Passive Entry Pkg | | X037 | Powerfolding Mirrors | | | X039 | DAB Radio | | | X040 | No DAB Radio | | | X041 | No Auto Presenting Door | | | X042 | Auto Presenting Door | | | X043 | No Phone Dock Kit | | | X044 | Phone Dock Kit | | | YF00 | No Yacht Floor | | | YF01 | Matching Yacht Floor | | | YFCC | Yatcht Floor Front Console, Décor Matched | | | YFFC | Integrated Center Console | | | ZCST | Customer Car | | | ZINV | Inventory vehicle | Car sold from Tesla Inventory | | ZENG | Engineering Car | Test samples from Tesla | # Overview Energy Products API Overview The base URI for all site-specific energy product endpoints is `https://owner-api.teslamotors.com/api/1/energy_sites/{site_id}/`. The `site_id` identifies the energy site installation and can be obtained from the [Energy Products API](/api-basics/products). ## Endpoints {% content-ref url="/pages/AsVTi4aZsG94bJ7yE3Iq" %} [History](/energy-products/energy/history) {% endcontent-ref %} Get historical data about your energy products. {% content-ref url="/pages/ZCymxCfsm6PdTvFHycP1" %} [State](/energy-products/energy/state) {% endcontent-ref %} Retrieve the current state of your energy products. {% content-ref url="/pages/5QfYxObjVnYsXWBgeWtV" %} [Commands](/energy-products/energy/commands) {% endcontent-ref %} Commands to control your energy products. # History These endpoints for retreiving the data about the energy generated or stored by the products at a site, such as the power generated by Solar panels and the energy stored in a Powerwall. The statistics can either be instantaneous power generation/storage in watts at 15 minute intervals for a day, or cumulative energy in kWh generated/stored in a day, week, month, or year. Depending on your equipment, some statistics may be unsupported and always return 0. ## GET `/api/1/energy_sites/{site_id}/history` Retrieves either the power generation/storage (watts) for the previous day, or the cumulative energy generation/storage (kWh) for a specified recent period. ### Request parameters | Field | Type | Example | Description | | -------- | ---------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `kind` | String, required | `power` or `energy` | `power` selects power statistics, in watts, at 15-minute intervals. `energy` selects energy statistics, in kWh, for a specified period. | | `period` | String | `day`, `week`, `month`, or `year` | The time span for energy statistics to cover. | When `kind=power`, the `period` parameter is not required, and is ignored if present. When `kind=energy`, the `period` parameter is required and the value determines the time span of the retrieved data items: | Value | Statistics returned | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `day` | Total kWh for yesterday, and for today up to the current time. | | `week` | Total kWh for each of the past 7 days, not including today. | | `month` |

Total kWh for each of the past 4 weeks, not including the current week.
Weeks are Sunday to Saturday; timestamps are for Saturdays.

| | `year` | Total kWh for each of the past 12 months, not including the current month. | ### Response when `kind=power` ```json { "response": { "serial_number": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "time_series": [ { "timestamp": "2022-05-13T00:00:00-07:00", "solar_power": 0, "battery_power": 0, "grid_power": 0, "grid_services_power": 0, "generator_power": 0 } ] } } ``` The `solar_power` value is the power being generated, in watts, at the given timestamp. To save space, only the first entry is shown in the `time_series` array. In a real response there are many entries in the array: one entry for each 15 minutes, starting at the beginning (midnight) of the previous day and ending at the current time and day. The entries cover 24 - 48 hours, depending on when the request is made. Depending on your equipment, some nighttime samples may be omitted if they are all zeroes. ### Response when `kind=energy` ```json { "response": { "serial_number": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "period": "week", "time_series": [ { "timestamp": "2022-05-09T01:00:00-07:00", "solar_energy_exported": 18630, "generator_energy_exported": 0, "grid_energy_imported": 0, "grid_services_energy_imported": 0, "grid_services_energy_exported": 0, "grid_energy_exported_from_solar": 0, "grid_energy_exported_from_generator": 0, "grid_energy_exported_from_battery": 0, "battery_energy_exported": 0, "battery_energy_imported_from_grid": 0, "battery_energy_imported_from_solar": 0, "battery_energy_imported_from_generator": 0, "consumer_energy_imported_from_grid": 0, "consumer_energy_imported_from_solar": 0, "consumer_energy_imported_from_battery": 0, "consumer_energy_imported_from_generator": 0 } ] } } ``` The `solar_energy_exported` value is the energy generated by the solar panels, in kWh. To save space, only the first entry is shown in the `time_series` array. In a real response there are multiple entries in the array, depending on the value of the `period` parameter. For example, if the `period` value is `week`, there are 7 entries, each one representing the energy generated for one day. ## GET `/api/1/energy_sites/{site_id}/calendar_history` Retrieves either the power generation/storage (watts) at 15-minute intervals for a given day, or the energy generation/storage (kWh) for a specified period. ### Request parameters | Field | Type | Example | Description | | ---------- | ------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `kind` | String, required | `power` or `energy` | `power` selects power statistics, in watts, at 15-minute intervals. `energy` selects energy statistics, in kWh, for a specified period. | | `end_date` | Date/time, required | `2022-04-29T14:15:00-07:00` | Specifies the last day for which statistics are retrieved. | | `period` | String | `day`, `week`, `month`, `year`, or `lifetime` | The time span for energy statistics to cover. | | `interval` | String | `15m` | For 15 minute energy intervals when `period` is `day` (raises an error when tested on a number of other period/interval values) | The format for the `end_date` parameter value is "yyyy-mm-ddThh:mm:ss-hh:mm". Specify your local time zone offset for best clarity. Universal time is accepted in the format "yyyy-mm-ddThh:mm:ssZ", but the time is converted to your local time zone, which could also change the date. When `kind=power`, the `period` parameter is not required, and is ignored if present. When `kind=energy`, the `period` parameter is required and the value determines the time span of the retrieved data items: | Value | Statistics returned | | ---------- | ------------------------------------------------------------------------------------------ | | `day` | Total kWh for the day specified by `end_date`. | | `week` | Total kWh for each day from the previous Monday to, and including, `end_date`. | | `month` | Total kWh for each day from the first of the month to, and including,`end_date`. | | `year` | Total kWh for each calendar month from the previous January to, and including, `end_date`. | | `lifetime` | Total kWh for each calendar year from installation to, and including, `end_date`. | `interval` is optional, and can only be used with `day`. So far the only confirmed valid value is `15m`. This returns the daily data in 15 minute increments, and is referred to as the `day/15m` period below. The output of the `energy` requests is a little erratic, with the following behaviours observed in data taken from a single powerwall with a 3 month lifetime: * Calls for the full `day` based periods (`day`, `week`, and `month`, but not the `day/15m` period) typically yield identical results for a given date-time range, with the exception that `month` data can omit a day (and possibly more than one). This occurred only once in the data set, corresponding to misconfigured CT, where the house was reporting energy production rather than draw. The API dropped the odd value from the monthly data, and provided an adjusted value for the weekly and daily data. Adding the adjusted missing day into the monthly cumulative values resulted in identical data for `day`, `week`, and `month` calls. * Output for `year` and `lifetime` periods is similar to, but not equal to, the output from the `day` based periods. Differences between the cumulative energy flows over a 3 month period can be as high as 20-30kWh. The worst case is lifetime home load, which is 34 kWh lower than cumulative daily home load over the lifetime (828 vs 863 kWh). * **However**, output for full and partial days is *mostly* consistent across all period types except the `day/15m`. That is, the same full or partial day output will be reported for all periods for most days in a given date-time range. Based on the cumulative tests discussed above, this conclusion can be extended across fairly long multi-day periods. Inconsistent output corresponds to the differences already highlighted above. Unfortunately, I have not been able to identify the cause/pattern for the inconsistent daily data, nor the calculations that yield the inconsistent values. * Based on a small random sample of days (so these observations and conclusions should be treated with caution): * Up to a variable time in the day, the cumulative `day/15m` output for the component energy types matches the output for the partial `day` up to the same time. * After this time the `day/15m` and `day` component energy types deviate. However, the total imports/exports to/from the system still appear to match. So it appears Tesla may apply slightly different allocations calculations for these two period types. * If `end_date` has a time value of midnight (`00:00:00:000`), then: * For all period types except `day/15m`, the output for day of `end_date` will be zero for all energy component types. * For the `day/15m` period type, output will be reported for all energy component types, but this data appears to be garbage. * There is no clear alignment between the Tesla cloud API data and the data available from the local Powerwall API. For anyone is interested in investigating further (and hopefully resolving some of the differences identified above), this [gist](https://gist.github.com/BuongiornoTexas/3ea2d1df1a569e1a0a4bc79878a8a753) provides a first draft python class for extracting energy data for multiple periods. ### Response when `kind=power` ```json { "response": { "serial_number": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "time_zone_offset": -420, "time_series": [ { "timestamp": "2022-04-29T00:00:00-07:00", "solar_power": 0, "battery_power": 0, "grid_power": 0, "grid_services_power": 0, "generator_power": 0 } ] } } ``` The `solar_power` value is the power being generated, in watts, at the given timestamp. To save space, only the first entry is shown in the `time_series` array. In a real response, there is one entry for each 15 minutes, starting at the beginning (midnight) of the specified date and ending at the specified time. To retrieve a full day's records, specify an ending time after sunset, or 23:45:00. Don't use 00:00:00 for the time, or you'll retrieve an empty list. ### Response when `kind=energy` ```json { "response": { "serial_number": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "period": "year", "time_zone_offset": -420, "time_series": [ { "timestamp": "2021-01-01T01:00:00-07:00", "solar_energy_exported": 152680, "generator_energy_exported": 0, "grid_energy_imported": 0, "grid_services_energy_imported": 0, "grid_services_energy_exported": 0, "grid_energy_exported_from_solar": 0, "grid_energy_exported_from_generator": 0, "grid_energy_exported_from_battery": 0, "battery_energy_exported": 0, "battery_energy_imported_from_grid": 0, "battery_energy_imported_from_solar": 0, "battery_energy_imported_from_generator": 0, "consumer_energy_imported_from_grid": 0, "consumer_energy_imported_from_solar": 0, "consumer_energy_imported_from_battery": 0, "consumer_energy_imported_from_generator": 0 } ] } } ``` `solar_energy_exported` is the energy generated by the solar panels, in kWh. To save space only the first entry in the `time_series` array is shown. In a real response, the number of entries in the array depends on the `period` and `end_date` values. Timestamps in the response represent the start of a period; e.g., monthly statistics for February show a date of February 1st in the timestamp, and daily statistics for February 15th show a timestamp of 1:00 AM on February 15th. # State These endpoints are not yet documented. | Cmd | Endpoint | | --- | ------------------ | | GET | `savings_forecast` | ## GET `api/1/energy_sites/{site_id}/backup_time_remaining` Retrieves backup time remaining if battery were to go off grid. ```json { "response": { "time_remaining_hours": 2.0933370487093645 } } ``` ## GET `/api/1/energy_sites/{site_id}/live_status` Retrieves current system information (e.g. solar production, grid export/import, home consumption, etc.). ### Response for solar panel system without powerwalls ```json { "response": { "solar_power": 7720, "energy_left": 0, "total_pack_energy": 1, "percentage_charged": 0, "battery_power": 0, "load_power": 4517.14990234375, "grid_status": "Unknown", "grid_services_active": false, "grid_power": -3202.85009765625, "grid_services_power": 0, "generator_power": 0, "island_status": "island_status_unknown", "storm_mode_active": false, "timestamp": "2022-07-28T17:11:27Z", "wall_connectors": null } } ``` ## GET `/api/1/energy_sites/{site_id}/site_status` Retrieves general system information. ### Response for solar panel system without powerwalls ```json { "response": { "resource_type": "solar", "asset_site_id": "47d04752-9cf1-4e76-88fb-08839a1c41c4", "solar_power": 7700, "solar_type": "pv_panel", "storm_mode_enabled": null, "powerwall_onboarding_settings_set": null, "sync_grid_alert_enabled": false, "breaker_alert_enabled": false } } ``` ### Response for battery system with powerwalls ```json { "response": { "resource_type": "battery", "site_name": "My Name Here", "gateway_id": "A-123456-987645321S", "energy_left": 21604, "total_pack_energy": 21604, "percentage_charged": 100, "battery_type": "ac_powerwall", "backup_capable": true, "battery_power": 10, "storm_mode_enabled": true, "powerwall_onboarding_settings_set": true, "powerwall_tesla_electric_interested_in": null, "sync_grid_alert_enabled": true, "breaker_alert_enabled": true } } ``` ## GET `/api/1/energy_sites/{site_id}/site_info` Retrieves general system information. ### Response for solar panel system without powerwalls ```json { "response": { "id": "313dbc37-555c-45b1-83aa-62a4ef9ff7ac", "site_name": "My House", "site_number": "2252147638651575", "installation_date": "2022-04-04T15:56:35-07:00", "user_settings": { "storm_mode_enabled": null, "powerwall_onboarding_settings_set": null, "sync_grid_alert_enabled": false, "breaker_alert_enabled": false }, "components": { "solar": true, "solar_type": "pv_panel", "battery": false, "grid": true, "backup": false, "gateway": "gateway_type_none", "load_meter": true, "tou_capable": false, "storm_mode_capable": false, "flex_energy_request_capable": false, "car_charging_data_supported": false, "off_grid_vehicle_charging_reserve_supported": false, "vehicle_charging_performance_view_enabled": false, "vehicle_charging_solar_offset_view_enabled": false, "battery_solar_offset_view_enabled": false, "energy_service_self_scheduling_enabled": true, "rate_plan_manager_supported": true, "configurable": false, "grid_services_enabled": false }, "installation_time_zone": "America/Los_Angeles", "time_zone_offset": -420, "geolocation": { "latitude": 32.53452700000001, "longitude": -112.3463137 }, "address": { "address_line1": "1234 Tesla Solar Ave", "city": "Austin", "state": "TX", "zip": "123456", "country": "US" } } } ``` ### Response for site with Solar Panels and Powerwalls ```json { "response": { "id": "1234567-00-R--EY132456789F4N", "site_name": "My Site Name", "backup_reserve_percent": 100, "default_real_mode": "self_consumption", "installation_date": "2020-12-20T04:00:00-07:00", "user_settings": { "storm_mode_enabled": true, "powerwall_onboarding_settings_set": true, "powerwall_tesla_electric_interested_in": false, "sync_grid_alert_enabled": true, "breaker_alert_enabled": false }, "components": { "solar": true, "solar_type": "pv_panel", "generator": true, "battery": true, "grid": true, "backup": true, "gateway": "hec", "load_meter": true, "tou_capable": true, "storm_mode_capable": true, "flex_energy_request_capable": false, "car_charging_data_supported": false, "off_grid_vehicle_charging_reserve_supported": true, "vehicle_charging_performance_view_enabled": false, "vehicle_charging_solar_offset_view_enabled": false, "battery_solar_offset_view_enabled": true, "solar_value_enabled": true, "energy_value_header": "Energy Value", "energy_value_subheader": "Estimated Value", "energy_service_self_scheduling_enabled": true, "show_grid_import_battery_source_cards": true, "set_islanding_mode_enabled": true, "wifi_commissioning_enabled": true, "backup_time_remaining_enabled": true, "battery_type": "ac_powerwall", "configurable": true, "grid_services_enabled": false, "edit_setting_permission_to_export": true, "edit_setting_grid_charging": true, "edit_setting_energy_exports": true }, "version": "23.4.2-1 f8e490", "battery_count": 2, "tou_settings": { "optimization_strategy": "economics", "schedule": [ { "target": "off_peak", "week_days": [1, 0], "start_seconds": 0, "end_seconds": 0 } ] }, "nameplate_power": 10000, "nameplate_energy": 27000, "installation_time_zone": "America/Los_Angeles", "off_grid_vehicle_charging_reserve_percent": 75, "max_site_meter_power_ac": 1000000000, "min_site_meter_power_ac": -1000000000, "geolocation": { "latitude": 18.339148, "longitude": -67.241601 } } } ``` ## GET `/api/1/energy_sites/rate_tariffs` Retrieves tarriff IDs for utility companies. Only 4 of the 233 entries are shown below. ### Response for solar panel system without powerwalls ```json { "response": [ { "tariffID": "AE-R-CS", "description": "Residential - Community Solar", "utility": "Austin Energy", "country": "US", "state": "TX" }, { "tariffID": "AE-R-VOS", "description": "Residential - Value of Solar", "utility": "Austin Energy", "country": "US", "state": "TX" }, { "tariffID": "APS-ET-1", "description": "Residential - Time of Use, Time Advantage, 9pm - 9 am", "utility": "Arizona Public Service Co", "country": "US", "state": "AZ" }, { "tariffID": "XCEL-RE-TOU", "description": "Residential - Energy, Time of Use", "utility": "Xcel Energy - Colorado", "country": "US", "state": "CO" } ], "count": 233 } ``` ## GET `/api/1/energy_sites/{site_id}/programs` Retrieves energy site program information. ### Response for solar panel system without powerwalls ```json { "response": { "programs": [] } } ``` ## GET `api/1/energy_sites/{site_id}/tariff_rate` Retrieves the user defined Utility Rate Plan used for Time-Based Control mode. It looks like this endpoint is updated every 30 minutes. ```json { "response": { "name": "Amber", "utility": "Amber", "daily_charges": [ { "amount": 0, "name": "Charge" } ], "demand_charges": { "ALL": { "ALL": 0 }, "Summer": {}, "Winter": {} }, "energy_charges": { "ALL": { "ALL": 0 }, "Summer": { "ON_PEAK": 0.43, "PARTIAL_PEAK": 0.43, "OFF_PEAK": 0.01 }, "Winter": {} }, "seasons": { "Summer": { "fromDay": 1, "toDay": 31, "fromMonth": 1, "toMonth": 12, "tou_periods": { "ON_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 5, "fromMinute": 30, "toHour": 7, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 17, "fromMinute": 0, "toHour": 20, "toMinute": 0 } ], "PARTIAL_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 7, "fromMinute": 0, "toHour": 10, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 15, "fromMinute": 0, "toHour": 17, "toMinute": 0 } ], "OFF_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 10, "fromMinute": 0, "toHour": 10, "toMinute": 30 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 10, "fromMinute": 30, "toHour": 15, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 20, "fromMinute": 0, "toHour": 5, "toMinute": 30 } ] } }, "Winter": { "fromDay": 0, "toDay": 0, "fromMonth": 0, "toMonth": 0, "tou_periods": {} } }, "sell_tariff": { "name": "Amber", "utility": "Amber", "daily_charges": [ { "amount": 0, "name": "Charge" } ], "demand_charges": { "ALL": { "ALL": 0 }, "Summer": {}, "Winter": {} }, "energy_charges": { "ALL": { "ALL": 0 }, "Summer": { "ON_PEAK": 0.3, "PARTIAL_PEAK": 0.1, "OFF_PEAK": 0.01 }, "Winter": {} }, "seasons": { "Summer": { "fromDay": 1, "toDay": 31, "fromMonth": 1, "toMonth": 12, "tou_periods": { "ON_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 5, "fromMinute": 30, "toHour": 7, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 17, "fromMinute": 0, "toHour": 20, "toMinute": 0 } ], "PARTIAL_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 7, "fromMinute": 0, "toHour": 10, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 15, "fromMinute": 0, "toHour": 17, "toMinute": 0 } ], "OFF_PEAK": [ { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 10, "fromMinute": 0, "toHour": 10, "toMinute": 30 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 10, "fromMinute": 30, "toHour": 15, "toMinute": 0 }, { "fromDayOfWeek": 0, "toDayOfWeek": 6, "fromHour": 20, "fromMinute": 0, "toHour": 5, "toMinute": 30 } ] } }, "Winter": { "fromDay": 0, "toDay": 0, "fromMonth": 0, "toMonth": 0, "tou_periods": {} } } } } } ``` # Commands These endpoints are not yet documented. | Cmd | Endpoint | | ---- | ----------------------------------- | | POST | `backup` | | POST | `off_grid_vehicle_charging_reserve` | | POST | `site_name` | | POST | `operation` | | POST | `grid_import_export` | | POST | `time_of_use_settings` | | POST | `command` | | POST | `program` | | POST | `event` | | POST | `preference` | ## POST `api/1/energy_sites/{site_id}/backup` Set the battery backup reserve energy percentage for grid outages. ### Parameters | Parameter | Example | Description | | ------------------------ | ------- | ---------------------------------- | | backup\_reserve\_percent | 75 | The percentage for backup reserve. | ### Response ```json { "response": { "code": 201, "message": "Updated" } } ``` ## POST `api/1/energy_sites/{site_id}/site_name` Set your energy site name. ### Parameters | Parameter | Example | Description | | ---------- | ------------ | --------------------- | | site\_name | Wardenclyffe | New energy site name. | ### Response ```json { "response": { "code": 201, "message": "Updated" } } ``` ## POST `api/1/energy_sites/{site_id}/storm_mode` Enable or disable Storm Watch. ### Parameters | Parameter | Example | Description | | --------- | ------- | -------------------------------- | | enabled | true | If Storm Watch should be enabled | ### Response ```json { "response": { "code": 201, "message": "Updated" } } ``` # Endpoints File The latest endpoints file as of version 4.13.3 of the mobile apps is located here: