Your integration's client credentials (test or live). The token acts as your integration's team and
lasts 1 hour; request a new one when it expires. Send client_id, client_secret and
grant_type=client_credentials. No OAuth scopes are needed.
Headers
Plugchoice-Version
enum<string>
The API version to answer with (400 unknown-version for one this API does not know). Every response carries the version that answered in the same header.
Available options:
2026-10-07
Path Parameters
charger_id
string<uuid>
required
Response
OK
A charger as a caller sees it.
id
string<uuid>
required
identity
string
required
OCPP Chargepoint ID.
connection_status
enum<string>
required
Available options:
never_seen,
offline,
online
connectors
object[]
required
Show child attributes
device_type
enum<string>
required
The kind of device. A link session is about one kind; another type is 422 unsupported-device-type.
Available options:
charger,
meter
access
object | null
required
How your integration reaches the charger. Null for a Plugchoice user, who reads their own chargers.
Show child attributes
site_id
string<uuid> | null
required
Its site. Null for a user's charger your integration has access to, since the site isn't yours.
capabilities
object
required
What a host can offer for the charger, before it shows a button. More may be added (start_charging, …);
ignore the ones you don't know.
Show child attributes
created_at
string<date-time>
required
vendor
string | null
As reported in BootNotification.
model
string | null
serial_number
string | null
firmware_version
string | null
is_mid
boolean | null
Whether the charger has a MID-certified meter. Null when Plugchoice doesn't know its model, or whether that model has one.
last_connection_at
string<date-time> | null
status
enum<string> | null
OCPP 1.6 status of connector 0, null until reported.
Available options:
Available,
Faulted,
Unavailable,
null
external_user_id
string | null
The user of yours whose site it is, if any. Always null for a Plugchoice user.
Required string length: 1 - 200
Pattern: ^[A-Za-z0-9._:@-]+$
reference
string | null
Your label for it (charger_reference from the client session that added it; for a Plugchoice user, their current team's label).
setup
object | null
The charger's electrical setup.
Show child attributes
link_session_id
string<uuid> | null
The link session that added it; null for chargers added outside Link.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Plugchoice","colors":{"primary":"#0A9181","light":"#0DC5B0","dark":"#067A6E"},"logo":{"light":"https://mintcdn.com/plugchoice/eZ0Fh74qpY1uDCtr/logo/light.svg?fit=max\u0026auto=format\u0026n=eZ0Fh74qpY1uDCtr\u0026q=85\u0026s=88552bc081220e60427c2fe1edfc53c1","dark":"https://mintcdn.com/plugchoice/eZ0Fh74qpY1uDCtr/logo/dark.svg?fit=max\u0026auto=format\u0026n=eZ0Fh74qpY1uDCtr\u0026q=85\u0026s=35eafae239f5af532b4f7f19f0908a66"},"favicon":"https://mintcdn.com/plugchoice/eZ0Fh74qpY1uDCtr/favicon.svg?fit=max\u0026auto=format\u0026n=eZ0Fh74qpY1uDCtr\u0026q=85\u0026s=5adfe64a5c3bb6f18d4256d32a1c9bd9","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://api.plugchoice.com"}},"navbar":{"links":[{"href":"https://support.plugchoice.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.plugchoice.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/plugchoice"}},"contextual":{"options":["copy","claude","chatgpt","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"plugchoice","hasAudioNarration":false,"actualSubdomain":"plugchoice","customDomains":["developer.plugchoice.com"],"gitSource":{"type":"github","owner":"volttime","repo":"core","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b005bfb516a3bcb360d323e","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API","count":104},{"language":"default","tag":"SDK","count":95},{"language":"default","tag":"Chargers","count":62},{"language":"default","tag":"Errors","count":51},{"language":"default","tag":"All codes","count":50},{"language":"default","tag":"Locations","count":32},{"language":"default","tag":"Settings","count":17},{"language":"default","tag":"Data","count":17},{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#navbar.is-wide~#body-content #content-area{max-width:88rem}"}]}
{"page":{"pagePath":"sdk/api/get-charger","slug":"/sdk/api/get-charger","pageMetadata":{"title":"Get a charger","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /chargers/{charger_id}","description":"One of the chargers `listChargers` would list for you.","href":"/sdk/api/get-charger"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"One of the chargers \", _jsx(_components.code, {\n children: \"listChargers\"\n }), \" would list for you.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a charger","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /chargers/{charger_id}","description":"One of the chargers `listChargers` would list for you.","href":"/sdk/api/get-charger"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getCharger","tags":["Chargers"],"summary":"Get a charger","description":"One of the chargers `listChargers` would list for you.","security":["23e66df4-7342-419f-a80a-bdeec4a4fcfc","b0af051b-5d49-48a0-92c3-047788484ce0"],"parameters":["5efbc35a-1552-41dd-b3c5-c707b69e344f","41528e5e-6dae-4656-9a7e-59b292a12251"],"responses":{"200":"8f4d47ca-1d52-4317-8ae6-0c331f10d16f","401":"8aab0fed-f86f-4276-8cef-d3fa3ef65621","404":"4cbb1cbd-c00d-49fd-a28d-4e338bf71360"},"method":"get","type":"path","servers":["990a0103-0872-4dad-82c2-1499a06d3515"],"path":"/chargers/{charger_id}","baseUrlOptions":["https://api.plugchoice.com/sdk/v1"],"title":"Get a charger","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5efbc35a-1552-41dd-b3c5-c707b69e344f":{"name":"Plugchoice-Version","in":"header","required":false,"description":"The API version to answer with (`400 unknown-version` for one this API does not know). Every response carries the version that answered in the same header.","schema":{"type":"string","enum":["2026-10-07"],"isRequired":false,"description":"The API version to answer with (`400 unknown-version` for one this API does not know). Every response carries the version that answered in the same header.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"41528e5e-6dae-4656-9a7e-59b292a12251":{"name":"charger_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"8f4d47ca-1d52-4317-8ae6-0c331f10d16f":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"A charger as a caller sees it.","required":["device_type","access","site_id","capabilities","created_at","id","identity","connection_status","connectors"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"identity":{"type":"string","description":"OCPP Chargepoint ID.","isRequired":true,"uniqueKey":"identity","typeLabel":"string"},"connection_status":{"type":"string","enum":["never_seen","offline","online"],"isRequired":true,"uniqueKey":"connection_status","typeLabel":"enum\u003cstring>"},"connectors":{"type":"array","items":{"type":"object","required":["connector_id","status"],"properties":{"connector_id":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"connectors.items.[INDEX].connector_id","typeLabel":"integer"},"status":{"oneOf":[{"type":"string","description":"OCPP 1.6 connector status, null until reported.","enum":["Available","Preparing","Charging","SuspendedEVSE","SuspendedEV","Finishing","Reserved","Unavailable","Faulted",null],"isRequired":true,"uniqueKey":"connectors.items.[INDEX].status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"OCPP 1.6 connector status, null until reported.","enum":["Available","Preparing","Charging","SuspendedEVSE","SuspendedEV","Finishing","Reserved","Unavailable","Faulted",null],"isRequired":true,"uniqueKey":"connectors.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"connectors.items.[INDEX].status","typeLabel":"enum\u003cstring> | null"},"max_amperage":{"oneOf":[{"type":"integer","uniqueKey":"connectors.items.[INDEX].max_amperage.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"connectors.items.[INDEX].max_amperage.oneOf.1","typeLabel":"null"}],"uniqueKey":"connectors.items.[INDEX].max_amperage","typeLabel":"integer | null"},"current_limit":{"oneOf":[{"type":"number","description":"Current limit in A, as set by Plugchoice.","uniqueKey":"connectors.items.[INDEX].current_limit.oneOf.0","typeLabel":"number"},{"type":"null","description":"Current limit in A, as set by Plugchoice.","uniqueKey":"connectors.items.[INDEX].current_limit.oneOf.1","typeLabel":"null"}],"uniqueKey":"connectors.items.[INDEX].current_limit","typeLabel":"number | null"},"power_type":{"oneOf":[{"type":"string","enum":["AC_1_PHASE","AC_2_PHASE","AC_2_PHASE_SPLIT","AC_3_PHASE","DC",null],"uniqueKey":"connectors.items.[INDEX].power_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["AC_1_PHASE","AC_2_PHASE","AC_2_PHASE_SPLIT","AC_3_PHASE","DC",null],"uniqueKey":"connectors.items.[INDEX].power_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"connectors.items.[INDEX].power_type","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"connectors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"connectors","typeLabel":"object[]"},"device_type":{"type":"string","description":"The kind of device. A link session is about one kind; another type is `422 unsupported-device-type`.","enum":["charger","meter"],"isRequired":true,"uniqueKey":"device_type","typeLabel":"enum\u003cstring>"},"access":{"oneOf":[{"type":"object","description":"How your integration reaches the charger. Null for a Plugchoice user, who reads their own chargers.","required":["ownership","scopes"],"properties":{"ownership":{"type":"string","enum":["partner","user"],"description":"`partner`: your team owns it. `user`: its owner, a Plugchoice user, gave your integration access.","isRequired":true,"uniqueKey":"access.oneOf.0.ownership","typeLabel":"enum\u003cstring>"},"scopes":{"type":"array","description":"What you may do with it. Every scope for your own chargers; for a user's, the scopes they agreed to.","items":{"type":"string","enum":["charger:read","sessions:read","charger:control","site:read"],"uniqueKey":"access.oneOf.0.scopes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"access.oneOf.0.scopes","typeLabel":"enum\u003cstring>[]"}},"isRequired":true,"uniqueKey":"access.oneOf.0","typeLabel":"object"},{"type":"null","description":"How your integration reaches the charger. Null for a Plugchoice user, who reads their own chargers.","isRequired":true,"uniqueKey":"access.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"access","typeLabel":"object | null"},"site_id":{"oneOf":[{"type":"string","format":"uuid","description":"Its site. Null for a user's charger your integration has access to, since the site isn't yours.","isRequired":true,"uniqueKey":"site_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Its site. Null for a user's charger your integration has access to, since the site isn't yours.","isRequired":true,"uniqueKey":"site_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"site_id","typeLabel":"string\u003cuuid> | null"},"capabilities":{"type":"object","description":"What a host can offer for the charger, before it shows a button. More may be added (`start_charging`, …);\nignore the ones you don't know.\n","required":["electrical_setup","reconnect"],"properties":{"electrical_setup":{"type":"object","required":["capable","needs"],"properties":{"capable":{"type":"boolean","isRequired":true,"uniqueKey":"capabilities.electrical_setup.capable","typeLabel":"boolean"},"needs":{"type":"array","description":"What the phone or browser must have for it; check with the SDK's `transports()` (a browser has none but `ble` in Chrome and Edge). Empty when not capable.","items":{"type":"string","description":"Something the phone or browser must be able to do for an onboarding method or a charger capability:\n`wifi` (join a charger's Wi-Fi), `http` and `socket` (talk to devices on the local network), `lan` (find\ndevices on the home network), `ble` (Bluetooth). Your app checks them with the SDK's `transports()`,\nwhich depend on the device and on your app's configuration. A browser has none, except `ble` in Chrome\nand Edge (Web Bluetooth).\n","enum":["wifi","http","socket","lan","ble"],"uniqueKey":"capabilities.electrical_setup.needs.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"capabilities.electrical_setup.needs","typeLabel":"enum\u003cstring>[]"}},"description":"Plugchoice can apply an electrical setup to its model (`action: setup`).","isRequired":true,"uniqueKey":"capabilities.electrical_setup","typeLabel":"object"},"reconnect":{"type":"object","description":"Get it reaching Plugchoice again, or change its network (`action: reconnect`). Always capable. Link checks\nthe charger's OCPP websocket and sets it when it's wrong, shows its connections where its brand reports\nthem, and imports nothing again. `needs` is what its brand's flow needs from the phone; without them, or\nwithout a flow for its model, Link offers what it can (the manual steps, or the Plugchoice app).\n","required":["network","capable","needs"],"properties":{"capable":{"type":"boolean","isRequired":true,"uniqueKey":"capabilities.reconnect.capable","typeLabel":"boolean"},"needs":{"type":"array","description":"What the phone or browser must have for it; check with the SDK's `transports()` (a browser has none but `ble` in Chrome and Edge). Empty when not capable.","items":{"type":"string","description":"Something the phone or browser must be able to do for an onboarding method or a charger capability:\n`wifi` (join a charger's Wi-Fi), `http` and `socket` (talk to devices on the local network), `lan` (find\ndevices on the home network), `ble` (Bluetooth). Your app checks them with the SDK's `transports()`,\nwhich depend on the device and on your app's configuration. A browser has none, except `ble` in Chrome\nand Edge (Web Bluetooth).\n","enum":["wifi","http","socket","lan","ble"],"uniqueKey":"capabilities.reconnect.needs.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"capabilities.reconnect.needs","typeLabel":"enum\u003cstring>[]"},"network":{"type":"boolean","description":"Link can change the charger's network (Wi-Fi, Ethernet, mobile), for a \"Network settings\" button.","isRequired":true,"uniqueKey":"capabilities.reconnect.network","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"capabilities.reconnect","typeLabel":"object"}},"isRequired":true,"uniqueKey":"capabilities","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"vendor":{"oneOf":[{"type":"string","description":"As reported in BootNotification.","uniqueKey":"vendor.oneOf.0","typeLabel":"string"},{"type":"null","description":"As reported in BootNotification.","uniqueKey":"vendor.oneOf.1","typeLabel":"null"}],"uniqueKey":"vendor","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"serial_number":{"oneOf":[{"type":"string","uniqueKey":"serial_number.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"serial_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"serial_number","typeLabel":"string | null"},"firmware_version":{"oneOf":[{"type":"string","uniqueKey":"firmware_version.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"firmware_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"firmware_version","typeLabel":"string | null"},"is_mid":{"oneOf":[{"type":"boolean","description":"Whether the charger has a MID-certified meter. Null when Plugchoice doesn't know its model, or whether that model has one.","uniqueKey":"is_mid.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the charger has a MID-certified meter. Null when Plugchoice doesn't know its model, or whether that model has one.","uniqueKey":"is_mid.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_mid","typeLabel":"boolean | null"},"last_connection_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"last_connection_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"last_connection_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_connection_at","typeLabel":"string\u003cdate-time> | null"},"status":{"oneOf":[{"type":"string","description":"OCPP 1.6 status of connector 0, null until reported.","enum":["Available","Faulted","Unavailable",null],"uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"OCPP 1.6 status of connector 0, null until reported.","enum":["Available","Faulted","Unavailable",null],"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"external_user_id":{"oneOf":[{"type":"string","description":"The user of yours whose site it is, if any. Always null for a Plugchoice user.","maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9._:@-]+$","uniqueKey":"external_user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user of yours whose site it is, if any. Always null for a Plugchoice user.","uniqueKey":"external_user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_user_id","typeLabel":"string | null"},"reference":{"oneOf":[{"type":"string","description":"Your label for it (`charger_reference` from the client session that added it; for a Plugchoice user, their current team's label).","uniqueKey":"reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your label for it (`charger_reference` from the client session that added it; for a Plugchoice user, their current team's label).","uniqueKey":"reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference","typeLabel":"string | null"},"setup":{"oneOf":[{"type":"object","description":"The charger's electrical setup.","required":["phases","max_current"],"properties":{"phases":{"type":"integer","enum":[1,3],"isRequired":true,"uniqueKey":"setup.oneOf.0.phases","typeLabel":"enum\u003cinteger>"},"max_current":{"type":"integer","minimum":6,"description":"Ampere per phase.","isRequired":true,"uniqueKey":"setup.oneOf.0.max_current","typeLabel":"integer"},"net_type":{"oneOf":[{"type":"string","enum":["IT","TT","TN","unknown",null],"uniqueKey":"setup.oneOf.0.net_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["IT","TT","TN","unknown",null],"uniqueKey":"setup.oneOf.0.net_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"setup.oneOf.0.net_type","typeLabel":"enum\u003cstring> | null"},"phase_rotation":{"oneOf":[{"type":"string","description":"Length must equal `phases` (`R`, `S`, `T` for 1 phase; `RST`, `RTS`, `SRT`, `STR`, `TRS`, `TSR` for 3).","enum":["R","S","T","RST","RTS","SRT","STR","TRS","TSR",null],"uniqueKey":"setup.oneOf.0.phase_rotation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Length must equal `phases` (`R`, `S`, `T` for 1 phase; `RST`, `RTS`, `SRT`, `STR`, `TRS`, `TSR` for 3).","enum":["R","S","T","RST","RTS","SRT","STR","TRS","TSR",null],"uniqueKey":"setup.oneOf.0.phase_rotation.oneOf.1","typeLabel":"null"}],"uniqueKey":"setup.oneOf.0.phase_rotation","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"setup.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"setup.oneOf.1","typeLabel":"null"}],"uniqueKey":"setup","typeLabel":"object | null"},"link_session_id":{"oneOf":[{"type":"string","format":"uuid","description":"The link session that added it; null for chargers added outside Link.","uniqueKey":"link_session_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The link session that added it; null for chargers added outside Link.","uniqueKey":"link_session_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"link_session_id","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","identity":"\u003cstring>","connection_status":"never_seen","connectors":[{"connector_id":2,"status":"Available","max_amperage":123,"current_limit":123,"power_type":"AC_1_PHASE"}],"device_type":"charger","access":{"ownership":"partner","scopes":["charger:read"]},"site_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","capabilities":{"electrical_setup":{"capable":true,"needs":["wifi"]},"reconnect":{"capable":true,"needs":["wifi"],"network":true}},"created_at":"2023-11-07T05:31:56Z","vendor":"\u003cstring>","model":"\u003cstring>","serial_number":"\u003cstring>","firmware_version":"\u003cstring>","is_mid":true,"last_connection_at":"2023-11-07T05:31:56Z","status":"Available","external_user_id":"\u003cstring>","reference":"\u003cstring>","setup":{"phases":1,"max_current":7,"net_type":"IT","phase_rotation":"R"},"link_session_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"8aab0fed-f86f-4276-8cef-d3fa3ef65621":{"description":"Missing, invalid or expired token (`unauthenticated`).","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"Stable identifier, `https://developer.plugchoice.com/sdk/errors/{code}`.","examples":["https://developer.plugchoice.com/sdk/errors/identity-taken"],"isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","examples":["Identity already registered"],"isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"code":{"type":"string","description":"The last path segment of `type`, for switch statements. New codes may be added.","enum":["unauthenticated","forbidden","scope-missing","sdk-access-required","profile-incomplete","sign-in-not-needed","sign-in-required","site-not-saved","sign-in-code-required","code-invalid","two-factor-not-needed","two-factor-invalid","two-factor-locked","not-found","validation-failed","rate-limited","unknown-version","unsupported-device-type","scope-required","client-session-expired","site-required","start-code-invalid","session-ended","consent-required","consent-not-needed","location-required","location-already-set","method-not-allowed","identity-taken","identity-not-taken","meter-not-found","charger-at-other-site","handover-not-offered","control-held","pincode-invalid","claim-exists","claim-limit","claim-closed","charger-offline","plug-in-not-available","nothing-to-complete","vendor-sign-in-failed","vendor-sign-in-required","vendor-not-permitted","vendor-charger-offline","vendor-rate-limited","vendor-unavailable","vendor-error","bad-request","server-error"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only for `validation-failed`. Field path → messages.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors","typeLabel":"object"},"site":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"site.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"site.name","typeLabel":"string"}},"description":"Only for `charger-at-other-site`.","uniqueKey":"site","typeLabel":"object"},"claimable":{"type":"boolean","description":"Only for `identity-taken`. Whether `POST /session/claims` can be tried.","uniqueKey":"claimable","typeLabel":"boolean"},"sign_in_to_share":{"type":"boolean","description":"Only for `identity-taken`, in a link session for your user's own account before they signed in. The\ncharger may already be in their account: once signed in, they share it (`POST /session/chargers/{charger_id}/share`).\n","uniqueKey":"sign_in_to_share","typeLabel":"boolean"},"vendor_charger":{"type":"object","description":"Only for problems connecting a Zaptec installation's chargers in the hosted flow. Which charger of the installation it is about.","required":["id","serial"],"properties":{"id":{"type":"string","description":"The brand's id (`ZaptecCharger.id`).","isRequired":true,"uniqueKey":"vendor_charger.id","typeLabel":"string"},"serial":{"type":"string","isRequired":true,"uniqueKey":"vendor_charger.serial","typeLabel":"string"}},"uniqueKey":"vendor_charger","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://developer.plugchoice.com/sdk/errors/identity-taken","title":"Identity already registered","status":123,"detail":"\u003cstring>","code":"unauthenticated","errors":{},"site":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>"},"claimable":true,"sign_in_to_share":true,"vendor_charger":{"id":"\u003cstring>","serial":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4cbb1cbd-c00d-49fd-a28d-4e338bf71360":{"description":"No such resource for this caller or session (`not-found`).","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"Stable identifier, `https://developer.plugchoice.com/sdk/errors/{code}`.","examples":["https://developer.plugchoice.com/sdk/errors/identity-taken"],"isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","examples":["Identity already registered"],"isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"code":{"type":"string","description":"The last path segment of `type`, for switch statements. New codes may be added.","enum":["unauthenticated","forbidden","scope-missing","sdk-access-required","profile-incomplete","sign-in-not-needed","sign-in-required","site-not-saved","sign-in-code-required","code-invalid","two-factor-not-needed","two-factor-invalid","two-factor-locked","not-found","validation-failed","rate-limited","unknown-version","unsupported-device-type","scope-required","client-session-expired","site-required","start-code-invalid","session-ended","consent-required","consent-not-needed","location-required","location-already-set","method-not-allowed","identity-taken","identity-not-taken","meter-not-found","charger-at-other-site","handover-not-offered","control-held","pincode-invalid","claim-exists","claim-limit","claim-closed","charger-offline","plug-in-not-available","nothing-to-complete","vendor-sign-in-failed","vendor-sign-in-required","vendor-not-permitted","vendor-charger-offline","vendor-rate-limited","vendor-unavailable","vendor-error","bad-request","server-error"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only for `validation-failed`. Field path → messages.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors","typeLabel":"object"},"site":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"site.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"site.name","typeLabel":"string"}},"description":"Only for `charger-at-other-site`.","uniqueKey":"site","typeLabel":"object"},"claimable":{"type":"boolean","description":"Only for `identity-taken`. Whether `POST /session/claims` can be tried.","uniqueKey":"claimable","typeLabel":"boolean"},"sign_in_to_share":{"type":"boolean","description":"Only for `identity-taken`, in a link session for your user's own account before they signed in. The\ncharger may already be in their account: once signed in, they share it (`POST /session/chargers/{charger_id}/share`).\n","uniqueKey":"sign_in_to_share","typeLabel":"boolean"},"vendor_charger":{"type":"object","description":"Only for problems connecting a Zaptec installation's chargers in the hosted flow. Which charger of the installation it is about.","required":["id","serial"],"properties":{"id":{"type":"string","description":"The brand's id (`ZaptecCharger.id`).","isRequired":true,"uniqueKey":"vendor_charger.id","typeLabel":"string"},"serial":{"type":"string","isRequired":true,"uniqueKey":"vendor_charger.serial","typeLabel":"string"}},"uniqueKey":"vendor_charger","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"https://developer.plugchoice.com/sdk/errors/identity-taken","title":"Identity already registered","status":123,"detail":"\u003cstring>","code":"unauthenticated","errors":{},"site":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>"},"claimable":true,"sign_in_to_share":true,"vendor_charger":{"id":"\u003cstring>","serial":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"23e66df4-7342-419f-a80a-bdeec4a4fcfc":{"integrationToken":{"type":"oauth2","description":"Your integration's client credentials (test or live). The token acts as your integration's team and\nlasts 1 hour; request a new one when it expires. Send `client_id`, `client_secret` and\n`grant_type=client_credentials`. No OAuth scopes are needed.\n","flows":{"clientCredentials":{"tokenUrl":"https://app.plugchoice.com/oauth/token","scopes":{}}},"scopes":[],"schemeName":"integrationToken"}},"b0af051b-5d49-48a0-92c3-047788484ce0":{"userToken":{"type":"http","scheme":"bearer","description":"A Plugchoice user's OAuth access token or personal access token, acting for that user.\n","scopes":[],"schemeName":"userToken"}}},"servers":{"990a0103-0872-4dad-82c2-1499a06d3515":{"url":"https://api.plugchoice.com/sdk/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"Your integration's client credentials (test or live). The token acts as your integration's team and\nlasts 1 hour; request a new one when it expires. Send `client_id`, `client_secret` and\n`grant_type=client_credentials`. No OAuth scopes are needed.\n","flows":{"clientCredentials":{"tokenUrl":"https://app.plugchoice.com/oauth/token","scopes":{}}},"scopes":[],"schemeName":"integrationToken"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Your integration's client credentials (test or live). The token acts as your integration's team and\nlasts 1 hour; request a new one when it expires. Send `client_id`, `client_secret` and\n`grant_type=client_credentials`. No OAuth scopes are needed.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"integrationToken","name":"Authorization"}],"title":"integrationToken"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Plugchoice user's OAuth access token or personal access token, acting for that user.\n","scopes":[],"schemeName":"userToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Plugchoice user's OAuth access token or personal access token, acting for that user.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"userToken","name":"Authorization"}],"title":"userToken"}]},"originalFileLocation":"api-reference/sdk/sdk-v1.openapi.yaml"},"subdomain":"plugchoice","siteName":"Plugchoice","title":"Get a charger - Plugchoice","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T14:31:22.094Z","originalFileLocation":"sdk/api/get-charger.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"One of the chargers listChargers would list for you.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Plugchoice\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a charger - Plugchoice\">\u003cmeta data-mint-head property=\"og:description\" content=\"One of the chargers listChargers would list for you.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Plugchoice\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.plugchoice.com/sdk/api/get-charger\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://plugchoice.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+a+charger\u0026amp;description=One+of+the+chargers+%60listChargers%60+would+list+for+you.\u0026amp;theme=6eb8803a51fb7c8c8b12a7b6\u0026amp;signature=d3fda487056bfec979559b920473c1bc65c7ff8873026d23e6d6d463315675a9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a charger - Plugchoice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One of the chargers listChargers would list for you.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plugchoice.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+a+charger\u0026amp;description=One+of+the+chargers+%60listChargers%60+would+list+for+you.\u0026amp;theme=6eb8803a51fb7c8c8b12a7b6\u0026amp;signature=d3fda487056bfec979559b920473c1bc65c7ff8873026d23e6d6d463315675a9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/plugchoice/p35iseFFU6_Wofx1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Plugchoice\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A9181\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.plugchoice.com/sdk/api/get-charger\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk/api/get-charger.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.plugchoice.com/#organization\",\"name\":\"Plugchoice\",\"url\":\"https://developer.plugchoice.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/plugchoice/eZ0Fh74qpY1uDCtr/logo/light.svg?fit=max\u0026auto=format\u0026n=eZ0Fh74qpY1uDCtr\u0026q=85\u0026s=88552bc081220e60427c2fe1edfc53c1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.plugchoice.com#website\",\"name\":\"Plugchoice\",\"url\":\"https://developer.plugchoice.com\",\"publisher\":{\"@id\":\"https://developer.plugchoice.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.plugchoice.com/sdk/api/get-charger#webpage\",\"url\":\"https://developer.plugchoice.com/sdk/api/get-charger\",\"name\":\"Get a charger\",\"description\":\"One of the chargers listChargers would list for you.\",\"dateModified\":\"2026-10-07T14:31:22.094Z\",\"isPartOf\":{\"@id\":\"https://developer.plugchoice.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.plugchoice.com/sdk/api/get-charger#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.plugchoice.com/sdk/api/get-charger#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://developer.plugchoice.com/sdk/api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a charger\",\"item\":\"https://developer.plugchoice.com/sdk/api/get-charger\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.plugchoice.com/sdk/api/get-charger#apireference\",\"headline\":\"Get a charger\",\"name\":\"Get a charger\",\"description\":\"One of the chargers listChargers would list for you.\",\"url\":\"https://developer.plugchoice.com/sdk/api/get-charger\",\"mainEntityOfPage\":{\"@id\":\"https://developer.plugchoice.com/sdk/api/get-charger#webpage\"},\"dateModified\":\"2026-10-07T14:31:22.094Z\",\"publisher\":{\"@id\":\"https://developer.plugchoice.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.plugchoice.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Plugchoice\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Plugchoice\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk/api/get-charger.md","siteName":"Plugchoice","nav":{"global":null,"tabs":[{"tab":"SDK","groups":[{"group":"Get started","tag":"Beta","pages":[{"title":"Plugchoice SDK","sidebarTitle":"Overview","href":"/sdk"},{"title":"How Link works","href":"/sdk/how-link-works"},{"title":"Get started","href":"/sdk/get-started"},{"title":"Installation","href":"/sdk/install"}]},{"group":"Platforms","pages":[{"title":"iOS","href":"/sdk/ios"},{"title":"Android","href":"/sdk/android"},{"title":"React Native","href":"/sdk/react-native"},{"title":"In a browser","href":"/sdk/web"}]},{"group":"Concepts","pages":[{"title":"Client sessions and scopes","sidebarTitle":"Client sessions","href":"/sdk/concepts/client-sessions"},{"title":"Actions","href":"/sdk/concepts/actions"},{"title":"Link sessions","href":"/sdk/concepts/link-sessions"},{"title":"Devices and capabilities","sidebarTitle":"Devices and capabilities","href":"/sdk/concepts/capabilities"},{"title":"Consent and branding","href":"/sdk/concepts/consent-and-branding"},{"title":"Test and live","href":"/sdk/concepts/test-and-live"}]},{"group":"Chargers","pages":[{"title":"Supported chargers","mode":"wide","href":"/sdk/chargers/index"},{"title":"Alfen","href":"/sdk/chargers/alfen"},{"title":"Charge Amps","href":"/sdk/chargers/charge-amps"},{"title":"Easee","href":"/sdk/chargers/easee"},{"title":"Enovates","href":"/sdk/chargers/enovates"},{"title":"go-e","href":"/sdk/chargers/go-e"},{"title":"Peblar","href":"/sdk/chargers/peblar"},{"title":"Ratio","href":"/sdk/chargers/ratio"},{"title":"SolarEdge","href":"/sdk/chargers/solaredge"},{"title":"Teltonika","href":"/sdk/chargers/teltonika"},{"title":"Volt Time","href":"/sdk/chargers/volt-time"},{"title":"Wallbox","href":"/sdk/chargers/wallbox"},{"title":"Webasto","href":"/sdk/chargers/webasto"},{"title":"Zaptec","href":"/sdk/chargers/zaptec"},{"title":"Other OCPP chargers","href":"/sdk/chargers/other"}]},{"group":"Meters","pages":[{"title":"Meters","href":"/sdk/meters/index"},{"title":"Chargee","href":"/sdk/meters/chargee"},{"title":"Reduxi","href":"/sdk/meters/reduxi"}]},{"group":"API reference","pages":[{"title":"SDK API","sidebarTitle":"Introduction","href":"/sdk/api/index"},{"title":"Create a client session","openapi":"api-reference/sdk/sdk-v1.openapi.yaml POST /client-sessions","href":"/sdk/api/create-client-session"},{"title":"Get a link session","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /link-sessions/{link_session_id}","href":"/sdk/api/get-link-session"},{"title":"List chargers","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /chargers","description":"Newest first, with what each can do (`capabilities`): for an integration every charger at a site its team\nowns, whether Link added it or not, and every charger in a user's own Plugchoice account it has a grant\non; for a Plugchoice user the chargers at sites they have Sensitive access to. Filter by user\n(integrations) or site.\n","href":"/sdk/api/list-chargers"},{"title":"Get a charger","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /chargers/{charger_id}","href":"/sdk/api/get-charger"},{"title":"Remove a charger","openapi":"api-reference/sdk/sdk-v1.openapi.yaml DELETE /chargers/{charger_id}","description":"A user's charger your integration has access to only loses that access: it stays in their own Plugchoice\naccount. A charger your team owns is released: deleted with its history, or, when that's not possible\n(a Volt Time charger, or one with billing or roaming records), taken off its site and team with the card\nids removed from its charging sessions, and refused when it connects. The same answer for a charger\nthat's gone already or that you can't reach, so retrying is safe.\n","href":"/sdk/api/remove-charger"},{"title":"Remove a customer","openapi":"api-reference/sdk/sdk-v1.openapi.yaml DELETE /customers/{external_user_id}","href":"/sdk/api/remove-customer"},{"title":"List transactions","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /transactions","href":"/sdk/api/list-transactions"},{"title":"Get a transaction","openapi":"api-reference/sdk/sdk-v1.openapi.yaml GET /transactions/{transaction_id}","href":"/sdk/api/get-transaction"}]},{"group":"Errors","pages":[{"title":"Errors","href":"/sdk/errors/index"},{"group":"All codes","pages":[{"title":"bad-request","href":"/sdk/errors/bad-request"},{"title":"charger-at-other-site","href":"/sdk/errors/charger-at-other-site"},{"title":"charger-offline","href":"/sdk/errors/charger-offline"},{"title":"claim-closed","href":"/sdk/errors/claim-closed"},{"title":"claim-exists","href":"/sdk/errors/claim-exists"},{"title":"claim-limit","href":"/sdk/errors/claim-limit"},{"title":"client-session-expired","href":"/sdk/errors/client-session-expired"},{"title":"control-held","href":"/sdk/errors/control-held"},{"title":"code-invalid","href":"/sdk/errors/code-invalid"},{"title":"consent-not-needed","href":"/sdk/errors/consent-not-needed"},{"title":"consent-required","href":"/sdk/errors/consent-required"},{"title":"forbidden","href":"/sdk/errors/forbidden"},{"title":"handover-not-offered","href":"/sdk/errors/handover-not-offered"},{"title":"identity-not-taken","href":"/sdk/errors/identity-not-taken"},{"title":"meter-not-found","href":"/sdk/errors/meter-not-found"},{"title":"identity-taken","href":"/sdk/errors/identity-taken"},{"title":"location-already-set","href":"/sdk/errors/location-already-set"},{"title":"location-required","href":"/sdk/errors/location-required"},{"title":"method-not-allowed","href":"/sdk/errors/method-not-allowed"},{"title":"not-found","href":"/sdk/errors/not-found"},{"title":"nothing-to-complete","href":"/sdk/errors/nothing-to-complete"},{"title":"pincode-invalid","href":"/sdk/errors/pincode-invalid"},{"title":"plug-in-not-available","href":"/sdk/errors/plug-in-not-available"},{"title":"profile-incomplete","href":"/sdk/errors/profile-incomplete"},{"title":"rate-limited","href":"/sdk/errors/rate-limited"},{"title":"scope-missing","href":"/sdk/errors/scope-missing"},{"title":"scope-required","href":"/sdk/errors/scope-required"},{"title":"sdk-access-required","href":"/sdk/errors/sdk-access-required"},{"title":"server-error","href":"/sdk/errors/server-error"},{"title":"session-ended","href":"/sdk/errors/session-ended"},{"title":"sign-in-code-required","href":"/sdk/errors/sign-in-code-required"},{"title":"sign-in-not-needed","href":"/sdk/errors/sign-in-not-needed"},{"title":"sign-in-required","href":"/sdk/errors/sign-in-required"},{"title":"site-not-saved","href":"/sdk/errors/site-not-saved"},{"title":"site-required","href":"/sdk/errors/site-required"},{"title":"start-code-invalid","href":"/sdk/errors/start-code-invalid"},{"title":"two-factor-invalid","href":"/sdk/errors/two-factor-invalid"},{"title":"two-factor-locked","href":"/sdk/errors/two-factor-locked"},{"title":"two-factor-not-needed","href":"/sdk/errors/two-factor-not-needed"},{"title":"unauthenticated","href":"/sdk/errors/unauthenticated"},{"title":"unknown-version","href":"/sdk/errors/unknown-version"},{"title":"unsupported-device-type","href":"/sdk/errors/unsupported-device-type"},{"title":"validation-failed","href":"/sdk/errors/validation-failed"},{"title":"vendor-charger-offline","href":"/sdk/errors/vendor-charger-offline"},{"title":"vendor-error","href":"/sdk/errors/vendor-error"},{"title":"vendor-not-permitted","href":"/sdk/errors/vendor-not-permitted"},{"title":"vendor-rate-limited","href":"/sdk/errors/vendor-rate-limited"},{"title":"vendor-sign-in-failed","href":"/sdk/errors/vendor-sign-in-failed"},{"title":"vendor-sign-in-required","href":"/sdk/errors/vendor-sign-in-required"},{"title":"vendor-unavailable","href":"/sdk/errors/vendor-unavailable"}]}]},{"group":"Resources","pages":[{"title":"Security","href":"/sdk/security"},{"title":"Versions","href":"/sdk/versioning"},{"title":"Changelog","href":"/sdk/changelog"}]}]},{"tab":"API","pages":[{"title":"API","href":"/guides/introduction"}]},{"tab":"Map","pages":[{"title":"Map","href":"/map"}]}]},"basePath":"","title":"Get a charger - Plugchoice","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}