# smartcar

## Docs

- [Make Specific Endpoints](https://smartcar.com/docs/api-reference/about-brand-specific)
- [All Vehicles](https://smartcar.com/docs/api-reference/all-vehicles): Returns a paged list of all vehicles connected to the application for the current authorized `user`.
- [API Errors](https://smartcar.com/docs/api-reference/api-errors)
- [SDKs](https://smartcar.com/docs/api-reference/api-sdks)
- [Permissions](https://smartcar.com/docs/api-reference/application-permissions): Returns a list of the permissions that have been granted to your application in relation to this vehicle.
- [Audi: Charge Status](https://smartcar.com/docs/api-reference/audi/get-charge): Returns all charging related data for an Audi vehicle.
- [Auth Code Exchange](https://smartcar.com/docs/api-reference/authorization/auth-code-exchange): To interact with the Smartcar API, you will need to exchange your authorization code from the [Connect redirect](/docs/connect/handle-the-response) for an access token.
- [Token Refresh](https://smartcar.com/docs/api-reference/authorization/token-refresh): Your access token will expire 2 hours after it is issued. When this happens, your application can retrieve a new one by using the `refresh_token` returned in the [auth code exchange](/docs/api-reference/authorization/auth-code-exchange) or prior token refresh.
- [Batch](https://smartcar.com/docs/api-reference/batch): Returns a list of responses from multiple Smartcar `GET` endpoints, all combined into a single request.
- [Charge Records](https://smartcar.com/docs/api-reference/bmw/get-charge-records): Returns data associated with completed charging sessions for a vehicle. Limited to the last 30 days or when the owner first granted your application access, which ever is shorter.
- [By Region and Make](https://smartcar.com/docs/api-reference/compatibility/by-region-and-make)
- [By VIN](https://smartcar.com/docs/api-reference/compatibility/by-vin)
- [Lock & Unlock](https://smartcar.com/docs/api-reference/control-lock-unlock): Lock or unlock the vehicle.
- [Start & Stop Charge](https://smartcar.com/docs/api-reference/evs/control-charge): Start or stop the vehicle charging.
- [Battery Capacity](https://smartcar.com/docs/api-reference/evs/get-battery-capacity): Returns the rated capacity of the electric vehicle's high voltage battery.
- [Battery Level](https://smartcar.com/docs/api-reference/evs/get-battery-level): Returns the state of charge and the remaining range of an electric vehicle's high voltage battery.
- [Charge Limit](https://smartcar.com/docs/api-reference/evs/get-charge-limit): Returns the charge limit configuration for the vehicle.
- [Charge Status](https://smartcar.com/docs/api-reference/evs/get-charge-status): Returns the charge status for the vehicle.
- [Charge Limit](https://smartcar.com/docs/api-reference/evs/set-charge-limit): Set the  charge limit of an electric vehicle.
- [Charge Schedule by Location](https://smartcar.com/docs/api-reference/ford/get-charge-schedule-by-location): Returns all saved charging locations for a vehicle and their associated charging limits, schedules and configurations.
- [Charge Schedule by Location](https://smartcar.com/docs/api-reference/ford/set-charge-schedule-by-location): Set all schedules for the specified charging location.
- [Oil Life](https://smartcar.com/docs/api-reference/get-engine-oil-life): Returns the remaining life span of a vehicle’s engine oil.
- [Fuel Tank](https://smartcar.com/docs/api-reference/get-fuel-tank): Returns the status of the fuel remaining in the vehicle’s fuel tank.
- [Location](https://smartcar.com/docs/api-reference/get-location): Returns the vehicle's last known location.
- [Lock Status](https://smartcar.com/docs/api-reference/get-lock-status): Returns the lock status for a vehicle and the open status of its doors, windows, storage units, sunroof and charging port where available.
- [Odometer](https://smartcar.com/docs/api-reference/get-odometer): Returns the vehicle’s last known odometer reading.
- [Service History](https://smartcar.com/docs/api-reference/get-service-records): Retrieve service records tracked by the vehicle's dealer or manually added by the vehicle owner. Currently supporting Ford, Lincoln, Toyota, Lexus, Mazda and Volkswagen (US)
- [System Status (Early Access)](https://smartcar.com/docs/api-reference/get-system-status): Provides a list of vehicle systems and their current health status. Currently supporting FCA and GM brands including RAM, Jeep, Chrysler, Dodge, Fiat, Alpha Romeo, Buick, Cadillac, Chevrolet and GMC. See [Diagnostic Systems](/docs/help/diagnostic-systems) for a complete list of Smartcar System IDs.
- [Tire Pressure](https://smartcar.com/docs/api-reference/get-tire-pressure): Returns the air pressure of each of the vehicle’s tires.
- [Vehicle Attributes](https://smartcar.com/docs/api-reference/get-vehicle-info): Returns a single vehicle object, containing identifying information.
- [VIN](https://smartcar.com/docs/api-reference/get-vin): Returns the vehicle’s manufacturer identifier.
- [Charge Completion Time](https://smartcar.com/docs/api-reference/gm/get-charge-completion-time): When the vehicle is charging, returns the date and time the vehicle expects to "complete" this charging session.  When the vehicle is not charging, this endpoint results in a vehicle state error.
- [Voltage](https://smartcar.com/docs/api-reference/gm/get-charge-voltmeter): When the vehicle is plugged in, returns the charging voltage measured by the vehicle. When the vehicle is not plugged in, this endpoint results in a vehicle state error.
- [Headers](https://smartcar.com/docs/api-reference/headers)
- [Smartcar API Reference](https://smartcar.com/docs/api-reference/intro)
- [Makes](https://smartcar.com/docs/api-reference/makes): Valid values for the `make` parameter
- [Vehicle Connections](https://smartcar.com/docs/api-reference/management/delete-vehicle-connections): Deletes all vehicle connections associated with a Smartcar user ID or a specific vehicle.
- [Vehicle Connections](https://smartcar.com/docs/api-reference/management/get-vehicle-connections): Returns a paged list of all vehicles that are connected to the application associated with the management API token used, sorted in descending order by connection date.
- [Charge Schedule](https://smartcar.com/docs/api-reference/nissan/get-charge-schedule): Returns the charging schedule of a vehicle. The response contains the start time and departure time of the vehicle's charging schedule.
- [Charge Schedule](https://smartcar.com/docs/api-reference/nissan/set-charge-schedule): Sets the charging schedule for a vehicle.
- [Permissions](https://smartcar.com/docs/api-reference/permissions): In order to use an endpoint or webhook, you'll need to request the associated permissions from your user in [Connect](/docs/connect/what-is-connect).
- [Send Destination](https://smartcar.com/docs/api-reference/send-destination-to-vehicle): Send destination coordinates to the vehicle's navigation system.
- [Clear PIN to Drive](https://smartcar.com/docs/api-reference/tesla/clear-pin-to-drive): Disables this feature on the vehicle and resets the PIN.
- [Charge Port](https://smartcar.com/docs/api-reference/tesla/control-charge-port): Open or close the vehicle's charge port door.
- [Frunk](https://smartcar.com/docs/api-reference/tesla/control-frunk): Open or close the frunk (front trunk) of the Tesla vehicle.
- [Trunk](https://smartcar.com/docs/api-reference/tesla/control-trunk): Open or close the trunk of the Tesla vehicle.
- [Alerts](https://smartcar.com/docs/api-reference/tesla/get-alerts): Returns recent alerts from the vehicle.
- [Tesla: Battery Status](https://smartcar.com/docs/api-reference/tesla/get-battery): Returns all battery related data for a Tesla vehicle.
- [Cabin Climate](https://smartcar.com/docs/api-reference/tesla/get-cabin): Returns the current state and target temperature setting of a vehicle's cabin climate system.
- [Tesla: Charge Status](https://smartcar.com/docs/api-reference/tesla/get-charge): Returns all charging related data for a Tesla vehicle.
- [Charge Completion Time](https://smartcar.com/docs/api-reference/tesla/get-charge-completion-time): When the vehicle is charging, returns the date and time when the vehicle is expected to reach its charge limit. When the vehicle is not charging, this endpoint results in a vehicle state error.
- [Charge Billing Records](https://smartcar.com/docs/api-reference/tesla/get-charge-records-billing): Returns information about charging sessions for Tesla vehicles at public Tesla chargers including cost and charging site.
- [Charge Schedule](https://smartcar.com/docs/api-reference/tesla/get-charge-schedule): Returns the charging schedule of a vehicle. The response contains the start time and departure time of the vehicle's charging schedule.
- [Voltage](https://smartcar.com/docs/api-reference/tesla/get-charge-voltmeter): When the vehicle is plugged in, returns the charging voltage measured by the vehicle. When the vehicle is not plugged in, this endpoint results in a vehicle state error.
- [Wattage](https://smartcar.com/docs/api-reference/tesla/get-charge-wattmeter): When the vehicle is charging, returns the instant charging wattage as measured by the vehicle. When the vehicle is not charging, this endpoint results in a vehicle state error.
- [Compass](https://smartcar.com/docs/api-reference/tesla/get-compass-heading): Returns the current compass heading and direction of the vehicle.
- [Defroster](https://smartcar.com/docs/api-reference/tesla/get-defroster): Returns the current state of a vehicle's front and rear defroster.
- [Extended Vehicle Info](https://smartcar.com/docs/api-reference/tesla/get-ext-vehicle-info): Returns detailed configuration information for a vehicle.
- [Exterior Temperature](https://smartcar.com/docs/api-reference/tesla/get-exterior-temperature): Returns the vehicle’s last known exterior thermometer reading. See our [climate setting](/docs/api-reference/tesla/get-cabin) endpoints for managing a cabin temperature.
- [Interior Temperature](https://smartcar.com/docs/api-reference/tesla/get-interior-temperature): Returns the vehicle’s last known interior thermometer reading. See our [climate setting](/docs/api-reference/tesla/get-cabin) endpoints for managing a cabin temperature.
- [Migration Status](https://smartcar.com/docs/api-reference/tesla/get-migration-status): Indicates if the vehicle needs to migrate to Tesla's new API. See [Tesla - What's New](https://smartcar.com/docs/help/oem-integrations/tesla/whats-new) for more details.
- [Speed](https://smartcar.com/docs/api-reference/tesla/get-speedometer): Returns the current speed of the vehicle.
- [Steering Heater](https://smartcar.com/docs/api-reference/tesla/get-steering-heater): Returns the current state of a vehicle's steering wheel heater system.
- [User Access](https://smartcar.com/docs/api-reference/tesla/get-user-access): Returns the account type and permissions for the connected Tesla account.
- [User Info](https://smartcar.com/docs/api-reference/tesla/get-user-info): Returns the email associated with the connected Tesla account.
- [Vehicle Status](https://smartcar.com/docs/api-reference/tesla/get-vehicle-status): Returns the status for the vehicle.
- [Virtual Key Status](https://smartcar.com/docs/api-reference/tesla/get-virtual-key-status): Indicates if a vehicle has the appropriate virtual key installed. See [Tesla - What's New](https://smartcar.com/docs/help/oem-integrations/tesla/whats-new#if-your-application-issues-commands) for more details on Tesla's virtual key requirements.
- [Cabin Climate](https://smartcar.com/docs/api-reference/tesla/set-cabin): Set the temperature and control the cabin climate system for a vehicle.
- [Amperage](https://smartcar.com/docs/api-reference/tesla/set-charge-ammeter): Set the amperage drawn by the vehicle from the EVSE for the current charging session. If the vehicle is not plugged in, this endpoint results in a vehicle state error.
- [Charge Schedule](https://smartcar.com/docs/api-reference/tesla/set-charge-schedule): Sets the charging schedule for a vehicle.
- [Defroster](https://smartcar.com/docs/api-reference/tesla/set-defroster): Start or stop the front and rear defroster for a vehicle.
- [Set PIN to Drive](https://smartcar.com/docs/api-reference/tesla/set-pin-to-drive): Enables this feature on the vehicle and sets the PIN needed in order to drive it.
- [Steering Heater](https://smartcar.com/docs/api-reference/tesla/set-steering-heater): Start or stop heating a vehicle's steering wheel.
- [User](https://smartcar.com/docs/api-reference/user): Returns the ID of the vehicle owner who granted access to your application.
- [Callback URI Verification](https://smartcar.com/docs/api-reference/webhooks/callback-verification)
- [Payload Verification](https://smartcar.com/docs/api-reference/webhooks/payload-verification)
- [Subscribe](https://smartcar.com/docs/api-reference/webhooks/subscribe-webhook): Subscribe a vehicle to a webhook.
- [Unsubscribe](https://smartcar.com/docs/api-reference/webhooks/unsubscribe-webhook): Unsubscribe a vehicle from a webhook.
- [2022 Releases](https://smartcar.com/docs/changelog/2022)
- [2023 Releases](https://smartcar.com/docs/changelog/2023)
- [April 2024 Releases](https://smartcar.com/docs/changelog/2024/april)
- [August 2024 Releases](https://smartcar.com/docs/changelog/2024/august)
- [February 2024 Releases](https://smartcar.com/docs/changelog/2024/february)
- [July 2024 Releases](https://smartcar.com/docs/changelog/2024/july)
- [June 2024 Releases](https://smartcar.com/docs/changelog/2024/june)
- [March 2024 Releases](https://smartcar.com/docs/changelog/2024/march)
- [May 2024 Releases](https://smartcar.com/docs/changelog/2024/may)
- [October 2024 Releases](https://smartcar.com/docs/changelog/2024/october)
- [September 2024 Releases](https://smartcar.com/docs/changelog/2024/september)
- [Latest Releases](https://smartcar.com/docs/changelog/latest)
- [Country Selection](https://smartcar.com/docs/connect/advanced-config/country-flag): By default Connect will launch based on the devices location impacting the brands that are available to the user e.g. Renault is only available in Europe.
- [Connect Flows](https://smartcar.com/docs/connect/advanced-config/flows): Connect can be launched with three different workflows. Depending on your use case and what information you have about the vehicle ahead of a launching Connect, you may be able to leverage one of these flows for a more streamlined Connect experience.
- [Modes](https://smartcar.com/docs/connect/advanced-config/modes)
- [Auth Code Exchange](https://smartcar.com/docs/connect/auth-code-exchange)
- [SDKs for Connect](https://smartcar.com/docs/connect/connect-sdks): Our SDKs make integrating Smartcar fast and easy in different languages and frameworks.
- [Dashboard Configuration](https://smartcar.com/docs/connect/dashboard-config)
- [Handle the Response](https://smartcar.com/docs/connect/handle-the-response): Upon successfully accepting the permissions, Smartcar will redirect the user back to your application using the specified `REDIRECT_URI`, along with an authorization code as a query parameter. In the case of on error, we'll provide an error and description as parameters instead.
- [Handle the Response](https://smartcar.com/docs/connect/re-auth/handle-response): If the re-auth is successful, the redirect to your application will contain a vehicle ID. In the case of an error, we'll provide an error and description as parameters instead.
- [Redirect to Connect](https://smartcar.com/docs/connect/re-auth/redirect-to-connect)
- [Build the Connect URL](https://smartcar.com/docs/connect/redirect-to-connect)
- [Overview](https://smartcar.com/docs/connect/token-management/overview): After fetching your first token pair, you'll need to manage them in order to maintain access to the vehicle.
- [Refreshing Refresh Tokens](https://smartcar.com/docs/connect/token-management/refresh-refresh-token): Refresh tokens expire after **60 days ordinarily** or **after 1 minute when used to fetch a new token pair**.
- [Refreshing Access Tokens](https://smartcar.com/docs/connect/token-management/refreshing-access-token): Your access token will expire **2 hours** after it is issued. When this happens, your application  can retrieve a new one by using the corresponding `REFRESH_TOKEN`.
- [What is Connect?](https://smartcar.com/docs/connect/what-is-connect)
- [Authentication Errors](https://smartcar.com/docs/errors/api-errors/authentication-errors): Thrown when there is an issue with your authorization header.
- [Billing Errors](https://smartcar.com/docs/errors/api-errors/billing-errors): Thrown when limits have been reached based on your plan, or if the feature is not avaible.
- [Compatibility Errors](https://smartcar.com/docs/errors/api-errors/compatibility-errors): Thrown when Smartcar does not support a make, or feature for a vehicle.
- [Connected Services Account Errors](https://smartcar.com/docs/errors/api-errors/connected-services-account-errors): Thrown when there are issues with the user's connected service account.
- [Permission Errors](https://smartcar.com/docs/errors/api-errors/permission-errors): Thrown when Smartcar does not support a make or feature for a vehicle.
- [Rate Limit Errors](https://smartcar.com/docs/errors/api-errors/rate-limit-errors): Thrown when there is an issue with the frequency of your requests.
- [Resource Not Found](https://smartcar.com/docs/errors/api-errors/resource-not-found-errors): Thrown when the incorrect API version is used or when the endpoint URL is incorrect.
- [Server Errors](https://smartcar.com/docs/errors/api-errors/server-errors): Thrown when Smartcar runs into an unexpected issue and was unable to process the request.
- [Upstream Errors](https://smartcar.com/docs/errors/api-errors/upstream-errors): Thrown when the OEM servers or vehicle failed to process the request.
- [Validation Errors](https://smartcar.com/docs/errors/api-errors/validation-errors): Thrown if there is an issue with the format of the request or body.
- [Vehicle State Errors](https://smartcar.com/docs/errors/api-errors/vehicle-state-errors): Thrown when a request fails due to the state of a vehicle or logically cannot be completed e.g. you can't start a vehicle charging if it's not plugged in.
- [Access Denied](https://smartcar.com/docs/errors/connect-errors/access-denied): This error occurs when a user denies your application access to the requested scope of permissions.
- [Configuration](https://smartcar.com/docs/errors/connect-errors/configuration-error): This error occurs when the user has encountered an Error page in Connect and has chosen to return to your application.
- [Invalid Subscription](https://smartcar.com/docs/errors/connect-errors/invalid-subscription): This error occurs when a user’s vehicle is compatible but their connected services subscription is inactive because either it has expired or it has never been activated.
- [No Vehicles](https://smartcar.com/docs/errors/connect-errors/no-vehicles): This error occurs when a vehicle owner has a connected services account, but there are no vehicles associated with the account.
- [OEM Login Cancelled](https://smartcar.com/docs/errors/connect-errors/oem-login-cancelled): This error occurs when a user went to authorize directly with the OEM but exited the flow for some reason.
- [User returned to application](https://smartcar.com/docs/errors/connect-errors/returned-to-application): This error occurs when a user leaves the Connect flow after hitting **Back to application** before granting your application access to their vehicle.
- [Server](https://smartcar.com/docs/errors/connect-errors/server-error): If there is a server error, the user will return to your application.
- [Vehicle Incompatible](https://smartcar.com/docs/errors/connect-errors/vehicle-incompatible): This error occurs when a user tries to authorize an incompatible vehicle in Smartcar Connect.
- [Overview](https://smartcar.com/docs/errors/overview): A comprehensive breakout of all Smartcar errors.
- [Testing Errors](https://smartcar.com/docs/errors/testing-errors): By launching Connect in [simulated mode](/docs/connect/advanced-config/modes), you're able to test your application against certain errors.
- [Dashboard Configurations](https://smartcar.com/docs/getting-started/dashboard/configuration)
- [Dashboard Multi-Factor Authentication (MFA)](https://smartcar.com/docs/getting-started/dashboard/dashboard-mfa)
- [Dashboard Overview](https://smartcar.com/docs/getting-started/dashboard/overview): All you need to know about the Smartcar Dashboard
- [Vehicle Simulator](https://smartcar.com/docs/getting-started/dashboard/simulator)
- [Charging Station Utilization](https://smartcar.com/docs/getting-started/guides/charging-station-utilization): This guide explains how to use the Smartcar API to enhance charging station discoverability by leveraging vehicle data such as state of charge,  battery level, range, and location. These capabilities allow developers to help EV drivers find nearby charging stations based on real-time vehicle data.
- [Plan Your Integration](https://smartcar.com/docs/getting-started/integration-overview)
- [Introduction to Smartcar's API](https://smartcar.com/docs/getting-started/introduction): Learn about how to build applications that connect to millions of vehicles around the world.
- [Test Your Integration](https://smartcar.com/docs/getting-started/test-your-integration)
- [Android Tutorial](https://smartcar.com/docs/getting-started/tutorials/android): In this tutorial, we will use the Android SDK to integrate Connect into your application.
- [Backend SDK Tutorials](https://smartcar.com/docs/getting-started/tutorials/backend): In this tutorial, we will go over how  to integrate Connect into your application and make requests to a vehicle using our backend SDKs.
- [iOS Tutorial](https://smartcar.com/docs/getting-started/tutorials/ios): In this tutorial, we will use the iOS SDK to integrate Connect into your application.
- [React Tutorial](https://smartcar.com/docs/getting-started/tutorials/react): In this tutorial, we will use the JavaScript SDK to integrate Connect into your application.
- [Dynamic Webhooks (Early Access)](https://smartcar.com/docs/getting-started/tutorials/webhooks-dynamic): Dynamic webhooks make it incredibly easy to receive data from a vehicle at the optimal frequency supported by the OEM. Specifically, once a certain condition is met, you will be able to receive data more frequently from the vehicle to stay up-to-date with the state of the vehicle when it matters most to you.
- [Scheduled Webhooks](https://smartcar.com/docs/getting-started/tutorials/webhooks-scheduled): Scheduled webhooks make it incredibly easy to receive vehicle data on a cadence of your choosing. You can set up a webhook for any Smartcar endpoint that allows you to read data from a vehicle.
- [Testing with Postman](https://smartcar.com/docs/getting-started/using-vs-with-postman): In this guide we'll go over how to use Vehicle Simulator to test out Smartcar using Postman.
- [Smartcar Usage Limits](https://smartcar.com/docs/help/api-limits): Learn about limits you may encounter when using Smartcar.
- [Brand Quirks](https://smartcar.com/docs/help/brand-quirks): Brand specific quirks to keep in mind while building out your application.
- [Brand Subscription Information](https://smartcar.com/docs/help/brand-subscriptions): Below you can find the connected service name for each brand as well as any specific subscription packages needed to connect to the vehicle via Smartcar.
- [Compatible Vehicles](https://smartcar.com/docs/help/compatibility)
- [Connect your car](https://smartcar.com/docs/help/connect-your-car)
- [Diagnostic Systems](https://smartcar.com/docs/help/diagnostic-systems): To support our System Status endpoint, reference the below list of unified systems.
- [Early Access](https://smartcar.com/docs/help/early-access): Understand Smartcar's approach to Early Access features.
- [Frequently Asked Questions (FAQs)](https://smartcar.com/docs/help/faqs)
- [Submit a Feature Request](https://smartcar.com/docs/help/feature-request)
- [Upgraded Tesla API Integration](https://smartcar.com/docs/help/oem-integrations/tesla/developers): This page has information regarding Smartcar's upgraded Tesla integration and what this means for developers. For an overview of the changes see [this page](https://smartcar.com/docs/help/oem-integrations/tesla/whats-new).
- [Tesla FAQs](https://smartcar.com/docs/help/oem-integrations/tesla/faqs): FAQs on our new Tesla integration. For an overview of the changes see [this page](https://smartcar.com/docs/help/oem-integrations/tesla/whats-new).
- [What's New?](https://smartcar.com/docs/help/oem-integrations/tesla/whats-new)
- [OEM Latency](https://smartcar.com/docs/help/oem-latency): Request latency we've observed by make
- [Reliability and Data Age](https://smartcar.com/docs/help/reliability-and-freshness): When making requests to vehicles, there is variation in how often data is updated and how many requests it can process in a given period. The tables below indicate the performance for each of Smartcar supported brands in each region.
- [Join the Research Fleet](https://smartcar.com/docs/help/research-fleet)
- [Teams](https://smartcar.com/docs/help/teams): With Teams you're able to easily manage your team's access to Dashboard
- [Vehicle Simulator](https://smartcar.com/docs/help/vehicle-simulator): Learn about what to expect from Vehicle Simulator and how it compares to Live mode.
- [What is a Connected Car?](https://smartcar.com/docs/help/what-is-a-connected-car): Learn about how to build applications that connect to millions of vehicles around the world.
- [What is Smartcar?](https://smartcar.com/docs/help/what-is-smartcar): Learn about how to build applications that connect to millions of vehicles around the world.