CINXE.COM

<!DOCTYPE html><html lang="en" class="dark"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/apple-touch-icon.png?v=3"/><link rel="icon" type="image/png" sizes="32x32" href="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon-32x32.png?v=3"/><link rel="icon" type="image/png" sizes="16x16" href="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon-16x16.png?v=3"/><link rel="shortcut icon" type="image/x-icon" href="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon.ico?v=3"/><meta name="msapplication-config" content="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/browserconfig.xml?v=3"/><meta name="apple-mobile-web-app-title" content="smartcar"/><meta name="application-name" content="smartcar"/><meta name="msapplication-TileColor" content="#00819D"/><meta name="theme-color" content="#ffffff"/><link rel="sitemap" type="application/xml" href="/docs/sitemap.xml"/><meta name="charset" content="utf-8"/><meta name="og:type" content="website"/><meta name="og:site_name" content="smartcar"/><meta name="twitter:card" content="summary_large_image"/><meta name="og:title" content="Handle the Response - smartcar"/><meta name="twitter:title" content="Handle the Response - smartcar"/><meta name="og:image" content="https://mintlify.com/docs/api/og?division=Documentation&title=Handle+the+Response&description=Upon+successfully+accepting+the+permissions%2C+Smartcar+will+redirect+the+user+back+to+your+application+using+the+specified+%60REDIRECT_URI%60%2C+along+with+an+authorization+code+as+a+query+parameter.+In+the+case+of+on+error%2C+we%27ll+provide+an+error+and+description+as+parameters+instead.&logoLight=https%3A%2F%2Fmintlify.s3-us-west-1.amazonaws.com%2Fsmartcar-docs%2Flogo%2Flight.png&logoDark=https%3A%2F%2Fmintlify.s3-us-west-1.amazonaws.com%2Fsmartcar-docs%2Flogo%2Fdark.png&primaryColor=%2300819D&lightColor=%231898B4&darkColor=%2300819D"/><meta name="twitter:image" content="https://mintlify.com/docs/api/og?division=Documentation&title=Handle+the+Response&description=Upon+successfully+accepting+the+permissions%2C+Smartcar+will+redirect+the+user+back+to+your+application+using+the+specified+%60REDIRECT_URI%60%2C+along+with+an+authorization+code+as+a+query+parameter.+In+the+case+of+on+error%2C+we%27ll+provide+an+error+and+description+as+parameters+instead.&logoLight=https%3A%2F%2Fmintlify.s3-us-west-1.amazonaws.com%2Fsmartcar-docs%2Flogo%2Flight.png&logoDark=https%3A%2F%2Fmintlify.s3-us-west-1.amazonaws.com%2Fsmartcar-docs%2Flogo%2Fdark.png&primaryColor=%2300819D&lightColor=%231898B4&darkColor=%2300819D"/><meta name="og:description" content="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."/><meta name="description" content="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."/><title>Handle the Response - smartcar</title><meta name="og:url" content="/docs/connect/handle-the-response"/><link rel="canonical" href="/docs/connect/handle-the-response"/><meta name="next-head-count" content="25"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" integrity="sha384-Xi8rHCmBmhbuyyhbI88391ZKP2dmfnOl4rT9ZfRI7mLTdk1wblIUnrIq35nqwEvC" crossorigin="anonymous"/><link rel="preload" href="/docs/_next/static/media/a34f9d1faa5f3315-s.p.woff2" as="font" type="font/woff2" crossorigin="anonymous" data-next-font="size-adjust"/><link rel="preload" href="/docs/_next/static/media/bb3ef058b751a6ad-s.p.woff2" as="font" type="font/woff2" crossorigin="anonymous" data-next-font="size-adjust"/><script id="mode-toggle" data-nscript="beforeInteractive"> try { if (localStorage.isDarkMode === 'true') { document.documentElement.classList.add('dark'); } else if (localStorage.isDarkMode === 'false') { document.documentElement.classList.remove('dark'); } else if ((true && !('isDarkMode' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches) || false) { document.documentElement.classList.add('dark'); } else { document.documentElement.classList.remove('dark'); } } catch (_) {} </script><link rel="preload" href="/docs/_next/static/css/17e674fe0a1d207f.css" as="style"/><link rel="stylesheet" href="/docs/_next/static/css/17e674fe0a1d207f.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/docs/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script id="osano" src="https://cmp.osano.com/6oljBSOpgaeC1bmb/8ee5ee1d-6f07-4f39-8e35-dc27a77fd5d1/osano.js" defer="" data-nscript="beforeInteractive"></script><script src="https://chat-assets.frontapp.com/v1/chat.bundle.js" defer="" data-nscript="beforeInteractive"></script><script src="/docs/_next/static/chunks/webpack-082cee471cefe69d.js" defer=""></script><script src="/docs/_next/static/chunks/framework-d17a13b7014ce556.js" defer=""></script><script src="/docs/_next/static/chunks/main-b4563e976e2fd8aa.js" defer=""></script><script src="/docs/_next/static/chunks/pages/_app-d5ffaf2e83a1968d.js" defer=""></script><script src="/docs/_next/static/chunks/2edb282b-7fa355f49eaeb230.js" defer=""></script><script src="/docs/_next/static/chunks/e893f787-54a006ae51267903.js" defer=""></script><script src="/docs/_next/static/chunks/086d643d-3aa1cf46914548d9.js" defer=""></script><script src="/docs/_next/static/chunks/9097-12d1b59a6a39c208.js" defer=""></script><script src="/docs/_next/static/chunks/6430-16e004706658d885.js" defer=""></script><script src="/docs/_next/static/chunks/2073-fcba8b6245f0552c.js" defer=""></script><script src="/docs/_next/static/chunks/pages/_sites/%5Bsubdomain%5D/%5B%5B...slug%5D%5D-7d0e3c1d0f130c24.js" defer=""></script><script src="/docs/_next/static/DLyUTdO3OSYUYl4V89rim/_buildManifest.js" defer=""></script><script src="/docs/_next/static/DLyUTdO3OSYUYl4V89rim/_ssgManifest.js" defer=""></script><style id="__jsx-3178852779">:root{--font-inter:'__Inter_c8d9fa', '__Inter_Fallback_c8d9fa';--font-jetbrains-mono:'__JetBrains_Mono_ea4744', '__JetBrains_Mono_Fallback_ea4744'}</style></head><div id="__next"><main class="jsx-3178852779"><style>:root { --primary: 0 129 157; --primary-light: 24 152 180; --primary-dark: 0 129 157; --background-light: 255 255 255; --background-dark: 9 12 14; --gray-50: 242 246 247; --gray-100: 238 241 242; --gray-200: 222 226 227; --gray-300: 206 209 210; --gray-400: 158 162 163; --gray-500: 111 115 116; --gray-600: 79 83 84; --gray-700: 62 66 67; --gray-800: 37 41 42; --gray-900: 22 26 27; --gray-950: 10 14 14; }</style><style> .osano-cm-window__widget { display:none; }</style><div class="relative antialiased text-gray-500 dark:text-gray-400"><span class="fixed inset-0 bg-background-light dark:bg-background-dark -z-10"></span><div id="navbar" class="z-30 fixed lg:sticky top-0 w-full"><div id="navbar-transition" class="absolute w-full h-full backdrop-blur flex-none transition-colors duration-500 border-b border-gray-500/5 dark:border-gray-300/[0.06] supports-backdrop-blur:bg-background-light/60 dark:bg-transparent"></div><div class="max-w-8xl mx-auto relative"><div class=""><div class="relative"><div class="flex items-center lg:px-12 h-16 min-w-0 mx-4 lg:mx-0"><div class="h-full relative flex-1 flex items-center gap-x-4 min-w-0 border-b border-gray-500/5 dark:border-gray-300/[0.06]"><div class="flex-1 flex items-center gap-x-4"><a href="https://smartcar.com/"><span class="sr-only">smartcar home page</span><img class="w-auto h-7 relative object-contain block dark:hidden" src="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/light.png" alt="light logo"/><img class="w-auto h-7 relative object-contain hidden dark:block" src="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/dark.png" alt="dark logo"/></a><div class="flex items-center gap-x-2"></div></div><div class="hidden lg:block mx-px relative flex-1 bg-white dark:bg-gray-900 pointer-events-auto rounded-lg min-w-0"><button type="button" class="w-full flex items-center text-sm leading-6 rounded-lg py-1.5 pl-3.5 pr-3 shadow-sm text-gray-400 dark:text-white/50 bg-background-light dark:bg-background-dark dark:brightness-[1.1] dark:ring-1 dark:hover:brightness-[1.25] ring-1 ring-gray-400/20 hover:ring-gray-600/25 dark:ring-gray-600/30 dark:hover:ring-gray-500/30 focus:outline-primary justify-between truncate gap-2 min-w-[43px]" id="search-bar-entry"><div class="flex items-center gap-3 min-w-[42px]"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-search min-w-4 flex-none text-gray-700 hover:text-gray-800 dark:text-gray-300 hover:dark:text-gray-200"><circle cx="11" cy="11" r="8"></circle><path d="m21 21-4.3-4.3"></path></svg><div class="truncate min-w-0">✨ Ask Smartcar</div></div></button></div><div class="flex-1 relative hidden lg:flex items-center ml-auto justify-end space-x-4"><nav class="text-sm"><ul class="flex space-x-6 items-center"><li class="block lg:hidden"><a class="whitespace-nowrap font-medium text-gray-600 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" href="https://smartcar.com/pricing/">Request a Demo</a></li><li><a href="https://dashboard.smartcar.com/login/" class="whitespace-nowrap font-medium text-gray-600 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" target="_blank">Log in</a></li><li><a href="https://dashboard.smartcar.com/signup/" class="whitespace-nowrap font-medium text-gray-600 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" target="_blank">Sign up</a></li><li class="whitespace-nowrap hidden lg:flex" id="topbar-cta-button"><a target="_blank" class="group px-4 py-1.5 relative inline-flex items-center text-sm font-medium" href="https://smartcar.com/pricing/"><span class="absolute inset-0 bg-primary-dark dark:bg-primary-light/10 border-primary-light/30 rounded-full dark:border group-hover:opacity-[0.9] dark:group-hover:border-primary-light/60"></span><div class="mr-0.5 space-x-2.5 flex items-center"><span class="z-10 text-white dark:text-primary-light">Request a Demo</span><svg width="3" height="24" viewBox="0 -9 3 24" class="h-5 rotate-0 overflow-visible text-white/90 dark:text-primary-light"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg></div></a></li></ul></nav><div class="flex items-center"><button class="group p-2 flex items-center justify-center" aria-label="Toggle dark mode"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" xmlns="http://www.w3.org/2000/svg" class="h-4 w-4 block text-gray-400 dark:hidden group-hover:text-gray-600"><g clip-path="url(#clip0_2880_7340)"><path d="M8 1.11133V2.00022" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M12.8711 3.12891L12.2427 3.75735" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M14.8889 8H14" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M12.8711 12.8711L12.2427 12.2427" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8 14.8889V14" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M3.12891 12.8711L3.75735 12.2427" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M1.11133 8H2.00022" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M3.12891 3.12891L3.75735 3.75735" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path><path d="M8.00043 11.7782C10.0868 11.7782 11.7782 10.0868 11.7782 8.00043C11.7782 5.91402 10.0868 4.22266 8.00043 4.22266C5.91402 4.22266 4.22266 5.91402 4.22266 8.00043C4.22266 10.0868 5.91402 11.7782 8.00043 11.7782Z" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path></g><defs><clipPath id="clip0_2880_7340"><rect width="16" height="16" fill="white"></rect></clipPath></defs></svg><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-moon h-4 w-4 hidden dark:block text-gray-500 dark:group-hover:text-gray-300"><path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"></path></svg></button></div></div><div class="flex lg:hidden items-center gap-2"><button type="button" class="text-gray-500 w-8 h-8 flex items-center justify-center hover:text-gray-600 dark:text-gray-400 dark:hover:text-gray-300" id="search-bar-entry-mobile"><span class="sr-only">Search...</span><svg class="h-4 w-4 bg-gray-500 dark:bg-gray-400 hover:bg-gray-600 dark:hover:bg-gray-300" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/solid/magnifying-glass.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></button><button aria-label="More actions" class="h-7 w-5 flex items-center justify-end"><svg class="h-4 w-4 bg-gray-500 dark:bg-gray-400 hover:bg-gray-600 dark:hover:bg-gray-300" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/solid/ellipsis-vertical.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></button></div></div></div><div class="flex items-center h-14 py-4 px-5 lg:hidden"><button type="button" class="text-gray-500 hover:text-gray-600 dark:text-gray-400 dark:hover:text-gray-300"><span class="sr-only">Navigation</span><svg class="h-4" fill="currentColor" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M0 96C0 78.3 14.3 64 32 64H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H32C14.3 128 0 113.7 0 96zM0 256c0-17.7 14.3-32 32-32H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H32c-17.7 0-32-14.3-32-32zM448 416c0 17.7-14.3 32-32 32H32c-17.7 0-32-14.3-32-32s14.3-32 32-32H416c17.7 0 32 14.3 32 32z"></path></svg></button><div class="ml-4 flex text-sm leading-6 whitespace-nowrap min-w-0 space-x-3"><div class="flex items-center space-x-3"><span>Launching Connect</span><svg width="3" height="24" viewBox="0 -9 3 24" class="h-5 rotate-0 overflow-visible fill-gray-400"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg></div><div class="font-semibold text-gray-900 truncate dark:text-gray-200">Handle the Response</div></div></div></div><div class="hidden lg:flex px-12 h-12"><div class="h-full flex text-sm space-x-6"><a class="group relative h-full flex items-center font-medium text-gray-600 dark:text-gray-400 group-hover:text-gray-800 dark:group-hover:text-gray-300" href="/docs/getting-started/introduction">Getting Started<div class="absolute bottom-0 h-[1.5px] w-full group-hover:bg-gray-200 dark:group-hover:bg-gray-700"></div></a><a class="group relative h-full flex items-center text-gray-800 dark:text-gray-200 font-semibold" href="/docs/connect/what-is-connect">Connect Docs<div class="absolute bottom-0 h-[1.5px] w-full bg-primary dark:bg-primary-light"></div></a><a class="group relative h-full flex items-center font-medium text-gray-600 dark:text-gray-400 group-hover:text-gray-800 dark:group-hover:text-gray-300" href="/docs/api-reference/intro">API Reference<div class="absolute bottom-0 h-[1.5px] w-full group-hover:bg-gray-200 dark:group-hover:bg-gray-700"></div></a><a class="group relative h-full flex items-center font-medium text-gray-600 dark:text-gray-400 group-hover:text-gray-800 dark:group-hover:text-gray-300" href="/docs/help/what-is-smartcar">Help Center<div class="absolute bottom-0 h-[1.5px] w-full group-hover:bg-gray-200 dark:group-hover:bg-gray-700"></div></a><a class="group relative h-full flex items-center font-medium text-gray-600 dark:text-gray-400 group-hover:text-gray-800 dark:group-hover:text-gray-300" href="/docs/changelog/latest">Changelog<div class="absolute bottom-0 h-[1.5px] w-full group-hover:bg-gray-200 dark:group-hover:bg-gray-700"></div></a></div></div></div></div></div><div class="px-4 mx-auto max-w-8xl lg:px-8 min-h-screen"><div class="z-20 hidden lg:block fixed bottom-0 right-auto w-[18rem] top-[7.1rem]" id="sidebar"><div class="absolute inset-0 z-10 stable-scrollbar-gutter overflow-auto pr-8 pb-10" id="sidebar-content"><div class="relative lg:text-sm lg:leading-6"><div class="sticky top-0 h-8 bg-gradient-to-b from-background-light dark:from-background-dark"></div><div id="navigation-items"><div class=""><h5 class="pl-4 mb-3.5 lg:mb-2.5 font-semibold text-gray-900 dark:text-gray-200">Introduction</h5><ul><li id="/connect/what-is-connect" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/what-is-connect"><div class="flex-1 flex items-center space-x-2.5"><div>What is Connect?</div></div></a></li><li id="/connect/connect-sdks" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/connect-sdks"><div class="flex-1 flex items-center space-x-2.5"><div>SDKs</div></div></a></li></ul></div><div class="mt-12 lg:mt-8"><h5 class="pl-4 mb-3.5 lg:mb-2.5 font-semibold text-gray-900 dark:text-gray-200">Launching Connect</h5><ul><li id="/connect/dashboard-config" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/dashboard-config"><div class="flex-1 flex items-center space-x-2.5"><div>Dashboard Configuration</div></div></a></li><li id="/connect/redirect-to-connect" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/redirect-to-connect"><div class="flex-1 flex items-center space-x-2.5"><div>Build the Connect URL</div></div></a></li><li id="/connect/handle-the-response" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg bg-primary/10 text-primary font-semibold dark:text-primary-light dark:bg-primary-light/10" style="padding-left:1rem" href="/docs/connect/handle-the-response"><div class="flex-1 flex items-center space-x-2.5"><div>Handle the Response</div></div></a></li><li id="/connect/auth-code-exchange" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/auth-code-exchange"><div class="flex-1 flex items-center space-x-2.5"><div>Auth Code Exchange</div></div></a></li></ul></div><div class="mt-12 lg:mt-8"><h5 class="pl-4 mb-3.5 lg:mb-2.5 font-semibold text-gray-900 dark:text-gray-200">Token Management</h5><ul><li id="/connect/token-management/overview" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/token-management/overview"><div class="flex-1 flex items-center space-x-2.5"><div>Overview</div></div></a></li><li id="/connect/token-management/refreshing-access-token" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/token-management/refreshing-access-token"><div class="flex-1 flex items-center space-x-2.5"><div>Refreshing Access Tokens</div></div></a></li><li id="/connect/token-management/refresh-refresh-token" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/token-management/refresh-refresh-token"><div class="flex-1 flex items-center space-x-2.5"><div>Refreshing Refresh Tokens</div></div></a></li></ul></div><div class="mt-12 lg:mt-8"><h5 class="pl-4 mb-3.5 lg:mb-2.5 font-semibold text-gray-900 dark:text-gray-200">Reauthentication</h5><ul><li id="/connect/re-auth/redirect-to-connect" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/re-auth/redirect-to-connect"><div class="flex-1 flex items-center space-x-2.5"><div>Redirect to Connect</div></div></a></li><li id="/connect/re-auth/handle-response" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/re-auth/handle-response"><div class="flex-1 flex items-center space-x-2.5"><div>Handle the Response</div></div></a></li></ul></div><div class="mt-12 lg:mt-8"><h5 class="pl-4 mb-3.5 lg:mb-2.5 font-semibold text-gray-900 dark:text-gray-200">Advanced Configuration</h5><ul><li id="/connect/advanced-config/flows" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/advanced-config/flows"><div class="flex-1 flex items-center space-x-2.5"><div>Connect Flows</div></div></a></li><li id="/connect/advanced-config/modes" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/advanced-config/modes"><div class="flex-1 flex items-center space-x-2.5"><div>Modes</div></div></a></li><li id="/connect/advanced-config/country-flag" class="scroll-m-4 first:scroll-m-20"><a class="group mt-2 lg:mt-0 flex items-center pr-3 py-1.5 cursor-pointer focus:outline-primary dark:focus:outline-primary-light space-x-3 rounded-lg hover:bg-gray-600/5 dark:hover:bg-gray-200/5 text-gray-700 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300" style="padding-left:1rem" href="/docs/connect/advanced-config/country-flag"><div class="flex-1 flex items-center space-x-2.5"><div>Country Selection</div></div></a></li></ul></div></div></div></div></div><div class="" id="content-container"><div class="flex flex-row gap-12 box-border w-full pt-40 lg:pt-10"><div class="relative grow box-border flex-col w-full mx-auto px-1 lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" id="content-area"><header id="header" class="relative"><div class="mt-0.5 space-y-2.5"><div class="eyebrow h-5 text-primary dark:text-primary-light text-sm font-semibold">Launching Connect</div><div class="flex items-center"><h1 class="inline-block text-2xl sm:text-3xl font-extrabold text-gray-900 tracking-tight dark:text-gray-200">Handle the Response</h1></div></div><div class="mt-2 text-lg prose prose-gray dark:prose-invert"><p>Upon successfully accepting the permissions, Smartcar will redirect the user back to your application using the specified <code>REDIRECT_URI</code>, 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.</p></div></header><div class="flex flex-col gap-8"><div class="flex flex-col gap-6 xl:hidden [&:not(:empty)]:mt-8"></div></div><div class="relative mt-8 prose prose-gray dark:prose-invert"><h2 class="flex whitespace-pre-wrap group" id="success"><div class="absolute"><a href="#success" class="-ml-10 flex items-center opacity-0 border-0 group-hover:opacity-100" aria-label="Navigate to header"><div class="w-6 h-6 text-gray-400 rounded-md flex items-center justify-center zinc-box bg-white ring-1 ring-gray-400/30 dark:ring-gray-700/25 hover:ring-gray-400/60 dark:hover:ring-white/20"><svg xmlns="http://www.w3.org/2000/svg" fill="gray" height="12px" viewBox="0 0 576 512"><path d="M0 256C0 167.6 71.6 96 160 96h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C98.1 144 48 194.1 48 256s50.1 112 112 112h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C71.6 416 0 344.4 0 256zm576 0c0 88.4-71.6 160-160 160H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c61.9 0 112-50.1 112-112s-50.1-112-112-112H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c88.4 0 160 71.6 160 160zM184 232H392c13.3 0 24 10.7 24 24s-10.7 24-24 24H184c-13.3 0-24-10.7-24-24s10.7-24 24-24z"></path></svg></div></a></div><span class="cursor-pointer">Success</span></h2> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>code</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>An authorization code used to obtain your initial <code>ACCESS_TOKEN</code>. The auth <code>code</code> expires after <strong>10 minutes</strong>.</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>state</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.</p></div></div> <div class="mt-5 mb-8 not-prose rounded-xl relative text-gray-50 bg-[#0F1117] dark:bg-codeblock dark:ring-1 dark:ring-gray-800/50 codeblock-dark"><div class="flex rounded-t-xl text-gray-400 text-xs leading-6 border-b font-medium bg-black/40 border-gray-900/80"><div class="flex-none border-b px-4 pt-2.5 pb-2 flex items-center text-primary-light border-primary-light">Success</div><div class="flex-1 mr-4 flex items-center justify-end"></div></div><div class="min-w-full relative text-sm leading-6 children:!my-0 children:!shadow-none children:!bg-transparent transition-[height] duration-300 ease-in-out" style="font-variant-ligatures:none;height:auto"><div class="overflow-x-auto h-full p-5 overflow-y-hidden scrollbar-thin scrollbar-thumb-rounded scrollbar-thumb-white/20 dark:scrollbar-thumb-white/20 hover:scrollbar-thumb-white/25 dark:hover:scrollbar-thumb-white/25 active:scrollbar-thumb-white/25 dark:active:scrollbar-thumb-white/25"><pre class="language-http"><code class="language-http"><span class=""><span class="token response-status"><span class="token http-version property">HTTP/1.1</span> <span class="token status-code number">302</span> <span class="token reason-phrase string">Found</span></span></span> <span class=""><span class="token header"><span class="token header-name keyword">Location</span><span class="token punctuation">:</span> <span class="token header-value">https://example.com/home?</span></span></span> <span class="">code=90abecb6-e7ab-4b85-864a-e1c8bf67f2ad</span> <span class="">&state=0facda3319</span> </code></pre></div></div></div> <h2 class="flex whitespace-pre-wrap group" id="error"><div class="absolute"><a href="#error" class="-ml-10 flex items-center opacity-0 border-0 group-hover:opacity-100" aria-label="Navigate to header"><div class="w-6 h-6 text-gray-400 rounded-md flex items-center justify-center zinc-box bg-white ring-1 ring-gray-400/30 dark:ring-gray-700/25 hover:ring-gray-400/60 dark:hover:ring-white/20"><svg xmlns="http://www.w3.org/2000/svg" fill="gray" height="12px" viewBox="0 0 576 512"><path d="M0 256C0 167.6 71.6 96 160 96h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C98.1 144 48 194.1 48 256s50.1 112 112 112h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C71.6 416 0 344.4 0 256zm576 0c0 88.4-71.6 160-160 160H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c61.9 0 112-50.1 112-112s-50.1-112-112-112H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c88.4 0 160 71.6 160 160zM184 232H392c13.3 0 24 10.7 24 24s-10.7 24-24 24H184c-13.3 0-24-10.7-24-24s10.7-24 24-24z"></path></svg></div></a></div><span class="cursor-pointer">Error</span></h2> <p>For a detailed description of these errors, please see our <a href="/docs/errors/overview">errors page</a>.</p> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>error</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>The type of error</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>error_description</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>A detailed description of what caused the error</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>state</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.</p></div></div> <div class="mt-5 mb-8 not-prose rounded-xl relative text-gray-50 bg-[#0F1117] dark:bg-codeblock dark:ring-1 dark:ring-gray-800/50 codeblock-dark"><div class="flex rounded-t-xl text-gray-400 text-xs leading-6 border-b font-medium bg-black/40 border-gray-900/80"><div class="flex-none border-b px-4 pt-2.5 pb-2 flex items-center text-primary-light border-primary-light">Error</div><div class="flex-1 mr-4 flex items-center justify-end"></div></div><div class="min-w-full relative text-sm leading-6 children:!my-0 children:!shadow-none children:!bg-transparent transition-[height] duration-300 ease-in-out" style="font-variant-ligatures:none;height:auto"><div class="overflow-x-auto h-full p-5 overflow-y-hidden scrollbar-thin scrollbar-thumb-rounded scrollbar-thumb-white/20 dark:scrollbar-thumb-white/20 hover:scrollbar-thumb-white/25 dark:hover:scrollbar-thumb-white/25 active:scrollbar-thumb-white/25 dark:active:scrollbar-thumb-white/25"><pre class="language-http"><code class="language-http"><span class=""><span class="token response-status"><span class="token http-version property">HTTP/1.1</span> <span class="token status-code number">302</span> <span class="token reason-phrase string">Found</span></span></span> <span class=""><span class="token header"><span class="token header-name keyword">Location</span><span class="token punctuation">:</span> <span class="token header-value">https://example.com/home?</span></span></span> <span class="">error=access_denied</span> <span class="">&error_description=User+denied+access+to+application.</span> <span class="">&state=0facda3319</span> </code></pre></div></div></div> <div class="my-4 px-5 py-4 overflow-hidden rounded-xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10"><div class="mt-0.5 w-4"><svg viewBox="0 0 20 20" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="flex-none w-5 h-5 text-zinc-400 dark:text-zinc-300" aria-label="Info"><path d="M8 0C3.58125 0 0 3.58125 0 8C0 12.4187 3.58125 16 8 16C12.4187 16 16 12.4187 16 8C16 3.58125 12.4187 0 8 0ZM8 14.5C4.41563 14.5 1.5 11.5841 1.5 8C1.5 4.41594 4.41563 1.5 8 1.5C11.5844 1.5 14.5 4.41594 14.5 8C14.5 11.5841 11.5844 14.5 8 14.5ZM9.25 10.5H8.75V7.75C8.75 7.3375 8.41563 7 8 7H7C6.5875 7 6.25 7.3375 6.25 7.75C6.25 8.1625 6.5875 8.5 7 8.5H7.25V10.5H6.75C6.3375 10.5 6 10.8375 6 11.25C6 11.6625 6.3375 12 6.75 12H9.25C9.66406 12 10 11.6641 10 11.25C10 10.8359 9.66563 10.5 9.25 10.5ZM8 6C8.55219 6 9 5.55219 9 5C9 4.44781 8.55219 4 8 4C7.44781 4 7 4.44687 7 5C7 5.55313 7.44687 6 8 6Z"></path></svg></div><div class="text-sm prose min-w-0 text-zinc-900 dark:text-zinc-200"><p>In addition to the error code and description, Smartcar will return the following parameters when a user tries to authorize an incompatible vehicle in Connect.</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>vin</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>Can be returned for errors where the vehicle is incompatible.</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>make</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>The manufacturer of the vehicle.</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>model</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>The model of the vehicle.</p></div></div> <div class="pt-2.5 pb-5 my-2.5 border-gray-100 dark:border-gray-800/50 border-b"><div class="flex font-mono text-sm"><div class="flex-1 flex content-start py-0.5 mr-5"><div class="flex items-center flex-wrap gap-2"><div class="font-bold text-primary dark:text-primary-light"><span class="text-gray-500 dark:text-gray-400"></span>year</div><div class="flex items-center space-x-2 text-xs font-medium"></div></div></div></div><div class="mt-4 prose-sm prose-gray dark:prose-invert"><p>The year of production of the vehicle.</p></div></div></div><div class="leading-6 mt-14"><div class="pb-16 w-full"><div class="flex flex-col gap-y-4 xl:flex-col xl:gap-6 min-[1400px]:flex-row md:flex-row md:justify-end"><div class="flex flex-row gap-5 items-center grow justify-between md:justify-start xl:justify-between min-[1400px]:justify-start"><p class="text-sm text-gray-600 dark:text-gray-400">Was this page helpful?</p><div class="flex flex-row gap-3 items-center"><button class="px-[14px] py-2 flex flex-row gap-[10px] items-center border rounded-lg text-gray-600 dark:text-gray-400 hover:text-gray-700 dark:hover:text-gray-300 bg-white/50 border-gray-200 dark:border-gray-800 dark:bg-codeblock/50 hover:border-gray-400 hover:dark:border-gray-500"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" class="fill-current"><path d="M10.1187 1.08741C8.925 0.746789 7.67813 1.43741 7.3375 2.63116L7.15938 3.25616C7.04375 3.66241 6.83438 4.03741 6.55 4.34991L4.94688 6.11241C4.66875 6.41866 4.69062 6.89366 4.99687 7.17179C5.30312 7.44991 5.77813 7.42804 6.05625 7.12179L7.65938 5.35929C8.1 4.87491 8.42188 4.29679 8.6 3.66866L8.77812 3.04366C8.89062 2.64679 9.30625 2.41554 9.70625 2.52804C10.1063 2.64054 10.3344 3.05616 10.2219 3.45616L10.0437 4.08116C9.86562 4.70304 9.58437 5.29054 9.2125 5.81554C9.05 6.04366 9.03125 6.34366 9.15938 6.59366C9.2875 6.84366 9.54375 6.99991 9.825 6.99991H14C14.275 6.99991 14.5 7.22491 14.5 7.49991C14.5 7.71241 14.3656 7.89679 14.175 7.96866C13.9438 8.05616 13.7688 8.24992 13.7094 8.49054C13.65 8.73117 13.7125 8.98429 13.875 9.16866C13.9531 9.25616 14 9.37179 14 9.49991C14 9.74366 13.825 9.94679 13.5938 9.99054C13.3375 10.0405 13.1219 10.2187 13.0312 10.4624C12.9406 10.7062 12.9813 10.9843 13.1438 11.1905C13.2094 11.2749 13.25 11.3812 13.25 11.4999C13.25 11.7093 13.1187 11.8937 12.9312 11.9655C12.5719 12.1062 12.3781 12.4937 12.4812 12.8655C12.4937 12.9062 12.5 12.953 12.5 12.9999C12.5 13.2749 12.275 13.4999 12 13.4999H8.95312C8.55937 13.4999 8.17188 13.3843 7.84375 13.1655L5.91563 11.8812C5.57188 11.6499 5.10625 11.7437 4.875 12.0905C4.64375 12.4374 4.7375 12.8999 5.08437 13.1312L7.0125 14.4155C7.5875 14.7999 8.2625 15.003 8.95312 15.003H12C13.0844 15.003 13.9656 14.1405 14 13.0655C14.4563 12.6999 14.75 12.1374 14.75 11.503C14.75 11.3624 14.7344 11.228 14.7094 11.0968C15.1906 10.7312 15.5 10.153 15.5 9.50304C15.5 9.29991 15.4688 9.10304 15.4125 8.91866C15.775 8.55304 16 8.05304 16 7.49991C16 6.39679 15.1063 5.49991 14 5.49991H11.1156C11.2625 5.17491 11.3875 4.83741 11.4844 4.49366L11.6625 3.86866C12.0031 2.67491 11.3125 1.42804 10.1187 1.08741ZM1 5.99991C0.446875 5.99991 0 6.44679 0 6.99991V13.9999C0 14.553 0.446875 14.9999 1 14.9999H3C3.55313 14.9999 4 14.553 4 13.9999V6.99991C4 6.44679 3.55313 5.99991 3 5.99991H1Z"></path></svg><small class="text-sm font-normal leading-4 ">Yes</small></button><button class="px-[14px] py-2 flex flex-row gap-[10px] items-center border rounded-lg text-gray-600 dark:text-gray-400 hover:text-gray-700 dark:hover:text-gray-300 bg-white/50 border-gray-200 dark:border-gray-800 dark:bg-codeblock/50 hover:border-gray-400 hover:dark:border-gray-500"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" class="fill-current"><path d="M10.1187 14.9124C8.925 15.253 7.67813 14.5624 7.3375 13.3687L7.15938 12.7437C7.04375 12.3374 6.83438 11.9624 6.55 11.6499L4.94688 9.8874C4.66875 9.58115 4.69062 9.10615 4.99687 8.82803C5.30312 8.5499 5.77813 8.57178 6.05625 8.87803L7.65938 10.6405C8.1 11.1249 8.42188 11.703 8.6 12.3312L8.77812 12.9562C8.89062 13.353 9.30625 13.5843 9.70625 13.4718C10.1063 13.3593 10.3344 12.9437 10.2219 12.5437L10.0437 11.9187C9.86562 11.2968 9.58437 10.7093 9.2125 10.1843C9.05 9.95615 9.03125 9.65615 9.15938 9.40615C9.2875 9.15615 9.54375 8.9999 9.825 8.9999H14C14.275 8.9999 14.5 8.7749 14.5 8.4999C14.5 8.2874 14.3656 8.10303 14.175 8.03115C13.9438 7.94365 13.7688 7.7499 13.7094 7.50928C13.65 7.26865 13.7125 7.01553 13.875 6.83115C13.9531 6.74365 14 6.62803 14 6.4999C14 6.25615 13.825 6.05303 13.5938 6.00928C13.3375 5.95928 13.1219 5.78115 13.0312 5.53428C12.9406 5.2874 12.9813 5.0124 13.1438 4.80615C13.2094 4.72178 13.25 4.61553 13.25 4.49678C13.25 4.2874 13.1187 4.10303 12.9312 4.03115C12.5719 3.89053 12.3781 3.50303 12.4812 3.13115C12.4937 3.09053 12.5 3.04365 12.5 2.99678C12.5 2.72178 12.275 2.49678 12 2.49678H8.95312C8.55937 2.49678 8.17188 2.6124 7.84375 2.83115L5.91563 4.11553C5.57188 4.34678 5.10625 4.25303 4.875 3.90615C4.64375 3.55928 4.7375 3.09678 5.08437 2.86553L7.0125 1.58115C7.5875 1.19678 8.2625 0.993652 8.95312 0.993652H12C13.0844 0.993652 13.9656 1.85615 14 2.93115C14.4563 3.29678 14.75 3.85928 14.75 4.49365C14.75 4.63428 14.7344 4.76865 14.7094 4.8999C15.1906 5.26553 15.5 5.84365 15.5 6.49365C15.5 6.69678 15.4688 6.89365 15.4125 7.07803C15.775 7.44678 16 7.94678 16 8.4999C16 9.60303 15.1063 10.4999 14 10.4999H11.1156C11.2625 10.8249 11.3875 11.1624 11.4844 11.5062L11.6625 12.1312C12.0031 13.3249 11.3125 14.5718 10.1187 14.9124ZM1 11.9999C0.446875 11.9999 0 11.553 0 10.9999V3.9999C0 3.44678 0.446875 2.9999 1 2.9999H3C3.55313 2.9999 4 3.44678 4 3.9999V10.9999C4 11.553 3.55313 11.9999 3 11.9999H1Z"></path></svg><small class="text-sm font-normal leading-4 ">No</small></button></div></div><div class="flex flex-row gap-3 justify-end"></div></div></div><div class="mb-12 px-0.5 flex items-center text-sm font-semibold text-gray-700 dark:text-gray-200"><a class="flex items-center space-x-3 group" href="/docs/connect/redirect-to-connect"><svg viewBox="0 0 3 6" class="h-1.5 stroke-gray-400 overflow-visible group-hover:stroke-gray-600 dark:group-hover:stroke-gray-300"><path d="M3 0L0 3L3 6" fill="none" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="group-hover:text-gray-900 dark:group-hover:text-white">Build the Connect URL</span></a><a class="flex items-center ml-auto space-x-3 group" href="/docs/connect/auth-code-exchange"><span class="group-hover:text-gray-900 dark:group-hover:text-white">Auth Code Exchange</span><svg viewBox="0 0 3 6" class="rotate-180 h-1.5 stroke-gray-400 overflow-visible group-hover:stroke-gray-600 dark:group-hover:stroke-gray-300"><path d="M3 0L0 3L3 6" fill="none" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"></path></svg></a></div></div></div><div class="z-10 hidden xl:flex pl-10 box-border w-[19rem]" id="table-of-contents"><div id="table-of-contents-content" class="fixed text-gray-600 text-sm leading-6 w-[16.5rem] overflow-y-auto space-y-2 h-[calc(100%-10rem)]"><div class="text-gray-700 dark:text-gray-300 font-medium flex items-center space-x-2"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="2" xmlns="http://www.w3.org/2000/svg" class="h-3 w-3"><path d="M2.44434 12.6665H13.5554" stroke-linecap="round" stroke-linejoin="round"></path><path d="M2.44434 3.3335H13.5554" stroke-linecap="round" stroke-linejoin="round"></path><path d="M2.44434 8H7.33323" stroke-linecap="round" stroke-linejoin="round"></path></svg><span>On this page</span></div><ul><li><a href="#success" class="py-1 block hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300">Success</a></li><li><a href="#error" class="py-1 block hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-300">Error</a></li></ul></div></div></div></div></div><footer id="footer" class="flex flex-col items-center mx-auto border-t border-gray-100 dark:border-gray-800/50"><div class="flex w-full flex-col gap-12 justify-between px-8 py-16 md:py-20 lg:py-28 max-w-[984px] z-0"><div class="flex flex-col md:flex-row gap-8 justify-between min-h-[76px]"><div class="flex md:flex-col justify-between items-center md:items-start min-w-16 md:min-w-20 lg:min-w-48 md:gap-y-24"><a href="https://smartcar.com/"><span class="sr-only">smartcar home page</span><img class="w-auto relative object-contain block dark:hidden max-w-48 h-[26px]" src="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/light.png" alt="light logo"/><img class="w-auto relative object-contain hidden dark:block max-w-48 h-[26px]" src="https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/dark.png" alt="dark logo"/></a><div class="gap-3 min-w-[140px] h-fit flex justify-end md:justify-start"><a href="https://www.linkedin.com/company/smartcar/" target="_blank"><span class="sr-only">linkedin</span><svg class="w-5 h-5 bg-gray-500 dark:bg-gray-600 hover:bg-gray-600 dark:hover:bg-gray-500" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/brands/linkedin.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></a><a href="https://github.com/smartcar" target="_blank"><span class="sr-only">github</span><svg class="w-5 h-5 bg-gray-500 dark:bg-gray-600 hover:bg-gray-600 dark:hover:bg-gray-500" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/brands/github.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></a><a href="https://www.facebook.com/smartcar/" target="_blank"><span class="sr-only">facebook</span><svg class="w-5 h-5 bg-gray-500 dark:bg-gray-600 hover:bg-gray-600 dark:hover:bg-gray-500" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/brands/facebook.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></a><a href="https://www.instagram.com/mysmartcar/" target="_blank"><span class="sr-only">instagram</span><svg class="w-5 h-5 bg-gray-500 dark:bg-gray-600 hover:bg-gray-600 dark:hover:bg-gray-500" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/brands/instagram.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></a><a href="https://x.com/mysmartcar/" target="_blank"><span class="sr-only">x</span><svg class="w-5 h-5 bg-gray-500 dark:bg-gray-600 hover:bg-gray-600 dark:hover:bg-gray-500" style="-webkit-mask-image:url(https://mintlify.b-cdn.net/v6.6.0/brands/x-twitter.svg);-webkit-mask-repeat:no-repeat;-webkit-mask-position:center"></svg></a></div></div><div class="flex flex-col sm:grid max-md:!grid-cols-2 gap-8 flex-1" style="grid-template-columns:repeat(4, minmax(0, 1fr))"><div class="flex flex-col gap-4 flex-1 whitespace-nowrap w-full md:items-center"><div class="flex gap-4 flex-col"><p class="text-sm font-semibold text-gray-950 dark:text-white mb-1">Product</p><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/product/features" target="_blank" rel="noreferrer">Platform features</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/product/smartcar-dashboard" target="_blank" rel="noreferrer">Dashboard features</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/product/connect" target="_blank" rel="noreferrer">Connect features</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/product/electric-vehicle-api" target="_blank" rel="noreferrer">Smartcar for EVs</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/product/compatible-vehicles" target="_blank" rel="noreferrer">Compatible vehicles</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/global" target="_blank" rel="noreferrer">Global coverage</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/pricing" target="_blank" rel="noreferrer">Pricing</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://status.smartcar.com/" target="_blank" rel="noreferrer">Status</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://brandreliability.smartcar.com/" target="_blank" rel="noreferrer">Brand reliability</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/data-security" target="_blank" rel="noreferrer">Data security</a></div></div><div class="flex flex-col gap-4 flex-1 whitespace-nowrap w-full md:items-center"><div class="flex gap-4 flex-col"><p class="text-sm font-semibold text-gray-950 dark:text-white mb-1">Energy Solutions</p><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/derms-software" target="_blank" rel="noreferrer">DERMs</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/virtual-power-plant" target="_blank" rel="noreferrer">Virtual Power Plants (VPPs)</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/utilities" target="_blank" rel="noreferrer">Utilities</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/home-energy-management" target="_blank" rel="noreferrer">Home energy management</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/ev-charging" target="_blank" rel="noreferrer">EV charging networks</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/charge-point-operator" target="_blank" rel="noreferrer">Charge point operators</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/e-mobility-service-providers" target="_blank" rel="noreferrer">E-mobility service providers</a></div></div><div class="flex flex-col gap-4 flex-1 whitespace-nowrap w-full md:items-center"><div class="flex gap-4 flex-col"><p class="text-sm font-semibold text-gray-950 dark:text-white mb-1">Solutions</p><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/repair-maintenance" target="_blank" rel="noreferrer">Repair and maintenance</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/autocare-software" target="_blank" rel="noreferrer">Autocare software</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/auto-dealership-software" target="_blank" rel="noreferrer">Auto dealership</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/roadside-assistance" target="_blank" rel="noreferrer">Roadside assistance</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/vehicle-history-reports" target="_blank" rel="noreferrer">Vehicle history reports</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/fleet-management" target="_blank" rel="noreferrer">Small fleet management</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/car-subscription-services" target="_blank" rel="noreferrer">Car subscription service</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/car-sharing" target="_blank" rel="noreferrer">Car sharing</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/ride-sharing" target="_blank" rel="noreferrer">Ride hailing</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/car-rental" target="_blank" rel="noreferrer">Car rentals</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/auto-insurance" target="_blank" rel="noreferrer">Auto insurance</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/warranty-management-software" target="_blank" rel="noreferrer">Warranty software</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/industries/road-usage-charge" target="_blank" rel="noreferrer">Road usage charge</a></div></div><div class="flex flex-col gap-4 flex-1 whitespace-nowrap w-full md:items-center"><div class="flex gap-4 flex-col"><p class="text-sm font-semibold text-gray-950 dark:text-white mb-1">Resources</p><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/customers" target="_blank" rel="noreferrer">Customers</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/blog" target="_blank" rel="noreferrer">Blog</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/events" target="_blank" rel="noreferrer">Events</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/vehicle-owners" target="_blank" rel="noreferrer">For vehicle owners</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/automakers" target="_blank" rel="noreferrer">For automakers</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/legal/terms" target="_blank" rel="noreferrer">Terms of service</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/legal/privacy" target="_blank" rel="noreferrer">Privacy policy</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/legal/end-user-privacy" target="_blank" rel="noreferrer">End user privacy policy</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/legal/acceptable-use" target="_blank" rel="noreferrer">Acceptable use</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/legal/dpa" target="_blank" rel="noreferrer">Data processing</a><a class="text-sm max-w-36 whitespace-normal md:truncate text-gray-950/50 dark:text-white/50 hover:text-gray-950/70 dark:hover:text-white/70" href="https://smartcar.com/vdp" target="_blank" rel="noreferrer">Vulnerability disclosure program</a></div></div></div></div></div></footer></div></main></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"mdxSource":{"compiledSource":"/*@jsxRuntime automatic @jsxImportSource react*/\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = Object.assign({\n p: \"p\",\n code: \"code\",\n strong: \"strong\",\n pre: \"pre\",\n span: \"span\",\n a: \"a\"\n }, _provideComponents(), props.components), {Heading, ResponseField, CodeBlock, Info} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n if (!Heading) _missingMdxReference(\"Heading\", true);\n if (!Info) _missingMdxReference(\"Info\", true);\n if (!ResponseField) _missingMdxReference(\"ResponseField\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(Heading, {\n level: \"2\",\n id: \"success\",\n children: \"Success\"\n }), \"\\n\", _jsx(ResponseField, {\n name: \"code\",\n children: _jsxs(_components.p, {\n children: [\"An authorization code used to obtain your initial \", _jsx(_components.code, {\n children: \"ACCESS_TOKEN\"\n }), \". The auth \", _jsx(_components.code, {\n children: \"code\"\n }), \" expires after \", _jsx(_components.strong, {\n children: \"10 minutes\"\n }), \".\"]\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"state\",\n children: _jsx(_components.p, {\n children: \"If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n filename: \"Success\",\n expandable: \"false\",\n children: _jsx(_components.pre, {\n className: \"language-http\",\n children: _jsxs(_components.code, {\n className: \"language-http\",\n children: [_jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token response-status\",\n children: [_jsx(_components.span, {\n className: \"token http-version property\",\n children: \"HTTP/1.1\"\n }), \" \", _jsx(_components.span, {\n className: \"token status-code number\",\n children: \"302\"\n }), \" \", _jsx(_components.span, {\n className: \"token reason-phrase string\",\n children: \"Found\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token header\",\n children: [_jsx(_components.span, {\n className: \"token header-name keyword\",\n children: \"Location\"\n }), _jsx(_components.span, {\n className: \"token punctuation\",\n children: \":\"\n }), \" \", _jsx(_components.span, {\n className: \"token header-value\",\n children: \"https://example.com/home?\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"code=90abecb6-e7ab-4b85-864a-e1c8bf67f2ad\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026state=0facda3319\"\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(Heading, {\n level: \"2\",\n id: \"error\",\n children: \"Error\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For a detailed description of these errors, please see our \", _jsx(_components.a, {\n href: \"/errors/overview\",\n children: \"errors page\"\n }), \".\"]\n }), \"\\n\", _jsx(ResponseField, {\n name: \"error\",\n children: _jsx(_components.p, {\n children: \"The type of error\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"error_description\",\n children: _jsx(_components.p, {\n children: \"A detailed description of what caused the error\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"state\",\n children: _jsx(_components.p, {\n children: \"If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n filename: \"Error\",\n expandable: \"false\",\n children: _jsx(_components.pre, {\n className: \"language-http\",\n children: _jsxs(_components.code, {\n className: \"language-http\",\n children: [_jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token response-status\",\n children: [_jsx(_components.span, {\n className: \"token http-version property\",\n children: \"HTTP/1.1\"\n }), \" \", _jsx(_components.span, {\n className: \"token status-code number\",\n children: \"302\"\n }), \" \", _jsx(_components.span, {\n className: \"token reason-phrase string\",\n children: \"Found\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token header\",\n children: [_jsx(_components.span, {\n className: \"token header-name keyword\",\n children: \"Location\"\n }), _jsx(_components.span, {\n className: \"token punctuation\",\n children: \":\"\n }), \" \", _jsx(_components.span, {\n className: \"token header-value\",\n children: \"https://example.com/home?\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"error=access_denied\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026error_description=User+denied+access+to+application.\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026state=0facda3319\"\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(Info, {\n children: _jsx(_components.p, {\n children: \"In addition to the error code and description, Smartcar will return the following parameters when a\\nuser tries to authorize an incompatible vehicle in Connect.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"vin\",\n children: _jsx(_components.p, {\n children: \"Can be returned for errors where the vehicle is incompatible.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"make\",\n children: _jsx(_components.p, {\n children: \"The manufacturer of the vehicle.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"model\",\n children: _jsx(_components.p, {\n children: \"The model of the vehicle.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"year\",\n children: _jsx(_components.p, {\n children: \"The year of production of the vehicle.\"\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components);\n return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, {\n children: _jsx(_createMdxContent, props)\n })) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{"mintConfig":{"$schema":"https://mintlify.com/schema.json","name":"smartcar","logo":{"light":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/light.png","dark":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/dark.png","href":"https://smartcar.com/"},"favicon":"/favicon.png","api":{"baseUrl":"https://api.smartcar.com/v2.0","auth":{"method":"bearer"},"playground":{"mode":"simple"}},"colors":{"primary":"#00819D","light":"#1898B4","dark":"#00819D"},"topbarCtaButton":{"name":"Request a Demo","url":"https://smartcar.com/pricing/"},"topbarLinks":[{"url":"https://dashboard.smartcar.com/login/","name":"Log in","_id":"673bb1d5a599ce3e544ccae1"},{"url":"https://dashboard.smartcar.com/signup/","name":"Sign up","_id":"673bb1d5a599ce3e544ccae2"}],"navigation":[{"group":"Getting Started","pages":["getting-started/introduction","getting-started/integration-overview","getting-started/test-your-integration","getting-started/using-vs-with-postman"]},{"group":"Tutorials","pages":["getting-started/tutorials/ios","getting-started/tutorials/android","getting-started/tutorials/react","getting-started/tutorials/backend",{"group":"Webhooks","pages":["getting-started/tutorials/webhooks-scheduled","getting-started/tutorials/webhooks-dynamic"]}]},{"group":"Errors","pages":["errors/overview",{"group":"Connect Errors","pages":["errors/connect-errors/access-denied","errors/connect-errors/invalid-subscription","errors/connect-errors/configuration-error","errors/connect-errors/no-vehicles","errors/connect-errors/server-error","errors/connect-errors/vehicle-incompatible","errors/connect-errors/oem-login-cancelled","errors/connect-errors/returned-to-application"]},{"group":"API Errors","pages":["errors/api-errors/authentication-errors","errors/api-errors/billing-errors","errors/api-errors/compatibility-errors","errors/api-errors/connected-services-account-errors","errors/api-errors/permission-errors","errors/api-errors/rate-limit-errors","errors/api-errors/resource-not-found-errors","errors/api-errors/server-errors","errors/api-errors/upstream-errors","errors/api-errors/validation-errors","errors/api-errors/vehicle-state-errors"]},"errors/testing-errors"]},{"group":"Dashboard","pages":["getting-started/dashboard/overview","getting-started/dashboard/configuration","getting-started/dashboard/dashboard-mfa","getting-started/dashboard/simulator"]},{"group":"Introduction","pages":["connect/what-is-connect","connect/connect-sdks"]},{"group":"Launching Connect","pages":["connect/dashboard-config","connect/redirect-to-connect","connect/handle-the-response","connect/auth-code-exchange"]},{"group":"Token Management","pages":["connect/token-management/overview","connect/token-management/refreshing-access-token","connect/token-management/refresh-refresh-token"]},{"group":"Reauthentication","pages":["connect/re-auth/redirect-to-connect","connect/re-auth/handle-response"]},{"group":"Advanced Configuration","pages":["connect/advanced-config/flows","connect/advanced-config/modes","connect/advanced-config/country-flag"]},{"group":"Introduction","pages":["api-reference/intro","api-reference/api-sdks","api-reference/headers",{"group":"Authorization","pages":["api-reference/authorization/auth-code-exchange","api-reference/authorization/token-refresh"]},"api-reference/makes","api-reference/permissions","api-reference/api-errors"]},{"group":"Compatibility","pages":["api-reference/compatibility/by-vin","api-reference/compatibility/by-region-and-make"]},{"group":"Connection Management","pages":["api-reference/management/get-vehicle-connections","api-reference/management/delete-vehicle-connections"]},{"group":"Vehicle Endpoints","pages":["api-reference/all-vehicles","api-reference/batch","api-reference/evs/get-battery-capacity","api-reference/evs/get-battery-level","api-reference/evs/get-charge-limit","api-reference/evs/set-charge-limit","api-reference/evs/get-charge-status","api-reference/get-fuel-tank","api-reference/get-location","api-reference/get-lock-status","api-reference/control-lock-unlock","api-reference/get-odometer","api-reference/get-engine-oil-life","api-reference/application-permissions","api-reference/send-destination-to-vehicle","api-reference/evs/control-charge","api-reference/get-service-records","api-reference/get-system-status","api-reference/get-tire-pressure","api-reference/user","api-reference/get-vehicle-info","api-reference/get-vin"]},{"group":"Make Specific","pages":["api-reference/about-brand-specific",{"group":"Audi","pages":["api-reference/audi/get-charge"]},{"group":"Chevrolet and Cadillac","pages":["api-reference/gm/get-charge-voltmeter","api-reference/gm/get-charge-completion-time"]},{"group":"BMW and MINI","pages":["api-reference/bmw/get-charge-records"]},{"group":"Ford and Lincoln","pages":["api-reference/ford/get-charge-schedule-by-location","api-reference/ford/set-charge-schedule-by-location"]},{"group":"Nissan","pages":["api-reference/nissan/get-charge-schedule","api-reference/nissan/set-charge-schedule"]},{"group":"Tesla","pages":["api-reference/tesla/get-ext-vehicle-info","api-reference/tesla/get-user-access","api-reference/tesla/get-user-info","api-reference/tesla/get-vehicle-status","api-reference/tesla/get-alerts","api-reference/tesla/get-battery","api-reference/tesla/get-charge","api-reference/tesla/set-charge-ammeter","api-reference/tesla/get-charge-completion-time","api-reference/tesla/get-charge-records-billing","api-reference/tesla/get-charge-schedule","api-reference/tesla/set-charge-schedule","api-reference/tesla/get-charge-wattmeter","api-reference/tesla/get-charge-voltmeter","api-reference/tesla/get-exterior-temperature","api-reference/tesla/get-interior-temperature","api-reference/tesla/get-compass-heading","api-reference/tesla/get-speedometer","api-reference/tesla/get-cabin","api-reference/tesla/set-cabin","api-reference/tesla/get-defroster","api-reference/tesla/set-defroster","api-reference/tesla/get-steering-heater","api-reference/tesla/set-steering-heater","api-reference/tesla/get-migration-status","api-reference/tesla/get-virtual-key-status","api-reference/tesla/control-charge-port","api-reference/tesla/control-trunk","api-reference/tesla/control-frunk","api-reference/tesla/set-pin-to-drive","api-reference/tesla/clear-pin-to-drive"]}]},{"group":"Webhooks","pages":["api-reference/webhooks/callback-verification","api-reference/webhooks/payload-verification","api-reference/webhooks/subscribe-webhook","api-reference/webhooks/unsubscribe-webhook"]},{"group":"Changelog","pages":["changelog/latest"]},{"group":"2024","pages":["changelog/2024/october","changelog/2024/september","changelog/2024/august","changelog/2024/july","changelog/2024/june","changelog/2024/may","changelog/2024/april","changelog/2024/march","changelog/2024/february"]},{"group":"Previous","pages":["changelog/2023","changelog/2022"]},{"group":"Help Center","pages":["help/what-is-smartcar","help/what-is-a-connected-car","help/faqs","help/api-limits","help/diagnostic-systems","help/early-access","help/teams","help/vehicle-simulator"]},{"group":"Guides","pages":["getting-started/using-vs-with-postman","getting-started/guides/charging-station-utilization"]},{"group":"OEM Resources","pages":["help/brand-subscriptions","help/reliability-and-freshness","help/oem-latency","help/brand-quirks","help/compatibility",{"group":"Tesla","pages":["help/oem-integrations/tesla/whats-new","help/oem-integrations/tesla/developers","help/oem-integrations/tesla/faqs"]}]},{"group":"For Vehicle Owners","pages":["help/research-fleet","help/connect-your-car"]},{"group":"New Features","pages":["help/feature-request"]}],"primaryTab":{"name":"Getting Started"},"tabs":[{"name":"Connect Docs","url":"connect","_id":"673bb1d5a599ce3e544ccadd"},{"name":"API Reference","url":"api-reference","_id":"673bb1d5a599ce3e544ccade"},{"name":"Help Center","url":"help","_id":"673bb1d5a599ce3e544ccadf"},{"name":"Changelog","url":"changelog","_id":"673bb1d5a599ce3e544ccae0"}],"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/smartcar/","github":"https://github.com/smartcar","facebook":"https://www.facebook.com/smartcar/","instagram":"https://www.instagram.com/mysmartcar/","x":"https://x.com/mysmartcar/"},"links":[{"title":"Product","links":[{"label":"Platform features","url":"https://smartcar.com/product/features"},{"label":"Dashboard features","url":"https://smartcar.com/product/smartcar-dashboard"},{"label":"Connect features","url":"https://smartcar.com/product/connect"},{"label":"Smartcar for EVs","url":"https://smartcar.com/product/electric-vehicle-api"},{"label":"Compatible vehicles","url":"https://smartcar.com/product/compatible-vehicles"},{"label":"Global coverage","url":"https://smartcar.com/global"},{"label":"Pricing","url":"https://smartcar.com/pricing"},{"label":"Status","url":"https://status.smartcar.com/"},{"label":"Brand reliability","url":"https://brandreliability.smartcar.com/"},{"label":"Data security","url":"https://smartcar.com/data-security"}]},{"title":"Energy Solutions","links":[{"label":"DERMs","url":"https://smartcar.com/industries/derms-software"},{"label":"Virtual Power Plants (VPPs)","url":"https://smartcar.com/industries/virtual-power-plant"},{"label":"Utilities","url":"https://smartcar.com/utilities"},{"label":"Home energy management","url":"https://smartcar.com/industries/home-energy-management"},{"label":"EV charging networks","url":"https://smartcar.com/industries/ev-charging"},{"label":"Charge point operators","url":"https://smartcar.com/industries/charge-point-operator"},{"label":"E-mobility service providers","url":"https://smartcar.com/industries/e-mobility-service-providers"}]},{"title":"Solutions","links":[{"label":"Repair and maintenance","url":"https://smartcar.com/industries/repair-maintenance"},{"label":"Autocare software","url":"https://smartcar.com/industries/autocare-software"},{"label":"Auto dealership","url":"https://smartcar.com/industries/auto-dealership-software"},{"label":"Roadside assistance","url":"https://smartcar.com/industries/roadside-assistance"},{"label":"Vehicle history reports","url":"https://smartcar.com/industries/vehicle-history-reports"},{"label":"Small fleet management","url":"https://smartcar.com/industries/fleet-management"},{"label":"Car subscription service","url":"https://smartcar.com/industries/car-subscription-services"},{"label":"Car sharing","url":"https://smartcar.com/industries/car-sharing"},{"label":"Ride hailing","url":"https://smartcar.com/industries/ride-sharing"},{"label":"Car rentals","url":"https://smartcar.com/industries/car-rental"},{"label":"Auto insurance","url":"https://smartcar.com/industries/auto-insurance"},{"label":"Warranty software","url":"https://smartcar.com/industries/warranty-management-software"},{"label":"Road usage charge","url":"https://smartcar.com/industries/road-usage-charge"}]},{"title":"Resources","links":[{"label":"Customers","url":"https://smartcar.com/customers"},{"label":"Blog","url":"https://smartcar.com/blog"},{"label":"Events","url":"https://smartcar.com/events"},{"label":"For vehicle owners","url":"https://smartcar.com/vehicle-owners"},{"label":"For automakers","url":"https://smartcar.com/automakers"},{"label":"Terms of service","url":"https://smartcar.com/legal/terms"},{"label":"Privacy policy","url":"https://smartcar.com/legal/privacy"},{"label":"End user privacy policy","url":"https://smartcar.com/legal/end-user-privacy"},{"label":"Acceptable use","url":"https://smartcar.com/legal/acceptable-use"},{"label":"Data processing","url":"https://smartcar.com/legal/dpa"},{"label":"Vulnerability disclosure program","url":"https://smartcar.com/vdp"}]}]},"feedback":{"thumbsRating":true,"suggestEdit":false,"raiseIssue":false},"analytics":{"koala":{"publicApiKey":"pk_3a64cc4d12d7b978edffae0afd143df5b291"},"ga4":{"measurementId":"G-QHNXS91VZC"}},"integrations":{"frontchat":"3757914565b8f1e6878e68dda53b9bcd","osano":"https://cmp.osano.com/6oljBSOpgaeC1bmb/8ee5ee1d-6f07-4f39-8e35-dc27a77fd5d1/osano.js"},"isWhiteLabeled":true,"search":{"prompt":"✨ Ask Smartcar"},"repo":{"github":{"owner":"smartcar","repo":"docs","contentDirectory":"","deployBranch":"main","isPrivate":false}}},"pageMetadata":{"title":"Handle the Response","description":"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.","href":"/connect/handle-the-response"}}},"mdxExtracts":{"tableOfContents":[{"title":"Success","slug":"success","depth":2,"children":[]},{"title":"Error","slug":"error","depth":2,"children":[]}],"codeExamples":{}},"description":{"compiledSource":"/*@jsxRuntime automatic @jsxImportSource react*/\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = Object.assign({\n p: \"p\",\n code: \"code\"\n }, _provideComponents(), props.components);\n return _jsxs(_components.p, {\n children: [\"Upon successfully accepting the permissions, Smartcar will redirect the user back to your application using the specified \", _jsx(_components.code, {\n children: \"REDIRECT_URI\"\n }), \", 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.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components);\n return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, {\n children: _jsx(_createMdxContent, props)\n })) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageData":{"navWithMetadata":[{"group":"Getting Started","pages":[{"title":"Introduction to Smartcar's API","description":"Learn about how to build applications that connect to millions of vehicles around the world.","sidebarTitle":"Introduction","href":"/getting-started/introduction"},{"title":"Plan Your Integration","description":null,"href":"/getting-started/integration-overview"},{"title":"Test Your Integration","description":null,"href":"/getting-started/test-your-integration"},{"title":"Testing with Postman","description":"In this guide we'll go over how to use Vehicle Simulator to test out Smartcar using Postman.","sidebarTitle":"Testing with Postman","href":"/getting-started/using-vs-with-postman"}]},{"group":"Tutorials","pages":[{"title":"iOS Tutorial","description":"In this tutorial, we will use the iOS SDK to integrate Connect into your application.","sidebarTitle":"iOS","href":"/getting-started/tutorials/ios"},{"title":"Android Tutorial","description":"In this tutorial, we will use the Android SDK to integrate Connect into your application.","sidebarTitle":"Android","href":"/getting-started/tutorials/android"},{"title":"React Tutorial","description":"In this tutorial, we will use the JavaScript SDK to integrate Connect into your application.","sidebarTitle":"React","href":"/getting-started/tutorials/react"},{"title":"Backend SDK Tutorials","description":"In this tutorial, we will go over how to integrate Connect into your application and make requests to a vehicle using our backend SDKs.","sidebarTitle":"Backend SDKs","href":"/getting-started/tutorials/backend"},{"group":"Webhooks","pages":[{"title":"Scheduled Webhooks","description":"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.","sidebarTitle":"Scheduled","href":"/getting-started/tutorials/webhooks-scheduled"},{"title":"Dynamic Webhooks (Early Access)","description":"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.","sidebarTitle":"Dynamic (Early Access)","href":"/getting-started/tutorials/webhooks-dynamic"}]}]},{"group":"Errors","pages":[{"title":"Overview","description":"A comprehensive breakout of all Smartcar errors.","href":"/errors/overview"},{"group":"Connect Errors","pages":[{"title":"Access Denied","description":"This error occurs when a user denies your application access to the requested scope of permissions.","href":"/errors/connect-errors/access-denied"},{"title":"Invalid Subscription","description":"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.","href":"/errors/connect-errors/invalid-subscription"},{"title":"Configuration","description":"This error occurs when the user has encountered an Error page in Connect and has chosen to return to your application.","href":"/errors/connect-errors/configuration-error"},{"title":"No Vehicles","description":"This error occurs when a vehicle owner has a connected services account, but there are no vehicles associated with the account.","href":"/errors/connect-errors/no-vehicles"},{"title":"Server","description":"If there is a server error, the user will return to your application.","href":"/errors/connect-errors/server-error"},{"title":"Vehicle Incompatible","description":"This error occurs when a user tries to authorize an incompatible vehicle in Smartcar Connect.","href":"/errors/connect-errors/vehicle-incompatible"},{"title":"OEM Login Cancelled","description":"This error occurs when a user went to authorize directly with the OEM but exited the flow for some reason.","href":"/errors/connect-errors/oem-login-cancelled"},{"title":"User returned to application","description":"This error occurs when a user leaves the Connect flow after hitting **Back to application** before granting your application access to their vehicle.","href":"/errors/connect-errors/returned-to-application"}]},{"group":"API Errors","pages":[{"title":"Authentication Errors","description":"Thrown when there is an issue with your authorization header.","sidebarTitle":"Authentication","href":"/errors/api-errors/authentication-errors"},{"title":"Billing Errors","description":"Thrown when limits have been reached based on your plan, or if the feature is not avaible.","sidebarTitle":"Billing","href":"/errors/api-errors/billing-errors"},{"title":"Compatibility Errors","description":"Thrown when Smartcar does not support a make, or feature for a vehicle.","sidebarTitle":"Compatibility","href":"/errors/api-errors/compatibility-errors"},{"title":"Connected Services Account Errors","description":"Thrown when there are issues with the user's connected service account.","sidebarTitle":"Connected Services Account","href":"/errors/api-errors/connected-services-account-errors"},{"title":"Permission Errors","description":"Thrown when Smartcar does not support a make or feature for a vehicle.","sidebarTitle":"Permission","href":"/errors/api-errors/permission-errors"},{"title":"Rate Limit Errors","description":"Thrown when there is an issue with the frequency of your requests.","sidebarTitle":"Rate Limit","href":"/errors/api-errors/rate-limit-errors"},{"title":"Resource Not Found","description":"Thrown when the incorrect API version is used or when the endpoint URL is incorrect.","href":"/errors/api-errors/resource-not-found-errors"},{"title":"Server Errors","description":"Thrown when Smartcar runs into an unexpected issue and was unable to process the request.","sidebarTitle":"Server","href":"/errors/api-errors/server-errors"},{"title":"Upstream Errors","description":"Thrown when the OEM servers or vehicle failed to process the request.","sidebarTitle":"Upstream","href":"/errors/api-errors/upstream-errors"},{"title":"Validation Errors","description":"Thrown if there is an issue with the format of the request or body.","sidebarTitle":"Validation","href":"/errors/api-errors/validation-errors"},{"title":"Vehicle State Errors","description":"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.","sidebarTitle":"Vehicle State","href":"/errors/api-errors/vehicle-state-errors"}]},{"title":"Testing Errors","description":"By launching Connect in [simulated mode](/docs/connect/advanced-config/modes), you're able to test your application against certain errors.","href":"/errors/testing-errors"}]},{"group":"Dashboard","pages":[{"title":"Dashboard Overview","description":"All you need to know about the Smartcar Dashboard","sidebarTitle":"Overview","href":"/getting-started/dashboard/overview"},{"title":"Dashboard Configurations","description":null,"sidebarTitle":"Configuration","href":"/getting-started/dashboard/configuration"},{"title":"Dashboard Multi-Factor Authentication (MFA)","description":null,"sidebarTitle":"Dashboard MFA","href":"/getting-started/dashboard/dashboard-mfa"},{"title":"Vehicle Simulator","description":null,"sidebarTitle":"Simulator","href":"/getting-started/dashboard/simulator"}]},{"group":"Introduction","pages":[{"title":"What is Connect?","description":null,"href":"/connect/what-is-connect"},{"title":"SDKs for Connect","description":"Our SDKs make integrating Smartcar fast and easy in different languages and frameworks.","sidebarTitle":"SDKs","href":"/connect/connect-sdks"}]},{"group":"Launching Connect","pages":[{"title":"Dashboard Configuration","description":null,"href":"/connect/dashboard-config"},{"title":"Build the Connect URL","description":null,"href":"/connect/redirect-to-connect"},{"title":"Handle the Response","description":"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.","href":"/connect/handle-the-response"},{"title":"Auth Code Exchange","description":null,"href":"/connect/auth-code-exchange"}]},{"group":"Token Management","pages":[{"title":"Overview","description":"After fetching your first token pair, you'll need to manage them in order to maintain access to the vehicle.","href":"/connect/token-management/overview"},{"title":"Refreshing Access Tokens","description":"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`.","href":"/connect/token-management/refreshing-access-token"},{"title":"Refreshing Refresh Tokens","description":"Refresh tokens expire after **60 days ordinarily** or **after 1 minute when used to fetch a new token pair**.","href":"/connect/token-management/refresh-refresh-token"}]},{"group":"Reauthentication","pages":[{"title":"Redirect to Connect","description":null,"href":"/connect/re-auth/redirect-to-connect"},{"title":"Handle the Response","description":"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.","href":"/connect/re-auth/handle-response"}]},{"group":"Advanced Configuration","pages":[{"title":"Connect Flows","description":"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.","href":"/connect/advanced-config/flows"},{"title":"Modes","description":null,"href":"/connect/advanced-config/modes"},{"title":"Country Selection","description":"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.","href":"/connect/advanced-config/country-flag"}]},{"group":"Introduction","pages":[{"title":"Smartcar API Reference","description":null,"href":"/api-reference/intro"},{"title":"SDKs","description":null,"href":"/api-reference/api-sdks"},{"title":"Headers","description":null,"href":"/api-reference/headers"},{"group":"Authorization","pages":[{"title":"Auth Code Exchange","description":"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.","api":"POST https://auth.smartcar.com/oauth/token","authMethod":"none","href":"/api-reference/authorization/auth-code-exchange"},{"title":"Token Refresh","description":"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.","api":"POST https://auth.smartcar.com/oauth/token","authMethod":"none","href":"/api-reference/authorization/token-refresh"}]},{"title":"Makes","description":"Valid values for the `make` parameter","href":"/api-reference/makes"},{"title":"Permissions","description":"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).","href":"/api-reference/permissions"},{"title":"API Errors","description":null,"sidebarTitle":"Errors","href":"/api-reference/api-errors"}]},{"group":"Compatibility","pages":[{"title":"By VIN","description":null,"api":"GET /compatibility","authMethod":"none","href":"/api-reference/compatibility/by-vin"},{"title":"By Region and Make","description":null,"api":"GET /compatibility/matrix","authMethod":"none","href":"/api-reference/compatibility/by-region-and-make"}]},{"group":"Connection Management","pages":[{"title":"Vehicle Connections","description":"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.","api":"GET https://management.smartcar.com/v2.0/management/connections","authMethod":"none","href":"/api-reference/management/get-vehicle-connections"},{"title":"Vehicle Connections","description":"Deletes all vehicle connections associated with a Smartcar user ID or a specific vehicle.","api":"DELETE https://management.smartcar.com/v2.0/management/connections","authMethod":"none","href":"/api-reference/management/delete-vehicle-connections"}]},{"group":"Vehicle Endpoints","pages":[{"title":"All Vehicles","description":"Returns a paged list of all vehicles connected to the application for the current authorized `user`.","api":"GET /vehicles","href":"/api-reference/all-vehicles"},{"title":"Batch","description":"Returns a list of responses from multiple Smartcar `GET` endpoints, all combined into a single request.","api":"POST /vehicles/{id}/batch","href":"/api-reference/batch"},{"title":"Battery Capacity","description":"Returns the rated capacity of the electric vehicle's high voltage battery.","api":"GET /vehicles/{id}/battery/capacity","href":"/api-reference/evs/get-battery-capacity"},{"title":"Battery Level","description":"Returns the state of charge and the remaining range of an electric vehicle's high voltage battery.","api":"GET /vehicles/{id}/battery","href":"/api-reference/evs/get-battery-level"},{"title":"Charge Limit","description":"Returns the charge limit configuration for the vehicle.","api":"GET /vehicles/{id}/charge/limit","href":"/api-reference/evs/get-charge-limit"},{"title":"Charge Limit","description":"Set the charge limit of an electric vehicle.","api":"POST /vehicles/{id}/charge/limit","href":"/api-reference/evs/set-charge-limit"},{"title":"Charge Status","description":"Returns the charge status for the vehicle.","api":"GET /vehicles/{id}/charge","href":"/api-reference/evs/get-charge-status"},{"title":"Fuel Tank","description":"Returns the status of the fuel remaining in the vehicle’s fuel tank.","api":"GET /vehicles/{id}/fuel","href":"/api-reference/get-fuel-tank"},{"title":"Location","description":"Returns the vehicle's last known location.","api":"GET /vehicles/{id}/location","href":"/api-reference/get-location"},{"title":"Lock Status","description":"Returns the lock status for a vehicle and the open status of its doors, windows, storage units, sunroof and charging port where available.","api":"GET /vehicles/{id}/security","href":"/api-reference/get-lock-status"},{"title":"Lock \u0026 Unlock","description":"Lock or unlock the vehicle.","api":"POST /vehicles/{id}/security","href":"/api-reference/control-lock-unlock"},{"title":"Odometer","description":"Returns the vehicle’s last known odometer reading.","api":"GET /vehicles/{id}/odometer","href":"/api-reference/get-odometer"},{"title":"Oil Life","description":"Returns the remaining life span of a vehicle’s engine oil.","api":"GET /vehicles/{id}/engine/oil","href":"/api-reference/get-engine-oil-life"},{"title":"Permissions","description":"Returns a list of the permissions that have been granted to your application in relation to this vehicle.","api":"GET /vehicles/{id}/permissions","href":"/api-reference/application-permissions"},{"title":"Send Destination","description":"Send destination coordinates to the vehicle's navigation system.","api":"POST /vehicles/{id}/navigation/destination","href":"/api-reference/send-destination-to-vehicle"},{"title":"Start \u0026 Stop Charge","description":"Start or stop the vehicle charging.","api":"POST /vehicles/{id}/charge","href":"/api-reference/evs/control-charge"},{"title":"Service History","description":"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)","sidebarTitle":"Service History","api":"GET /vehicles/{id}/service/history","href":"/api-reference/get-service-records"},{"title":"System Status (Early Access)","description":"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.","sidebarTitle":"System Status","api":"GET /vehicles/{id}/diagnostics/system_status","href":"/api-reference/get-system-status"},{"title":"Tire Pressure","description":"Returns the air pressure of each of the vehicle’s tires.","api":"GET /vehicles/{id}/tires/pressure","href":"/api-reference/get-tire-pressure"},{"title":"User","description":"Returns the ID of the vehicle owner who granted access to your application.","api":"GET /user","href":"/api-reference/user"},{"title":"Vehicle Attributes","description":"Returns a single vehicle object, containing identifying information.","api":"GET /vehicles/{id}","href":"/api-reference/get-vehicle-info"},{"title":"VIN","description":"Returns the vehicle’s manufacturer identifier.","api":"GET /vehicles/{id}/vin","href":"/api-reference/get-vin"}]},{"group":"Make Specific","pages":[{"title":"Make Specific Endpoints","description":null,"sidebarTitle":"About Make Specific","href":"/api-reference/about-brand-specific"},{"group":"Audi","pages":[{"title":"Audi: Charge Status","description":"Returns all charging related data for an Audi vehicle.","sidebarTitle":"Charge","api":"GET /vehicles/{id}/{make}/charge","href":"/api-reference/audi/get-charge"}]},{"group":"Chevrolet and Cadillac","pages":[{"title":"Voltage","description":"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.","api":"GET /vehicles/{id}/{make}/charge/voltmeter","href":"/api-reference/gm/get-charge-voltmeter"},{"title":"Charge Completion Time","description":"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.","api":"GET /vehicles/{id}/{make}/charge/completion","href":"/api-reference/gm/get-charge-completion-time"}]},{"group":"BMW and MINI","pages":[{"title":"Charge Records","description":"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.","api":"GET /vehicles/{id}/{make}/charge/records","href":"/api-reference/bmw/get-charge-records"}]},{"group":"Ford and Lincoln","pages":[{"title":"Charge Schedule by Location","description":"Returns all saved charging locations for a vehicle and their associated charging limits, schedules and configurations.","api":"GET /vehicles/{id}/{make}/charge/schedule_by_location","href":"/api-reference/ford/get-charge-schedule-by-location"},{"title":"Charge Schedule by Location","description":"Set all schedules for the specified charging location.","api":"PUT /vehicles/{id}/{make}/charge/schedule_by_location","href":"/api-reference/ford/set-charge-schedule-by-location"}]},{"group":"Nissan","pages":[{"title":"Charge Schedule","description":"Returns the charging schedule of a vehicle. The response contains the start time and departure time of the vehicle's charging schedule.","api":"GET /vehicles/{id}/{make}/charge/schedule","href":"/api-reference/nissan/get-charge-schedule"},{"title":"Charge Schedule","description":"Sets the charging schedule for a vehicle.","api":"PUT /vehicles/{id}/{make}/charge/schedule","href":"/api-reference/nissan/set-charge-schedule"}]},{"group":"Tesla","pages":[{"title":"Extended Vehicle Info","description":"Returns detailed configuration information for a vehicle.","api":"GET /vehicles/{id}/{make}/attributes","href":"/api-reference/tesla/get-ext-vehicle-info"},{"title":"User Access","description":"Returns the account type and permissions for the connected Tesla account.","sidebarTitle":"User Access","api":"GET /vehicles/{id}/{make}/user/access","href":"/api-reference/tesla/get-user-access"},{"title":"User Info","description":"Returns the email associated with the connected Tesla account.","sidebarTitle":"User Info","api":"GET /vehicles/{id}/{make}/user/info","href":"/api-reference/tesla/get-user-info"},{"title":"Vehicle Status","description":"Returns the status for the vehicle.","api":"GET /vehicles/{id}/{make}/status","href":"/api-reference/tesla/get-vehicle-status"},{"title":"Alerts","description":"Returns recent alerts from the vehicle.","sidebarTitle":"Alerts","api":"GET /vehicles/{id}/{make}/alerts","href":"/api-reference/tesla/get-alerts"},{"title":"Tesla: Battery Status","description":"Returns all battery related data for a Tesla vehicle.","sidebarTitle":"Battery","api":"GET /vehicles/{id}/{make}/battery","href":"/api-reference/tesla/get-battery"},{"title":"Tesla: Charge Status","description":"Returns all charging related data for a Tesla vehicle.","sidebarTitle":"Charge","api":"GET /vehicles/{id}/{make}/charge","href":"/api-reference/tesla/get-charge"},{"title":"Amperage","description":"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.","api":"POST /vehicles/{id}/{make}/charge/ammeter","href":"/api-reference/tesla/set-charge-ammeter"},{"title":"Charge Completion Time","description":"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.","api":"GET /vehicles/{id}/{make}/charge/completion","href":"/api-reference/tesla/get-charge-completion-time"},{"title":"Charge Billing Records","description":"Returns information about charging sessions for Tesla vehicles at public Tesla chargers including cost and charging site.","api":"GET /vehicles/{id}/{make}/charge/records/billing","href":"/api-reference/tesla/get-charge-records-billing"},{"title":"Charge Schedule","description":"Returns the charging schedule of a vehicle. The response contains the start time and departure time of the vehicle's charging schedule.","api":"GET /vehicles/{id}/{make}/charge/schedule","href":"/api-reference/tesla/get-charge-schedule"},{"title":"Charge Schedule","description":"Sets the charging schedule for a vehicle.","api":"POST /vehicles/{id}/{make}/charge/schedule","href":"/api-reference/tesla/set-charge-schedule"},{"title":"Wattage","description":"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.","api":"GET /vehicles/{id}/{make}/charge/wattmeter","href":"/api-reference/tesla/get-charge-wattmeter"},{"title":"Voltage","description":"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.","api":"GET /vehicles/{id}/{make}/charge/voltmeter","href":"/api-reference/tesla/get-charge-voltmeter"},{"title":"Exterior Temperature","description":"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.","api":"GET /vehicles/{id}/{make}/thermometer/exterior","href":"/api-reference/tesla/get-exterior-temperature"},{"title":"Interior Temperature","description":"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.","api":"GET /vehicles/{id}/{make}/thermometer/interior","href":"/api-reference/tesla/get-interior-temperature"},{"title":"Compass","description":"Returns the current compass heading and direction of the vehicle.","api":"GET /vehicles/{id}/{make}/compass","href":"/api-reference/tesla/get-compass-heading"},{"title":"Speed","description":"Returns the current speed of the vehicle.","api":"GET /vehicles/{id}/{make}/speedometer","href":"/api-reference/tesla/get-speedometer"},{"title":"Cabin Climate","description":"Returns the current state and target temperature setting of a vehicle's cabin climate system.","api":"GET /vehicles/{id}/{make}/climate/cabin","href":"/api-reference/tesla/get-cabin"},{"title":"Cabin Climate","description":"Set the temperature and control the cabin climate system for a vehicle.","api":"POST /vehicles/{id}/{make}/climate/cabin","href":"/api-reference/tesla/set-cabin"},{"title":"Defroster","description":"Returns the current state of a vehicle's front and rear defroster.","api":"GET /vehicles/{is}/{make}/climate/defroster","href":"/api-reference/tesla/get-defroster"},{"title":"Defroster","description":"Start or stop the front and rear defroster for a vehicle.","api":"POST /vehicles/{id}/{make}/climate/defroster","href":"/api-reference/tesla/set-defroster"},{"title":"Steering Heater","description":"Returns the current state of a vehicle's steering wheel heater system.","api":"GET /vehicles/{id}/{make}/climate/steering_wheel","href":"/api-reference/tesla/get-steering-heater"},{"title":"Steering Heater","description":"Start or stop heating a vehicle's steering wheel.","api":"POST /vehicles/{id}/{make}/climate/steering_wheel","href":"/api-reference/tesla/set-steering-heater"},{"title":"Migration Status","description":"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.","api":"GET /vehicles/{id}/{make}/migration","href":"/api-reference/tesla/get-migration-status"},{"title":"Virtual Key Status","description":"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.","api":"GET /vehicles/{id}/{make}/virtual_key","href":"/api-reference/tesla/get-virtual-key-status"},{"title":"Charge Port","description":"Open or close the vehicle's charge port door.","api":"POST /vehicles/{id}/{make}/charge/charge_port_door","href":"/api-reference/tesla/control-charge-port"},{"title":"Trunk","description":"Open or close the trunk of the Tesla vehicle.","api":"POST /vehicles/{id}/{make}/security/trunk","href":"/api-reference/tesla/control-trunk"},{"title":"Frunk","description":"Open or close the frunk (front trunk) of the Tesla vehicle.","api":"POST /vehicles/{id}/{make}/security/frunk","href":"/api-reference/tesla/control-frunk"},{"title":"Set PIN to Drive","description":"Enables this feature on the vehicle and sets the PIN needed in order to drive it.","sidebarTitle":"PIN to Drive","api":"POST /vehicles/{id}/{make}/pin","href":"/api-reference/tesla/set-pin-to-drive"},{"title":"Clear PIN to Drive","description":"Disables this feature on the vehicle and resets the PIN.","sidebarTitle":"PIN to Drive","api":"DELETE /vehicles/{id}/{make}/pin","href":"/api-reference/tesla/clear-pin-to-drive"}]}]},{"group":"Webhooks","pages":[{"title":"Callback URI Verification","description":null,"icon":"circle-check","href":"/api-reference/webhooks/callback-verification"},{"title":"Payload Verification","description":null,"icon":"dolly","href":"/api-reference/webhooks/payload-verification"},{"title":"Subscribe","description":"Subscribe a vehicle to a webhook.","api":"POST /vehicles/{id}/webhooks/{webhook_id}","authMethod":"bearer","href":"/api-reference/webhooks/subscribe-webhook"},{"title":"Unsubscribe","description":"Unsubscribe a vehicle from a webhook.","api":"DELETE /vehicles/{id}/webhooks/{webhook_id}","authMethod":"none","href":"/api-reference/webhooks/unsubscribe-webhook"}]},{"group":"Changelog","pages":[{"title":"Latest Releases","description":null,"sidebarTitle":"Latest","href":"/changelog/latest"}]},{"group":"2024","pages":[{"title":"October 2024 Releases","description":null,"sidebarTitle":"October","href":"/changelog/2024/october"},{"title":"September 2024 Releases","description":null,"sidebarTitle":"September","href":"/changelog/2024/september"},{"title":"August 2024 Releases","description":null,"sidebarTitle":"August","href":"/changelog/2024/august"},{"title":"July 2024 Releases","description":null,"sidebarTitle":"July","href":"/changelog/2024/july"},{"title":"June 2024 Releases","description":null,"sidebarTitle":"June","href":"/changelog/2024/june"},{"title":"May 2024 Releases","description":null,"sidebarTitle":"May","href":"/changelog/2024/may"},{"title":"April 2024 Releases","description":null,"sidebarTitle":"April","href":"/changelog/2024/april"},{"title":"March 2024 Releases","description":null,"sidebarTitle":"March","href":"/changelog/2024/march"},{"title":"February 2024 Releases","description":null,"sidebarTitle":"February","href":"/changelog/2024/february"}]},{"group":"Previous","pages":[{"title":"2023 Releases","description":null,"sidebarTitle":"2023","href":"/changelog/2023"},{"title":"2022 Releases","description":null,"sidebarTitle":"2022","href":"/changelog/2022"}]},{"group":"Help Center","pages":[{"title":"What is Smartcar?","description":"Learn about how to build applications that connect to millions of vehicles around the world.","sidebarTitle":"What is Smartcar","href":"/help/what-is-smartcar"},{"title":"What is a Connected Car?","description":"Learn about how to build applications that connect to millions of vehicles around the world.","sidebarTitle":"What is a connected car","href":"/help/what-is-a-connected-car"},{"title":"Frequently Asked Questions (FAQs)","description":null,"sidebarTitle":"Frequently Asked Questions","href":"/help/faqs"},{"title":"Smartcar Usage Limits","description":"Learn about limits you may encounter when using Smartcar.","href":"/help/api-limits"},{"title":"Diagnostic Systems","description":"To support our System Status endpoint, reference the below list of unified systems.","href":"/help/diagnostic-systems"},{"title":"Early Access","description":"Understand Smartcar's approach to Early Access features.","href":"/help/early-access"},{"title":"Teams","description":"With Teams you're able to easily manage your team's access to Dashboard","href":"/help/teams"},{"title":"Vehicle Simulator","description":"Learn about what to expect from Vehicle Simulator and how it compares to Live mode.","sidebarTitle":"Vehicle Simulator","href":"/help/vehicle-simulator"}]},{"group":"Guides","pages":[{"title":"Testing with Postman","description":"In this guide we'll go over how to use Vehicle Simulator to test out Smartcar using Postman.","sidebarTitle":"Testing with Postman","href":"/getting-started/using-vs-with-postman"},{"title":"Charging Station Utilization","description":"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.","href":"/getting-started/guides/charging-station-utilization"}]},{"group":"OEM Resources","pages":[{"title":"Brand Subscription Information","description":"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.","sidebarTitle":"Subscription Information","href":"/help/brand-subscriptions"},{"title":"Reliability and Data Age","description":"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.","href":"/help/reliability-and-freshness"},{"title":"OEM Latency","description":"Request latency we've observed by make","href":"/help/oem-latency"},{"title":"Brand Quirks","description":"Brand specific quirks to keep in mind while building out your application.","href":"/help/brand-quirks"},{"title":"Compatible Vehicles","description":null,"url":"https://smartcar.com/product/compatible-vehicles/","href":"/help/compatibility"},{"group":"Tesla","pages":[{"title":"What's New?","description":null,"sidebarTitle":"What's New?","href":"/help/oem-integrations/tesla/whats-new"},{"title":"Upgraded Tesla API Integration","description":"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).","sidebarTitle":"Developers","href":"/help/oem-integrations/tesla/developers"},{"title":"Tesla FAQs","description":"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).","sidebarTitle":"FAQs","href":"/help/oem-integrations/tesla/faqs"}]}]},{"group":"For Vehicle Owners","pages":[{"title":"Join the Research Fleet","description":null,"sideBarTitle":"Research Fleet","href":"/help/research-fleet"},{"title":"Connect your car","description":null,"url":"https://connectyourcar.com/","href":"/help/connect-your-car"}]},{"group":"New Features","pages":[{"title":"Submit a Feature Request","description":null,"sideBarTitle":"Submit feature request","href":"/help/feature-request"}]}],"pageMetadata":{"title":"Handle the Response","description":"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.","href":"/connect/handle-the-response"},"mintConfig":{"layout":"topnav","sidebar":{"items":"container"},"topbar":{"style":"default"},"search":{"location":"top","prompt":"✨ Ask Smartcar"},"rounded":"default","codeBlock":{"mode":"dark"},"topbarCtaButton":{"name":"Request a Demo","url":"https://smartcar.com/pricing/","style":"pill","arrow":true},"$schema":"https://mintlify.com/schema.json","name":"smartcar","logo":{"light":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/light.png","dark":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/dark.png","href":"https://smartcar.com/"},"favicon":"/favicon.png","api":{"baseUrl":"https://api.smartcar.com/v2.0","auth":{"method":"bearer"},"playground":{"mode":"simple"}},"colors":{"primary":"#00819D","light":"#1898B4","dark":"#00819D"},"topbarLinks":[{"url":"https://dashboard.smartcar.com/login/","name":"Log in","_id":"673bb1d5a599ce3e544ccae1"},{"url":"https://dashboard.smartcar.com/signup/","name":"Sign up","_id":"673bb1d5a599ce3e544ccae2"}],"navigation":[{"group":"Getting Started","pages":["getting-started/introduction","getting-started/integration-overview","getting-started/test-your-integration","getting-started/using-vs-with-postman"]},{"group":"Tutorials","pages":["getting-started/tutorials/ios","getting-started/tutorials/android","getting-started/tutorials/react","getting-started/tutorials/backend",{"group":"Webhooks","pages":["getting-started/tutorials/webhooks-scheduled","getting-started/tutorials/webhooks-dynamic"]}]},{"group":"Errors","pages":["errors/overview",{"group":"Connect Errors","pages":["errors/connect-errors/access-denied","errors/connect-errors/invalid-subscription","errors/connect-errors/configuration-error","errors/connect-errors/no-vehicles","errors/connect-errors/server-error","errors/connect-errors/vehicle-incompatible","errors/connect-errors/oem-login-cancelled","errors/connect-errors/returned-to-application"]},{"group":"API Errors","pages":["errors/api-errors/authentication-errors","errors/api-errors/billing-errors","errors/api-errors/compatibility-errors","errors/api-errors/connected-services-account-errors","errors/api-errors/permission-errors","errors/api-errors/rate-limit-errors","errors/api-errors/resource-not-found-errors","errors/api-errors/server-errors","errors/api-errors/upstream-errors","errors/api-errors/validation-errors","errors/api-errors/vehicle-state-errors"]},"errors/testing-errors"]},{"group":"Dashboard","pages":["getting-started/dashboard/overview","getting-started/dashboard/configuration","getting-started/dashboard/dashboard-mfa","getting-started/dashboard/simulator"]},{"group":"Introduction","pages":["connect/what-is-connect","connect/connect-sdks"]},{"group":"Launching Connect","pages":["connect/dashboard-config","connect/redirect-to-connect","connect/handle-the-response","connect/auth-code-exchange"]},{"group":"Token Management","pages":["connect/token-management/overview","connect/token-management/refreshing-access-token","connect/token-management/refresh-refresh-token"]},{"group":"Reauthentication","pages":["connect/re-auth/redirect-to-connect","connect/re-auth/handle-response"]},{"group":"Advanced Configuration","pages":["connect/advanced-config/flows","connect/advanced-config/modes","connect/advanced-config/country-flag"]},{"group":"Introduction","pages":["api-reference/intro","api-reference/api-sdks","api-reference/headers",{"group":"Authorization","pages":["api-reference/authorization/auth-code-exchange","api-reference/authorization/token-refresh"]},"api-reference/makes","api-reference/permissions","api-reference/api-errors"]},{"group":"Compatibility","pages":["api-reference/compatibility/by-vin","api-reference/compatibility/by-region-and-make"]},{"group":"Connection Management","pages":["api-reference/management/get-vehicle-connections","api-reference/management/delete-vehicle-connections"]},{"group":"Vehicle Endpoints","pages":["api-reference/all-vehicles","api-reference/batch","api-reference/evs/get-battery-capacity","api-reference/evs/get-battery-level","api-reference/evs/get-charge-limit","api-reference/evs/set-charge-limit","api-reference/evs/get-charge-status","api-reference/get-fuel-tank","api-reference/get-location","api-reference/get-lock-status","api-reference/control-lock-unlock","api-reference/get-odometer","api-reference/get-engine-oil-life","api-reference/application-permissions","api-reference/send-destination-to-vehicle","api-reference/evs/control-charge","api-reference/get-service-records","api-reference/get-system-status","api-reference/get-tire-pressure","api-reference/user","api-reference/get-vehicle-info","api-reference/get-vin"]},{"group":"Make Specific","pages":["api-reference/about-brand-specific",{"group":"Audi","pages":["api-reference/audi/get-charge"]},{"group":"Chevrolet and Cadillac","pages":["api-reference/gm/get-charge-voltmeter","api-reference/gm/get-charge-completion-time"]},{"group":"BMW and MINI","pages":["api-reference/bmw/get-charge-records"]},{"group":"Ford and Lincoln","pages":["api-reference/ford/get-charge-schedule-by-location","api-reference/ford/set-charge-schedule-by-location"]},{"group":"Nissan","pages":["api-reference/nissan/get-charge-schedule","api-reference/nissan/set-charge-schedule"]},{"group":"Tesla","pages":["api-reference/tesla/get-ext-vehicle-info","api-reference/tesla/get-user-access","api-reference/tesla/get-user-info","api-reference/tesla/get-vehicle-status","api-reference/tesla/get-alerts","api-reference/tesla/get-battery","api-reference/tesla/get-charge","api-reference/tesla/set-charge-ammeter","api-reference/tesla/get-charge-completion-time","api-reference/tesla/get-charge-records-billing","api-reference/tesla/get-charge-schedule","api-reference/tesla/set-charge-schedule","api-reference/tesla/get-charge-wattmeter","api-reference/tesla/get-charge-voltmeter","api-reference/tesla/get-exterior-temperature","api-reference/tesla/get-interior-temperature","api-reference/tesla/get-compass-heading","api-reference/tesla/get-speedometer","api-reference/tesla/get-cabin","api-reference/tesla/set-cabin","api-reference/tesla/get-defroster","api-reference/tesla/set-defroster","api-reference/tesla/get-steering-heater","api-reference/tesla/set-steering-heater","api-reference/tesla/get-migration-status","api-reference/tesla/get-virtual-key-status","api-reference/tesla/control-charge-port","api-reference/tesla/control-trunk","api-reference/tesla/control-frunk","api-reference/tesla/set-pin-to-drive","api-reference/tesla/clear-pin-to-drive"]}]},{"group":"Webhooks","pages":["api-reference/webhooks/callback-verification","api-reference/webhooks/payload-verification","api-reference/webhooks/subscribe-webhook","api-reference/webhooks/unsubscribe-webhook"]},{"group":"Changelog","pages":["changelog/latest"]},{"group":"2024","pages":["changelog/2024/october","changelog/2024/september","changelog/2024/august","changelog/2024/july","changelog/2024/june","changelog/2024/may","changelog/2024/april","changelog/2024/march","changelog/2024/february"]},{"group":"Previous","pages":["changelog/2023","changelog/2022"]},{"group":"Help Center","pages":["help/what-is-smartcar","help/what-is-a-connected-car","help/faqs","help/api-limits","help/diagnostic-systems","help/early-access","help/teams","help/vehicle-simulator"]},{"group":"Guides","pages":["getting-started/using-vs-with-postman","getting-started/guides/charging-station-utilization"]},{"group":"OEM Resources","pages":["help/brand-subscriptions","help/reliability-and-freshness","help/oem-latency","help/brand-quirks","help/compatibility",{"group":"Tesla","pages":["help/oem-integrations/tesla/whats-new","help/oem-integrations/tesla/developers","help/oem-integrations/tesla/faqs"]}]},{"group":"For Vehicle Owners","pages":["help/research-fleet","help/connect-your-car"]},{"group":"New Features","pages":["help/feature-request"]}],"primaryTab":{"name":"Getting Started"},"tabs":[{"name":"Connect Docs","url":"connect","_id":"673bb1d5a599ce3e544ccadd"},{"name":"API Reference","url":"api-reference","_id":"673bb1d5a599ce3e544ccade"},{"name":"Help Center","url":"help","_id":"673bb1d5a599ce3e544ccadf"},{"name":"Changelog","url":"changelog","_id":"673bb1d5a599ce3e544ccae0"}],"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/smartcar/","github":"https://github.com/smartcar","facebook":"https://www.facebook.com/smartcar/","instagram":"https://www.instagram.com/mysmartcar/","x":"https://x.com/mysmartcar/"},"links":[{"title":"Product","links":[{"label":"Platform features","url":"https://smartcar.com/product/features"},{"label":"Dashboard features","url":"https://smartcar.com/product/smartcar-dashboard"},{"label":"Connect features","url":"https://smartcar.com/product/connect"},{"label":"Smartcar for EVs","url":"https://smartcar.com/product/electric-vehicle-api"},{"label":"Compatible vehicles","url":"https://smartcar.com/product/compatible-vehicles"},{"label":"Global coverage","url":"https://smartcar.com/global"},{"label":"Pricing","url":"https://smartcar.com/pricing"},{"label":"Status","url":"https://status.smartcar.com/"},{"label":"Brand reliability","url":"https://brandreliability.smartcar.com/"},{"label":"Data security","url":"https://smartcar.com/data-security"}]},{"title":"Energy Solutions","links":[{"label":"DERMs","url":"https://smartcar.com/industries/derms-software"},{"label":"Virtual Power Plants (VPPs)","url":"https://smartcar.com/industries/virtual-power-plant"},{"label":"Utilities","url":"https://smartcar.com/utilities"},{"label":"Home energy management","url":"https://smartcar.com/industries/home-energy-management"},{"label":"EV charging networks","url":"https://smartcar.com/industries/ev-charging"},{"label":"Charge point operators","url":"https://smartcar.com/industries/charge-point-operator"},{"label":"E-mobility service providers","url":"https://smartcar.com/industries/e-mobility-service-providers"}]},{"title":"Solutions","links":[{"label":"Repair and maintenance","url":"https://smartcar.com/industries/repair-maintenance"},{"label":"Autocare software","url":"https://smartcar.com/industries/autocare-software"},{"label":"Auto dealership","url":"https://smartcar.com/industries/auto-dealership-software"},{"label":"Roadside assistance","url":"https://smartcar.com/industries/roadside-assistance"},{"label":"Vehicle history reports","url":"https://smartcar.com/industries/vehicle-history-reports"},{"label":"Small fleet management","url":"https://smartcar.com/industries/fleet-management"},{"label":"Car subscription service","url":"https://smartcar.com/industries/car-subscription-services"},{"label":"Car sharing","url":"https://smartcar.com/industries/car-sharing"},{"label":"Ride hailing","url":"https://smartcar.com/industries/ride-sharing"},{"label":"Car rentals","url":"https://smartcar.com/industries/car-rental"},{"label":"Auto insurance","url":"https://smartcar.com/industries/auto-insurance"},{"label":"Warranty software","url":"https://smartcar.com/industries/warranty-management-software"},{"label":"Road usage charge","url":"https://smartcar.com/industries/road-usage-charge"}]},{"title":"Resources","links":[{"label":"Customers","url":"https://smartcar.com/customers"},{"label":"Blog","url":"https://smartcar.com/blog"},{"label":"Events","url":"https://smartcar.com/events"},{"label":"For vehicle owners","url":"https://smartcar.com/vehicle-owners"},{"label":"For automakers","url":"https://smartcar.com/automakers"},{"label":"Terms of service","url":"https://smartcar.com/legal/terms"},{"label":"Privacy policy","url":"https://smartcar.com/legal/privacy"},{"label":"End user privacy policy","url":"https://smartcar.com/legal/end-user-privacy"},{"label":"Acceptable use","url":"https://smartcar.com/legal/acceptable-use"},{"label":"Data processing","url":"https://smartcar.com/legal/dpa"},{"label":"Vulnerability disclosure program","url":"https://smartcar.com/vdp"}]}]},"feedback":{"thumbsRating":true,"suggestEdit":false,"raiseIssue":false},"analytics":{"koala":{"publicApiKey":"pk_3a64cc4d12d7b978edffae0afd143df5b291"},"ga4":{"measurementId":"G-QHNXS91VZC"}},"integrations":{"frontchat":"3757914565b8f1e6878e68dda53b9bcd","osano":"https://cmp.osano.com/6oljBSOpgaeC1bmb/8ee5ee1d-6f07-4f39-8e35-dc27a77fd5d1/osano.js"},"isWhiteLabeled":true,"repo":{"github":{"owner":"smartcar","repo":"docs","contentDirectory":"","deployBranch":"main","isPrivate":false}}},"apiReferenceData":{}},"favicons":{"icons":[{"rel":"apple-touch-icon","sizes":"180x180","href":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/apple-touch-icon.png?v=3","type":"image/png"},{"rel":"icon","sizes":"32x32","href":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon-32x32.png?v=3","type":"image/png"},{"rel":"icon","sizes":"16x16","href":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon-16x16.png?v=3","type":"image/png"},{"rel":"shortcut icon","href":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/favicon.ico?v=3","type":"image/x-icon"}],"browserconfig":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/_generated/favicon/browserconfig.xml?v=3"},"subdomain":"smartcar-docs","internalAnalyticsWriteKey":"phc_TXdpocbGVeZVm5VJmAsHTMrCofBQu3e0kN8HGMNGTVW","inkeep":{"integrationApiKey":"7760b73a89e77559e65b41f1abd641a5b6d4aff8d1323fad"},"trieve":{"datasetId":"5b86c57b-aecf-431f-89b1-e7a8837a15cc","chatEnabled":true},"shouldIndex":true,"org":{"plan":"enterprise","createdAt":"2023-07-07T03:28:34.654Z"},"cssFiles":[{"_id":"66cd17ebac9efcb5a7761ded","filePath":"style.css","subdomain":"smartcar-docs","__v":0,"content":"\n.osano-cm-window__widget {\n display:none;\n}"}],"jsFiles":[],"mdxSourceWithNoJs":{"compiledSource":"/*@jsxRuntime automatic @jsxImportSource react*/\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = Object.assign({\n p: \"p\",\n code: \"code\",\n strong: \"strong\",\n pre: \"pre\",\n span: \"span\",\n a: \"a\"\n }, _provideComponents(), props.components), {Heading, ResponseField, CodeBlock, Info} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n if (!Heading) _missingMdxReference(\"Heading\", true);\n if (!Info) _missingMdxReference(\"Info\", true);\n if (!ResponseField) _missingMdxReference(\"ResponseField\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(Heading, {\n level: \"2\",\n id: \"success\",\n children: \"Success\"\n }), \"\\n\", _jsx(ResponseField, {\n name: \"code\",\n children: _jsxs(_components.p, {\n children: [\"An authorization code used to obtain your initial \", _jsx(_components.code, {\n children: \"ACCESS_TOKEN\"\n }), \". The auth \", _jsx(_components.code, {\n children: \"code\"\n }), \" expires after \", _jsx(_components.strong, {\n children: \"10 minutes\"\n }), \".\"]\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"state\",\n children: _jsx(_components.p, {\n children: \"If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n filename: \"Success\",\n expandable: \"false\",\n children: _jsx(_components.pre, {\n className: \"language-http\",\n children: _jsxs(_components.code, {\n className: \"language-http\",\n children: [_jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token response-status\",\n children: [_jsx(_components.span, {\n className: \"token http-version property\",\n children: \"HTTP/1.1\"\n }), \" \", _jsx(_components.span, {\n className: \"token status-code number\",\n children: \"302\"\n }), \" \", _jsx(_components.span, {\n className: \"token reason-phrase string\",\n children: \"Found\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token header\",\n children: [_jsx(_components.span, {\n className: \"token header-name keyword\",\n children: \"Location\"\n }), _jsx(_components.span, {\n className: \"token punctuation\",\n children: \":\"\n }), \" \", _jsx(_components.span, {\n className: \"token header-value\",\n children: \"https://example.com/home?\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"code=90abecb6-e7ab-4b85-864a-e1c8bf67f2ad\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026state=0facda3319\"\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(Heading, {\n level: \"2\",\n id: \"error\",\n children: \"Error\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For a detailed description of these errors, please see our \", _jsx(_components.a, {\n href: \"/errors/overview\",\n children: \"errors page\"\n }), \".\"]\n }), \"\\n\", _jsx(ResponseField, {\n name: \"error\",\n children: _jsx(_components.p, {\n children: \"The type of error\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"error_description\",\n children: _jsx(_components.p, {\n children: \"A detailed description of what caused the error\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"state\",\n children: _jsx(_components.p, {\n children: \"If the redirect to Smartcar Connect contains a state parameter, that parameter will be returned here.\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n filename: \"Error\",\n expandable: \"false\",\n children: _jsx(_components.pre, {\n className: \"language-http\",\n children: _jsxs(_components.code, {\n className: \"language-http\",\n children: [_jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token response-status\",\n children: [_jsx(_components.span, {\n className: \"token http-version property\",\n children: \"HTTP/1.1\"\n }), \" \", _jsx(_components.span, {\n className: \"token status-code number\",\n children: \"302\"\n }), \" \", _jsx(_components.span, {\n className: \"token reason-phrase string\",\n children: \"Found\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: _jsxs(_components.span, {\n className: \"token header\",\n children: [_jsx(_components.span, {\n className: \"token header-name keyword\",\n children: \"Location\"\n }), _jsx(_components.span, {\n className: \"token punctuation\",\n children: \":\"\n }), \" \", _jsx(_components.span, {\n className: \"token header-value\",\n children: \"https://example.com/home?\"\n })]\n })\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"error=access_denied\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026error_description=User+denied+access+to+application.\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"\",\n children: \"\u0026state=0facda3319\"\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(Info, {\n children: _jsx(_components.p, {\n children: \"In addition to the error code and description, Smartcar will return the following parameters when a\\nuser tries to authorize an incompatible vehicle in Connect.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"vin\",\n children: _jsx(_components.p, {\n children: \"Can be returned for errors where the vehicle is incompatible.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"make\",\n children: _jsx(_components.p, {\n children: \"The manufacturer of the vehicle.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"model\",\n children: _jsx(_components.p, {\n children: \"The model of the vehicle.\"\n })\n }), \"\\n\", _jsx(ResponseField, {\n name: \"year\",\n children: _jsx(_components.p, {\n children: \"The year of production of the vehicle.\"\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components);\n return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, {\n children: _jsx(_createMdxContent, props)\n })) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{"mintConfig":{"$schema":"https://mintlify.com/schema.json","name":"smartcar","logo":{"light":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/light.png","dark":"https://mintlify.s3-us-west-1.amazonaws.com/smartcar-docs/logo/dark.png","href":"https://smartcar.com/"},"favicon":"/favicon.png","api":{"baseUrl":"https://api.smartcar.com/v2.0","auth":{"method":"bearer"},"playground":{"mode":"simple"}},"colors":{"primary":"#00819D","light":"#1898B4","dark":"#00819D"},"topbarCtaButton":{"name":"Request a Demo","url":"https://smartcar.com/pricing/"},"topbarLinks":[{"url":"https://dashboard.smartcar.com/login/","name":"Log in","_id":"673bb1d5a599ce3e544ccae1"},{"url":"https://dashboard.smartcar.com/signup/","name":"Sign up","_id":"673bb1d5a599ce3e544ccae2"}],"navigation":[{"group":"Getting Started","pages":["getting-started/introduction","getting-started/integration-overview","getting-started/test-your-integration","getting-started/using-vs-with-postman"]},{"group":"Tutorials","pages":["getting-started/tutorials/ios","getting-started/tutorials/android","getting-started/tutorials/react","getting-started/tutorials/backend",{"group":"Webhooks","pages":["getting-started/tutorials/webhooks-scheduled","getting-started/tutorials/webhooks-dynamic"]}]},{"group":"Errors","pages":["errors/overview",{"group":"Connect Errors","pages":["errors/connect-errors/access-denied","errors/connect-errors/invalid-subscription","errors/connect-errors/configuration-error","errors/connect-errors/no-vehicles","errors/connect-errors/server-error","errors/connect-errors/vehicle-incompatible","errors/connect-errors/oem-login-cancelled","errors/connect-errors/returned-to-application"]},{"group":"API Errors","pages":["errors/api-errors/authentication-errors","errors/api-errors/billing-errors","errors/api-errors/compatibility-errors","errors/api-errors/connected-services-account-errors","errors/api-errors/permission-errors","errors/api-errors/rate-limit-errors","errors/api-errors/resource-not-found-errors","errors/api-errors/server-errors","errors/api-errors/upstream-errors","errors/api-errors/validation-errors","errors/api-errors/vehicle-state-errors"]},"errors/testing-errors"]},{"group":"Dashboard","pages":["getting-started/dashboard/overview","getting-started/dashboard/configuration","getting-started/dashboard/dashboard-mfa","getting-started/dashboard/simulator"]},{"group":"Introduction","pages":["connect/what-is-connect","connect/connect-sdks"]},{"group":"Launching Connect","pages":["connect/dashboard-config","connect/redirect-to-connect","connect/handle-the-response","connect/auth-code-exchange"]},{"group":"Token Management","pages":["connect/token-management/overview","connect/token-management/refreshing-access-token","connect/token-management/refresh-refresh-token"]},{"group":"Reauthentication","pages":["connect/re-auth/redirect-to-connect","connect/re-auth/handle-response"]},{"group":"Advanced Configuration","pages":["connect/advanced-config/flows","connect/advanced-config/modes","connect/advanced-config/country-flag"]},{"group":"Introduction","pages":["api-reference/intro","api-reference/api-sdks","api-reference/headers",{"group":"Authorization","pages":["api-reference/authorization/auth-code-exchange","api-reference/authorization/token-refresh"]},"api-reference/makes","api-reference/permissions","api-reference/api-errors"]},{"group":"Compatibility","pages":["api-reference/compatibility/by-vin","api-reference/compatibility/by-region-and-make"]},{"group":"Connection Management","pages":["api-reference/management/get-vehicle-connections","api-reference/management/delete-vehicle-connections"]},{"group":"Vehicle Endpoints","pages":["api-reference/all-vehicles","api-reference/batch","api-reference/evs/get-battery-capacity","api-reference/evs/get-battery-level","api-reference/evs/get-charge-limit","api-reference/evs/set-charge-limit","api-reference/evs/get-charge-status","api-reference/get-fuel-tank","api-reference/get-location","api-reference/get-lock-status","api-reference/control-lock-unlock","api-reference/get-odometer","api-reference/get-engine-oil-life","api-reference/application-permissions","api-reference/send-destination-to-vehicle","api-reference/evs/control-charge","api-reference/get-service-records","api-reference/get-system-status","api-reference/get-tire-pressure","api-reference/user","api-reference/get-vehicle-info","api-reference/get-vin"]},{"group":"Make Specific","pages":["api-reference/about-brand-specific",{"group":"Audi","pages":["api-reference/audi/get-charge"]},{"group":"Chevrolet and Cadillac","pages":["api-reference/gm/get-charge-voltmeter","api-reference/gm/get-charge-completion-time"]},{"group":"BMW and MINI","pages":["api-reference/bmw/get-charge-records"]},{"group":"Ford and Lincoln","pages":["api-reference/ford/get-charge-schedule-by-location","api-reference/ford/set-charge-schedule-by-location"]},{"group":"Nissan","pages":["api-reference/nissan/get-charge-schedule","api-reference/nissan/set-charge-schedule"]},{"group":"Tesla","pages":["api-reference/tesla/get-ext-vehicle-info","api-reference/tesla/get-user-access","api-reference/tesla/get-user-info","api-reference/tesla/get-vehicle-status","api-reference/tesla/get-alerts","api-reference/tesla/get-battery","api-reference/tesla/get-charge","api-reference/tesla/set-charge-ammeter","api-reference/tesla/get-charge-completion-time","api-reference/tesla/get-charge-records-billing","api-reference/tesla/get-charge-schedule","api-reference/tesla/set-charge-schedule","api-reference/tesla/get-charge-wattmeter","api-reference/tesla/get-charge-voltmeter","api-reference/tesla/get-exterior-temperature","api-reference/tesla/get-interior-temperature","api-reference/tesla/get-compass-heading","api-reference/tesla/get-speedometer","api-reference/tesla/get-cabin","api-reference/tesla/set-cabin","api-reference/tesla/get-defroster","api-reference/tesla/set-defroster","api-reference/tesla/get-steering-heater","api-reference/tesla/set-steering-heater","api-reference/tesla/get-migration-status","api-reference/tesla/get-virtual-key-status","api-reference/tesla/control-charge-port","api-reference/tesla/control-trunk","api-reference/tesla/control-frunk","api-reference/tesla/set-pin-to-drive","api-reference/tesla/clear-pin-to-drive"]}]},{"group":"Webhooks","pages":["api-reference/webhooks/callback-verification","api-reference/webhooks/payload-verification","api-reference/webhooks/subscribe-webhook","api-reference/webhooks/unsubscribe-webhook"]},{"group":"Changelog","pages":["changelog/latest"]},{"group":"2024","pages":["changelog/2024/october","changelog/2024/september","changelog/2024/august","changelog/2024/july","changelog/2024/june","changelog/2024/may","changelog/2024/april","changelog/2024/march","changelog/2024/february"]},{"group":"Previous","pages":["changelog/2023","changelog/2022"]},{"group":"Help Center","pages":["help/what-is-smartcar","help/what-is-a-connected-car","help/faqs","help/api-limits","help/diagnostic-systems","help/early-access","help/teams","help/vehicle-simulator"]},{"group":"Guides","pages":["getting-started/using-vs-with-postman","getting-started/guides/charging-station-utilization"]},{"group":"OEM Resources","pages":["help/brand-subscriptions","help/reliability-and-freshness","help/oem-latency","help/brand-quirks","help/compatibility",{"group":"Tesla","pages":["help/oem-integrations/tesla/whats-new","help/oem-integrations/tesla/developers","help/oem-integrations/tesla/faqs"]}]},{"group":"For Vehicle Owners","pages":["help/research-fleet","help/connect-your-car"]},{"group":"New Features","pages":["help/feature-request"]}],"primaryTab":{"name":"Getting Started"},"tabs":[{"name":"Connect Docs","url":"connect","_id":"673bb1d5a599ce3e544ccadd"},{"name":"API Reference","url":"api-reference","_id":"673bb1d5a599ce3e544ccade"},{"name":"Help Center","url":"help","_id":"673bb1d5a599ce3e544ccadf"},{"name":"Changelog","url":"changelog","_id":"673bb1d5a599ce3e544ccae0"}],"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/smartcar/","github":"https://github.com/smartcar","facebook":"https://www.facebook.com/smartcar/","instagram":"https://www.instagram.com/mysmartcar/","x":"https://x.com/mysmartcar/"},"links":[{"title":"Product","links":[{"label":"Platform features","url":"https://smartcar.com/product/features"},{"label":"Dashboard features","url":"https://smartcar.com/product/smartcar-dashboard"},{"label":"Connect features","url":"https://smartcar.com/product/connect"},{"label":"Smartcar for EVs","url":"https://smartcar.com/product/electric-vehicle-api"},{"label":"Compatible vehicles","url":"https://smartcar.com/product/compatible-vehicles"},{"label":"Global coverage","url":"https://smartcar.com/global"},{"label":"Pricing","url":"https://smartcar.com/pricing"},{"label":"Status","url":"https://status.smartcar.com/"},{"label":"Brand reliability","url":"https://brandreliability.smartcar.com/"},{"label":"Data security","url":"https://smartcar.com/data-security"}]},{"title":"Energy Solutions","links":[{"label":"DERMs","url":"https://smartcar.com/industries/derms-software"},{"label":"Virtual Power Plants (VPPs)","url":"https://smartcar.com/industries/virtual-power-plant"},{"label":"Utilities","url":"https://smartcar.com/utilities"},{"label":"Home energy management","url":"https://smartcar.com/industries/home-energy-management"},{"label":"EV charging networks","url":"https://smartcar.com/industries/ev-charging"},{"label":"Charge point operators","url":"https://smartcar.com/industries/charge-point-operator"},{"label":"E-mobility service providers","url":"https://smartcar.com/industries/e-mobility-service-providers"}]},{"title":"Solutions","links":[{"label":"Repair and maintenance","url":"https://smartcar.com/industries/repair-maintenance"},{"label":"Autocare software","url":"https://smartcar.com/industries/autocare-software"},{"label":"Auto dealership","url":"https://smartcar.com/industries/auto-dealership-software"},{"label":"Roadside assistance","url":"https://smartcar.com/industries/roadside-assistance"},{"label":"Vehicle history reports","url":"https://smartcar.com/industries/vehicle-history-reports"},{"label":"Small fleet management","url":"https://smartcar.com/industries/fleet-management"},{"label":"Car subscription service","url":"https://smartcar.com/industries/car-subscription-services"},{"label":"Car sharing","url":"https://smartcar.com/industries/car-sharing"},{"label":"Ride hailing","url":"https://smartcar.com/industries/ride-sharing"},{"label":"Car rentals","url":"https://smartcar.com/industries/car-rental"},{"label":"Auto insurance","url":"https://smartcar.com/industries/auto-insurance"},{"label":"Warranty software","url":"https://smartcar.com/industries/warranty-management-software"},{"label":"Road usage charge","url":"https://smartcar.com/industries/road-usage-charge"}]},{"title":"Resources","links":[{"label":"Customers","url":"https://smartcar.com/customers"},{"label":"Blog","url":"https://smartcar.com/blog"},{"label":"Events","url":"https://smartcar.com/events"},{"label":"For vehicle owners","url":"https://smartcar.com/vehicle-owners"},{"label":"For automakers","url":"https://smartcar.com/automakers"},{"label":"Terms of service","url":"https://smartcar.com/legal/terms"},{"label":"Privacy policy","url":"https://smartcar.com/legal/privacy"},{"label":"End user privacy policy","url":"https://smartcar.com/legal/end-user-privacy"},{"label":"Acceptable use","url":"https://smartcar.com/legal/acceptable-use"},{"label":"Data processing","url":"https://smartcar.com/legal/dpa"},{"label":"Vulnerability disclosure program","url":"https://smartcar.com/vdp"}]}]},"feedback":{"thumbsRating":true,"suggestEdit":false,"raiseIssue":false},"analytics":{"koala":{"publicApiKey":"pk_3a64cc4d12d7b978edffae0afd143df5b291"},"ga4":{"measurementId":"G-QHNXS91VZC"}},"integrations":{"frontchat":"3757914565b8f1e6878e68dda53b9bcd","osano":"https://cmp.osano.com/6oljBSOpgaeC1bmb/8ee5ee1d-6f07-4f39-8e35-dc27a77fd5d1/osano.js"},"isWhiteLabeled":true,"search":{"prompt":"✨ Ask Smartcar"},"repo":{"github":{"owner":"smartcar","repo":"docs","contentDirectory":"","deployBranch":"main","isPrivate":false}}},"pageMetadata":{"title":"Handle the Response","description":"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.","href":"/connect/handle-the-response"}}},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"}}},"__N_SSG":true},"page":"/_sites/[subdomain]/[[...slug]]","query":{"subdomain":"smartcar-docs","slug":["connect","handle-the-response"]},"buildId":"DLyUTdO3OSYUYl4V89rim","assetPrefix":"/docs","isFallback":false,"isExperimentalCompile":false,"gsp":true,"scriptLoader":[]}</script></html></body></html>