Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.
GET
/
drive
/
v1
/
users
/
{userId}
/
sessions
/
{sessionId}
Get details of a specific charging session
curl --request GET \ --url https://{environment}.plugsurfing.com/drive/v1/users/{userId}/sessions/{sessionId} \ --header 'X-API-Key: <api-key>'
When true, completed sessions include priceSegments (items use the CDR webhook cost segment object CdrWebhookCostSegment) and priceSegmentsIncludeVat. When false or omitted, neither field is returned. Any value other than true or false, including an empty value, returns 400.
Type "Long". This field is not relevant for External Clearing (only used when using Plugsurfing's Payment Service Provider). Represents the remaining amount to be paid, expressed as a negative number. A value of 0 indicates the balance is fully paid. -2160 means there is an outstanding amount of 21.60 in the currency of the session.
Returns the paymentMethod of the transaction with the earliest timestamp. This field is DEPRECATED and will be removed in future versions. Use session.transactions[].paymentMethod instead. Migration note: WRITE_OFF was renamed to NONE, where session.transactions[].paymentOutcome=WRITE_OFF is the replacement
Only returned when the request sets includePriceSegments=true, and only for completed sessions. Omitted when the session has no price breakdown; never returned as an empty array.
Each item has the same object and meaning as the cost segments in the CDR webhook (costSegments, CdrWebhookCostSegment). See CDR.
The currency of all amounts is price.currencyCode.
Unit mapping by type:
TIME, PARKING_TIME, CONGESTION_TIME: quantity is the number of billed steps; unit is {"type": "min", "amount": <step size in minutes, rounded up>} (for example a 60 s step gives 1, 90 s gives 2, 3600 s gives 60); pricePerUnitMinorUnitsInclVat is the price per step in minor units, as rounded by the upstream pricing.
ENERGY: quantity is in kWh; unit is {"type": "kWh", "amount": 1}; the unit price is per kWh.
FLAT, CAPPED: quantity is 1; unit is {"type": "session", "amount": 1}; pricePerUnitMinorUnitsInclVat equals segmentCostMinorUnitsExclVat; from and to are not returned. CAPPED is negative.
pricePerUnit is the upstream decimal price per unit when available; otherwise it is pricePerUnitMinorUnitsInclVat converted to major units using the currency's minor-unit digits (for example 2 for EUR, 0 for JPY).
VAT: when priceSegmentsIncludeVat is false (currently always), pricePerUnit and pricePerUnitMinorUnitsInclVat exclude VAT, despite the InclVat field name. This is the same convention as CdrWebhookCost.priceIncludesVat. vatRate is the session VAT percentage as a number (for example 19.0).
segmentCostMinorUnitsExclVat and segmentCostMinorUnitsInclVat come directly from the upstream pricing and are authoritative. Because the unit price is rounded, quantity × unit price is only approximately equal to segmentCostMinorUnitsExclVat.
Segments are returned in upstream (billing) order.
A segment with an unknown upstream type is dropped; other segments are still returned. If no segments remain, priceSegments and priceSegmentsIncludeVat are omitted.
Differences from the CDR Forwarding webhook: CONGESTION_TIME segments are included; when there are no segments the fields are omitted (no zero-cost FLAT segment is added); priceSegmentsIncludeVat is always false.
CAPPED is a negative adjustment applied when a price cap is reached; it is not an OCPI dimension. CONGESTION_TIME is Tesla-specific (not an OCPI 2.2.1 dimension).
Segments are returned individually and are never aggregated.
Whether pricePerUnit and pricePerUnitMinorUnitsInclVat in priceSegments include VAT. Returned only together with priceSegments. Mirrors CdrWebhookCost.priceIncludesVat. When false, pricePerUnit and pricePerUnitMinorUnitsInclVat exclude VAT. The Drive API currently always returns false.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Plugsurfing Developer","description":"Learn more about Plugsurfing's integration products, Drive API and Roam OCPI.","colors":{"primary":"#5D52DF","light":"#AFBEFB","dark":"#5D52DF"},"logo":{"light":"https://mintcdn.com/plugsurfing/ay5jxu8M27_-_9fk/images/onwhite.svg?fit=max\u0026auto=format\u0026n=ay5jxu8M27_-_9fk\u0026q=85\u0026s=7ec646a54bf62ff532848b6bddd19e22","dark":"https://mintcdn.com/plugsurfing/ay5jxu8M27_-_9fk/images/onblack.svg?fit=max\u0026auto=format\u0026n=ay5jxu8M27_-_9fk\u0026q=85\u0026s=4824e58d5186723bd365ba31b553e0c9"},"favicon":{"light":"https://mintcdn.com/plugsurfing/G3iCV0mKf6ZjNRoL/images/Favicon.png?fit=max\u0026auto=format\u0026n=G3iCV0mKf6ZjNRoL\u0026q=85\u0026s=52c0701b686a92fbb2858056e2b60b8d","dark":"https://mintcdn.com/plugsurfing/G3iCV0mKf6ZjNRoL/images/Favicon.png?fit=max\u0026auto=format\u0026n=G3iCV0mKf6ZjNRoL\u0026q=85\u0026s=52c0701b686a92fbb2858056e2b60b8d"},"appearance":{"default":"light","strict":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"plugsurfing","hasAudioNarration":false,"actualSubdomain":"plugsurfing","customDomains":["developer.plugsurfing.com"],"gitSource":{"type":"github","owner":"plugsurfing","repo":"drive-api-docs-mintlify","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b0666255dab49422b24b","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Drive API","count":88},{"language":"default","tag":"API reference","count":62},{"language":"default","tag":"Guides","count":36},{"language":"default","tag":"EMP mode","count":24},{"language":"default","tag":"Home","count":12},{"language":"default","tag":"Charging","count":12},{"language":"default","tag":"Charging keys","count":12},{"language":"default","tag":"Roam OCPI","count":12},{"language":"default","tag":"Network","count":11},{"language":"default","tag":"Payments","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#content table{border:1px solid #d9dce1!important;border-collapse:collapse!important;width:100%}#content table th,#content table td{border:1px solid #d9dce1!important;padding:0.75rem 1.25rem;text-align:left;vertical-align:top}#content table th{background:#f8f9fb;color:#343a43;font-weight:600}#content p,#content li{font-size:0.95rem;line-height:1.5}#content h1{font-size:2.25rem;line-height:1.15}#content h2{font-size:1.6rem;line-height:1.25}#content h3{font-size:1.3rem;line-height:1.3}#content table,#content table th,#content table td{font-size:0.9rem;line-height:1.4}html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table th:nth-child(1),html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table td:nth-child(1){white-space:nowrap;width:22%}html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table th:nth-child(2),html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table td:nth-child(2),html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table th:nth-child(3),html[data-current-path=\"/docs/roam-ocpi/module-overview\"] #content table td:nth-child(3){text-align:center;white-space:nowrap;width:10%}html[data-current-path=\"/changelog\"] #content [data-component-part=\"update-content\"] h2:first-child{color:#5d52df;font-size:1.5rem;line-height:1.25;margin:0}html[data-current-path=\"/changelog\"] #content [data-component-part=\"update-content\"] h2:first-child+p,html[data-current-path=\"/changelog\"] #content [data-component-part=\"update-content\"] h2:first-child+span[data-as=\"p\"]{border-bottom:1px solid #d9dce1;color:#68707d;font-size:0.95rem;font-style:normal;margin:0.5rem 0 1.25rem;padding-bottom:0.75rem;text-align:left}html[data-current-path=\"/changelog\"] #content [data-component-part=\"update-content\"] p,html[data-current-path=\"/changelog\"] #content [data-component-part=\"update-content\"] span[data-as=\"p\"]{font-size:1rem;line-height:1.6}#content-side-layout,#sidebar-content{width:16rem}#content-area{padding:0 3rem 0 3rem}#content-container>div:first-of-type{gap:0}#table-of-contents-layout{padding-left:0}.link:not(.nav-tabs-item){position:relative;color:#5d52df!important;font-weight:600;text-decoration:none!important;border-bottom:none!important}.link:not(.nav-tabs-item)::after{content:\"\";position:absolute;right:0;bottom:-3px;left:0;height:1px;background-color:currentColor;transform:scaleX(0);transform-origin:left;transition:transform 180ms ease,\n color 180ms ease}.link:not(.nav-tabs-item):hover{color:#4a40c7!important}.link:not(.nav-tabs-item):hover::after{transform:scaleX(1)}.link:not(.nav-tabs-item):active{color:#3d34ad!important}.link:not(.nav-tabs-item):focus-visible{outline:1px solid rgba(93, 82, 223, 0.35);outline-offset:4px;border-radius:3px}"}],"page":{"pagePath":"reference/getSessionById","slug":"/reference/getSessionById","pageMetadata":{"title":"Get details of a specific charging session","description":"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/sessions/{sessionId}","href":"/reference/getSessionById"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\"\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 details of a specific charging session","description":"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/sessions/{sessionId}","href":"/reference/getSessionById"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Sessions"],"summary":"Get details of a specific charging session","description":"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.","operationId":"getSessionById","parameters":["7d19633a-2f6f-4524-a825-0decdf5419f4","a7823664-06a6-4584-9a7d-44da57420c06","ef2f657f-8a21-47e8-8512-3744b66c97b6"],"responses":{"200":"4326fcc0-a5f8-4e05-9f86-2c644fa7785c","400":"fe63bd6b-cf8f-4839-b1d9-4330371e6b62","404":"bab63deb-cef2-4be7-b25b-03064a2f98a7","500":"d809f359-6ef4-4d05-8eff-ae7fd9b5a592"},"security":["e529ed61-859c-4ebb-b47a-bc357e1f29f2"],"method":"get","type":"path","servers":["d182482e-3124-4b10-8634-aa7baa7ebd43"],"path":"/drive/v1/users/{userId}/sessions/{sessionId}","baseUrlOptions":["https://{environment}.plugsurfing.com"],"title":"Get details of a specific charging session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7d19633a-2f6f-4524-a825-0decdf5419f4":{"name":"userId","in":"path","description":"The unique identifier of the user who owns the charging session","example":"6f36dc9b-446f-462b-aae0-95c7636d5c6c","required":true,"schema":{"type":"string","isRequired":true,"description":"The unique identifier of the user who owns the charging session","uniqueKey":"","typeLabel":"string"}},"a7823664-06a6-4584-9a7d-44da57420c06":{"name":"sessionId","in":"path","description":"The unique identifier of the charging session","required":true,"example":"AAdmD55q8Vz","schema":{"type":"string","isRequired":true,"description":"The unique identifier of the charging session","uniqueKey":"","typeLabel":"string"}},"ef2f657f-8a21-47e8-8512-3744b66c97b6":{"name":"includePriceSegments","in":"query","description":"When `true`, completed sessions include `priceSegments` (items use the CDR webhook cost segment object `CdrWebhookCostSegment`) and `priceSegmentsIncludeVat`. When `false` or omitted, neither field is returned. Any value other than `true` or `false`, including an empty value, returns `400`.","required":false,"schema":{"type":"boolean","default":false,"isRequired":false,"description":"When `true`, completed sessions include `priceSegments` (items use the CDR webhook cost segment object `CdrWebhookCostSegment`) and `priceSegmentsIncludeVat`. When `false` or omitted, neither field is returned. Any value other than `true` or `false`, including an empty value, returns `400`.","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"4326fcc0-a5f8-4e05-9f86-2c644fa7785c":{"description":"Session","content":{"application/json":{"schema":{"required":["sessionStatus","connectorId","sessionId","transactions"],"type":"object","properties":{"sessionStatus":{"type":"string","description":"Current lifecycle status of the session.","enum":["CREATED","WAITING_TO_START","STARTED","WAITING_TO_STOP","STOPPED","COMPLETE","FAILED","UNKNOWN","STOP_FAILED"],"isRequired":true,"uniqueKey":"sessionStatus","typeLabel":"enum\u003cstring>"},"connectorId":{"type":"string","example":"O9UXK+YI5Q6i0FoI4qHwcA==","description":"Only available after a session has successfully started.","isRequired":true,"uniqueKey":"connectorId","typeLabel":"string"},"sessionId":{"type":"string","example":"AAdmD55q8Vz","description":"Unique identifier of the charging session.","isRequired":true,"uniqueKey":"sessionId","typeLabel":"string"},"transactions":{"type":"array","items":{"type":"object","description":"Represents a transaction with payment details and time.","properties":{"paymentMethod":{"type":"string","enum":["CREDIT_CARD","EXTERNAL","PREPAID","NONE"],"description":"The payment method used for the transaction. Can be `NONE` for outcome `WRITE_OFF`","isRequired":true,"uniqueKey":"transactions.items.[INDEX].paymentMethod","typeLabel":"enum\u003cstring>"},"paymentOutcome":{"type":"string","enum":["CHARGE","WRITE_OFF","REFUND"],"description":"The outcome of the payment process.","isRequired":true,"uniqueKey":"transactions.items.[INDEX].paymentOutcome","typeLabel":"enum\u003cstring>"},"amount":{"required":["currencyCode","minorExclVat","minorInclVat","vat"],"type":"object","properties":{"currencyCode":{"type":"string","description":"3-letter currency code","example":"EUR","isRequired":true,"uniqueKey":"transactions.items.[INDEX].amount.currencyCode","typeLabel":"string"},"minorExclVat":{"type":"integer","description":"Minor units amount. Example: 2785 = 27.85€.","example":2785,"isRequired":true,"uniqueKey":"transactions.items.[INDEX].amount.minorExclVat","typeLabel":"integer"},"minorInclVat":{"type":"integer","description":"Minor units amount","isRequired":true,"uniqueKey":"transactions.items.[INDEX].amount.minorInclVat","typeLabel":"integer"},"vat":{"type":"string","description":"VAT percentage","example":"17.5","isRequired":true,"uniqueKey":"transactions.items.[INDEX].amount.vat","typeLabel":"string"}},"description":"Monetary amount with currency and VAT breakdown.","isRequired":true,"uniqueKey":"transactions.items.[INDEX].amount","typeLabel":"object"},"time":{"type":"string","format":"date-time","description":"Timestamp in ISO 8601 UTC format with up to nanosecond precision.","example":"2021-01-30T10:00:00.111111111Z","isRequired":true,"uniqueKey":"transactions.items.[INDEX].time","typeLabel":"string\u003cdate-time>"}},"required":["paymentMethod","paymentOutcome","amount","time"],"uniqueKey":"transactions.items.[INDEX]","typeLabel":"object"},"description":"Transactions linked to this charging session.","isRequired":true,"uniqueKey":"transactions","typeLabel":"object[]"},"balanceStatus":{"type":"string","enum":["PROCESSING","PAID","DEBT","REFUND"],"description":"Balance state after applying session costs.","uniqueKey":"balanceStatus","typeLabel":"enum\u003cstring>"},"charger":{"type":"object","properties":{"chargingStationName":{"type":"string","example":"Drive_API_Test1_Station1","description":"Display name of the charging station.","uniqueKey":"charger.chargingStationName","typeLabel":"string"},"city":{"type":"string","example":"Solna","description":"City where the charger is located.","uniqueKey":"charger.city","typeLabel":"string"},"connectorLabel":{"type":"string","example":"1","description":"Connector label reported by the charge point operator.","uniqueKey":"charger.connectorLabel","typeLabel":"string"},"evseId":{"type":"string","example":"SE*CND*EC1*1","description":"EVSE identifier for the charging point.","uniqueKey":"charger.evseId","typeLabel":"string"},"streetName":{"type":"string","example":"Rättarvägen","description":"Street address of the charger.","uniqueKey":"charger.streetName","typeLabel":"string"}},"description":"Charger location and connector metadata.","uniqueKey":"charger","typeLabel":"object"},"balanceAmountMinor":{"type":"number","example":-2160,"description":"Type \"Long\". This field is not relevant for External Clearing (only used when using Plugsurfing's Payment Service Provider). Represents the remaining amount to be paid, expressed as a negative number. A value of 0 indicates the balance is fully paid. -2160 means there is an outstanding amount of 21.60 in the currency of the session.","uniqueKey":"balanceAmountMinor","typeLabel":"number"},"chargingKeyType":{"type":"string","example":"virtual","description":"Only available after a session has successfully started. Possible values are \"tag\", \"card\", \"virtual\" or \"plug_and_charge\".","uniqueKey":"chargingKeyType","typeLabel":"string"},"duration":{"type":"string","format":"duration","description":"The value is in ISO 8601 duration format","example":"PT28.913S","uniqueKey":"duration","typeLabel":"string\u003cduration>"},"energy":{"required":["unit","value"],"type":"object","properties":{"unit":{"type":"string","example":"WH","description":"Energy unit, typically kWh.","isRequired":true,"uniqueKey":"energy.unit","typeLabel":"string"},"value":{"type":"number","example":57,"description":"Measured energy value for the session.","isRequired":true,"uniqueKey":"energy.value","typeLabel":"number"}},"description":"Energy consumed during the session.","uniqueKey":"energy","typeLabel":"object"},"paymentMethod":{"type":"string","enum":["CREDIT_CARD","EXTERNAL","PREPAID","WRITE_OFF"],"deprecated":true,"description":"Returns the `paymentMethod` of the transaction with the earliest timestamp. This field is `DEPRECATED` and will be removed in future versions. Use `session.transactions[].paymentMethod` instead. Migration note: `WRITE_OFF` was renamed to `NONE`, where `session.transactions[].paymentOutcome=WRITE_OFF` is the replacement","uniqueKey":"paymentMethod","typeLabel":"enum\u003cstring>"},"price":{"required":["currencyCode","minorExclVat","minorInclVat","vat"],"type":"object","properties":{"currencyCode":{"type":"string","description":"3-letter currency code","example":"EUR","isRequired":true,"uniqueKey":"price.currencyCode","typeLabel":"string"},"minorExclVat":{"type":"integer","description":"Minor units amount. Example: 2785 = 27.85€.","example":2785,"isRequired":true,"uniqueKey":"price.minorExclVat","typeLabel":"integer"},"minorInclVat":{"type":"integer","description":"Minor units amount","isRequired":true,"uniqueKey":"price.minorInclVat","typeLabel":"integer"},"vat":{"type":"string","description":"VAT percentage","example":"17.5","isRequired":true,"uniqueKey":"price.vat","typeLabel":"string"}},"description":"Total session price.","uniqueKey":"price","typeLabel":"object"},"priceSegments":{"type":"array","items":{"type":"object","required":["type","quantity","vatRate","pricePerUnit","pricePerUnitMinorUnitsInclVat","segmentCostMinorUnitsExclVat","segmentCostMinorUnitsInclVat","unit"],"properties":{"type":{"type":"string","enum":["TIME","ENERGY","FLAT","CAPPED","PARKING_TIME","CONGESTION_TIME"],"isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"quantity":{"type":"number","format":"double","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].quantity","typeLabel":"number\u003cdouble>"},"vatRate":{"type":"number","format":"double","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].vatRate","typeLabel":"number\u003cdouble>"},"pricePerUnit":{"type":"number","format":"double","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].pricePerUnit","typeLabel":"number\u003cdouble>"},"pricePerUnitMinorUnitsInclVat":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].pricePerUnitMinorUnitsInclVat","typeLabel":"integer\u003cint64>"},"segmentCostMinorUnitsExclVat":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].segmentCostMinorUnitsExclVat","typeLabel":"integer\u003cint64>"},"segmentCostMinorUnitsInclVat":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].segmentCostMinorUnitsInclVat","typeLabel":"integer\u003cint64>"},"unit":{"type":"object","required":["type","amount"],"properties":{"type":{"type":"string","enum":["session","kWh","Wh","min","h"],"isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].unit.type","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].unit.amount","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"priceSegments.items.[INDEX].unit","typeLabel":"object"},"from":{"type":"string","format":"date-time","uniqueKey":"priceSegments.items.[INDEX].from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","uniqueKey":"priceSegments.items.[INDEX].to","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"priceSegments.items.[INDEX]","typeLabel":"object"},"description":"Priced segments of the session.\n\n- Only returned when the request sets `includePriceSegments=true`, and only for completed sessions. Omitted when the session has no price breakdown; never returned as an empty array.\n- Each item has the same object and meaning as the cost segments in the CDR webhook (`costSegments`, `CdrWebhookCostSegment`). See [CDR](/docs/drive-api/cdr).\n- The currency of all amounts is `price.currencyCode`.\n- Unit mapping by `type`:\n - `TIME`, `PARKING_TIME`, `CONGESTION_TIME`: `quantity` is the number of billed steps; `unit` is `{\"type\": \"min\", \"amount\": \u003cstep size in minutes, rounded up>}` (for example a 60 s step gives `1`, 90 s gives `2`, 3600 s gives `60`); `pricePerUnitMinorUnitsInclVat` is the price per step in minor units, as rounded by the upstream pricing.\n - `ENERGY`: `quantity` is in kWh; `unit` is `{\"type\": \"kWh\", \"amount\": 1}`; the unit price is per kWh.\n - `FLAT`, `CAPPED`: `quantity` is `1`; `unit` is `{\"type\": \"session\", \"amount\": 1}`; `pricePerUnitMinorUnitsInclVat` equals `segmentCostMinorUnitsExclVat`; `from` and `to` are not returned. `CAPPED` is negative.\n- `pricePerUnit` is the upstream decimal price per unit when available; otherwise it is `pricePerUnitMinorUnitsInclVat` converted to major units using the currency's minor-unit digits (for example 2 for EUR, 0 for JPY).\n- VAT: when `priceSegmentsIncludeVat` is `false` (currently always), `pricePerUnit` and `pricePerUnitMinorUnitsInclVat` exclude VAT, despite the `InclVat` field name. This is the same convention as `CdrWebhookCost.priceIncludesVat`. `vatRate` is the session VAT percentage as a number (for example `19.0`).\n- `segmentCostMinorUnitsExclVat` and `segmentCostMinorUnitsInclVat` come directly from the upstream pricing and are authoritative. Because the unit price is rounded, `quantity` × unit price is only approximately equal to `segmentCostMinorUnitsExclVat`.\n- Segments are returned in upstream (billing) order.\n- A segment with an unknown upstream type is dropped; other segments are still returned. If no segments remain, `priceSegments` and `priceSegmentsIncludeVat` are omitted.\n- Differences from the CDR Forwarding webhook: `CONGESTION_TIME` segments are included; when there are no segments the fields are omitted (no zero-cost `FLAT` segment is added); `priceSegmentsIncludeVat` is always `false`.\n- `CAPPED` is a negative adjustment applied when a price cap is reached; it is not an OCPI dimension. `CONGESTION_TIME` is Tesla-specific (not an OCPI 2.2.1 dimension).\n- Segments are returned individually and are never aggregated.","uniqueKey":"priceSegments","typeLabel":"object[]"},"priceSegmentsIncludeVat":{"type":"boolean","description":"Whether `pricePerUnit` and `pricePerUnitMinorUnitsInclVat` in `priceSegments` include VAT. Returned only together with `priceSegments`. Mirrors `CdrWebhookCost.priceIncludesVat`. When `false`, `pricePerUnit` and `pricePerUnitMinorUnitsInclVat` exclude VAT. The Drive API currently always returns `false`.","uniqueKey":"priceSegmentsIncludeVat","typeLabel":"boolean"},"receiptAvailable":{"type":"boolean","description":"Indicates whether a receipt can be downloaded.","uniqueKey":"receiptAvailable","typeLabel":"boolean"},"site":{"type":"string","example":"Drive_API_Test1","description":"Human-readable charging site name.","uniqueKey":"site","typeLabel":"string"},"startTime":{"type":"string","format":"date-time","description":"UTC timestamp when the session started.","example":"2021-01-30T10:00:00.111111111Z","uniqueKey":"startTime","typeLabel":"string\u003cdate-time>"}},"description":"Detailed charging session information.","uniqueKey":"","typeLabel":"object"},"examples":{"created":{"title":"created","value":{"balanceStatus":"PROCESSING","sessionStatus":"CREATED","charger":{"chargingStationName":"Drive_API_Test1_Station1","city":"Solna","connectorLabel":"1","evseId":"SE*CND*EC1*1","streetName":"Rättarvägen"},"balanceAmountMinor":-2160,"chargingKeyType":"virtual","connectorId":"O9UXK+YI5Q6i0FoI4qHwcA==","duration":"PT28.913S","energy":{"unit":"WH","value":57},"paymentMethod":"CREDIT_CARD","price":{"currencyCode":"EUR","minorExclVat":2785,"minorInclVat":1,"vat":"17.5"},"receiptAvailable":true,"sessionId":"AAdmD55q8Vz","site":"Drive_API_Test1","startTime":"2021-01-30T10:00:00.111111111Z","transactions":[{"paymentMethod":"CREDIT_CARD","paymentOutcome":"CHARGE","amount":{"currencyCode":"EUR","minorExclVat":2785,"minorInclVat":1,"vat":"17.5"},"time":"2021-01-30T10:00:00.111111111Z"}]}},"complete":{"title":"complete","description":"Assumes the request was sent with `includePriceSegments=true`. Without it, `priceSegments` and `priceSegmentsIncludeVat` are not returned.","value":{"balanceStatus":"PAID","sessionStatus":"COMPLETE","charger":{"chargingStationName":"Drive_API_Test1_Station1","city":"Solna","connectorLabel":"1","evseId":"SE*CND*EC1*1","streetName":"Rättarvägen"},"balanceAmountMinor":0,"chargingKeyType":"virtual","connectorId":"O9UXK+YI5Q6i0FoI4qHwcA==","duration":"PT8H24M51S","energy":{"unit":"WH","value":10000},"paymentMethod":"CREDIT_CARD","price":{"currencyCode":"EUR","minorExclVat":724,"minorInclVat":876,"vat":"21"},"priceSegments":[{"type":"ENERGY","quantity":10,"unit":{"type":"kWh","amount":1},"vatRate":21,"pricePerUnit":0.5,"pricePerUnitMinorUnitsInclVat":50,"segmentCostMinorUnitsExclVat":500,"segmentCostMinorUnitsInclVat":605,"from":"2026-09-30T21:59:52Z","to":"2026-10-01T06:24:43Z"},{"type":"TIME","quantity":505,"unit":{"type":"min","amount":1},"vatRate":21,"pricePerUnit":0,"pricePerUnitMinorUnitsInclVat":0,"segmentCostMinorUnitsExclVat":224,"segmentCostMinorUnitsInclVat":271,"from":"2026-09-30T21:59:52Z","to":"2026-10-01T06:24:43Z"},{"type":"FLAT","quantity":1,"unit":{"type":"session","amount":1},"vatRate":21,"pricePerUnit":1,"pricePerUnitMinorUnitsInclVat":100,"segmentCostMinorUnitsExclVat":100,"segmentCostMinorUnitsInclVat":121},{"type":"CAPPED","quantity":1,"unit":{"type":"session","amount":1},"vatRate":21,"pricePerUnit":-1,"pricePerUnitMinorUnitsInclVat":-100,"segmentCostMinorUnitsExclVat":-100,"segmentCostMinorUnitsInclVat":-121}],"priceSegmentsIncludeVat":false,"receiptAvailable":true,"sessionId":"AAdmD55q8Vz","site":"Drive_API_Test1","startTime":"2026-09-30T21:59:52Z","transactions":[{"paymentMethod":"CREDIT_CARD","paymentOutcome":"CHARGE","amount":{"currencyCode":"EUR","minorExclVat":724,"minorInclVat":876,"vat":"21"},"time":"2026-09-30T21:59:52Z"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"fe63bd6b-cf8f-4839-b1d9-4330371e6b62":{"description":"The provided query parameters, route parameters or body is invalid.","content":{"application/json":{"schema":{"title":"InvalidRequestErrorResponse","type":"object","required":["message","fields"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"fields":{"type":"array","items":{"title":"InvalidField","type":"object","required":["name","message","rejectedValue"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"fields.items.[INDEX].name","typeLabel":"string"},"message":{"type":"string","example":"UserId is not correct","isRequired":true,"uniqueKey":"fields.items.[INDEX].message","typeLabel":"string"},"rejectedValue":{"type":"string","isRequired":true,"uniqueKey":"fields.items.[INDEX].rejectedValue","typeLabel":"string"}},"uniqueKey":"fields.items.[INDEX]","typeLabel":"InvalidField · object"},"isRequired":true,"uniqueKey":"fields","typeLabel":"InvalidField · object[]"}},"uniqueKey":"","typeLabel":"InvalidRequestErrorResponse · object"},"example":{"message":"Invalid request payload","details":["field X is required"]},"examples":{"Example":{"title":"Example","value":{"message":"Invalid request payload","details":["field X is required"]}}},"exampleType":"examples"}},"exampleType":"examples"},"bab63deb-cef2-4be7-b25b-03064a2f98a7":{"description":"User or session not found","content":{"application/json":{"schema":{"title":"ErrorResponse","type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"message":"Resource not found"},"examples":{"Example":{"title":"Example","value":{"message":"Resource not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"d809f359-6ef4-4d05-8eff-ae7fd9b5a592":{"description":"Internal Server Error","content":{"application/json":{"schema":{"title":"ErrorResponse","type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"message":"Resource not found"},"examples":{"Example":{"title":"Example","value":{"message":"Resource not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e529ed61-859c-4ebb-b47a-bc357e1f29f2":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"d182482e-3124-4b10-8634-aa7baa7ebd43":{"url":"https://{environment}.plugsurfing.com","variables":{"environment":{"enum":["drive-api-stage"],"default":"drive-api-stage","description":"API environment - use drive-api-stage for testing and drive-api for production"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"reference/openapi.json"},"subdomain":"plugsurfing","siteName":"Plugsurfing Developer","title":"Get details of a specific charging session - Plugsurfing Developer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-29T12:11:21.031Z","originalFileLocation":"reference/getSessionById.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Plugsurfing Developer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_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/plugsurfing/8f0OJHg-03LG87aL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get details of a specific charging session - Plugsurfing Developer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Plugsurfing Developer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.plugsurfing.com/reference/getSessionById\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://plugsurfing.mintlify.site/_mintlify/api/og/v2?division=Charging\u0026amp;title=Get+details+of+a+specific+charging+session\u0026amp;description=Retrieves+detailed+information+about+a+specific+charging+session.+This+includes%3A+-+Session+status+%28completed+or+in-progress%29+-+Energy+consumption+and+duration+-\u0026amp;theme=ead381321109242992897df9\u0026amp;signature=f8018b871bd99fb5d44148d71c4a019f52772f56defc1668039582f2422b39e1\">\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 details of a specific charging session - Plugsurfing Developer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plugsurfing.mintlify.site/_mintlify/api/og/v2?division=Charging\u0026amp;title=Get+details+of+a+specific+charging+session\u0026amp;description=Retrieves+detailed+information+about+a+specific+charging+session.+This+includes%3A+-+Session+status+%28completed+or+in-progress%29+-+Energy+consumption+and+duration+-\u0026amp;theme=ead381321109242992897df9\u0026amp;signature=f8018b871bd99fb5d44148d71c4a019f52772f56defc1668039582f2422b39e1\">\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/plugsurfing/8f0OJHg-03LG87aL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Plugsurfing Developer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5D52DF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.plugsurfing.com/reference/getSessionById\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/getSessionById.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.plugsurfing.com/#organization\",\"name\":\"Plugsurfing Developer\",\"url\":\"https://developer.plugsurfing.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/plugsurfing/ay5jxu8M27_-_9fk/images/onwhite.svg?fit=max\u0026auto=format\u0026n=ay5jxu8M27_-_9fk\u0026q=85\u0026s=7ec646a54bf62ff532848b6bddd19e22\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.plugsurfing.com#website\",\"name\":\"Plugsurfing Developer\",\"url\":\"https://developer.plugsurfing.com\",\"publisher\":{\"@id\":\"https://developer.plugsurfing.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.plugsurfing.com/reference/getSessionById#webpage\",\"url\":\"https://developer.plugsurfing.com/reference/getSessionById\",\"name\":\"Get details of a specific charging session\",\"description\":\"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\",\"dateModified\":\"2026-07-29T12:11:21.031Z\",\"isPartOf\":{\"@id\":\"https://developer.plugsurfing.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.plugsurfing.com/reference/getSessionById#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.plugsurfing.com/reference/getSessionById#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Charging\",\"item\":\"https://developer.plugsurfing.com/reference/listSessions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get details of a specific charging session\",\"item\":\"https://developer.plugsurfing.com/reference/getSessionById\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.plugsurfing.com/reference/getSessionById#apireference\",\"headline\":\"Get details of a specific charging session\",\"name\":\"Get details of a specific charging session\",\"description\":\"Retrieves detailed information about a specific charging session. This includes: - Session status (completed or in-progress) - Energy consumption and duration - Cost and payment status - Charging location details - Charging key used This endpoint can be used to track both completed sessions and monitor ongoing ones.\",\"url\":\"https://developer.plugsurfing.com/reference/getSessionById\",\"mainEntityOfPage\":{\"@id\":\"https://developer.plugsurfing.com/reference/getSessionById#webpage\"},\"dateModified\":\"2026-07-29T12:11:21.031Z\",\"publisher\":{\"@id\":\"https://developer.plugsurfing.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.plugsurfing.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Plugsurfing Developer\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Plugsurfing Developer","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/home"}]},{"tab":"Drive API","groups":[{"group":"Guides","icon":"book-open","pages":[{"title":"About Drive API","href":"/docs/drive-api/about-drive-api"},{"group":"Getting started","pages":[{"title":"Getting started","href":"/docs/drive-api/getting-started-with-drive-api"},{"title":"AI Integration Playbook","deprecated":false,"href":"/docs/drive-api/ai-integration-playbook"},{"title":"API key access \u0026 security","href":"/docs/drive-api/authorization"},{"title":"EMP mode","deprecated":false,"hidden":false,"href":"/docs/drive-api/emp"},{"title":"MCP for AI agents","href":"/docs/drive-api/mcp-for-ai-agents"},{"title":"Verifying HMAC signature","href":"/docs/drive-api/verifying-hmac-signature"},{"title":"Webhooks","deprecated":false,"href":"/docs/drive-api/webhooks"},{"title":"Drive API control panel","href":"/docs/drive-api/drive-api-control-panel"}]},{"group":"Network","pages":[{"title":"Geosearch","href":"/docs/drive-api/geosearch"},{"title":"Integrating geosearch with client maps","deprecated":false,"href":"/docs/drive-api/geosearch-map-integration"},{"title":"Tesla specific requirements","href":"/docs/drive-api/tesla-specific"},{"title":"Mirroring the Plugsurfing network in your system","href":"/untitled-page-2"}]},{"group":"Users","pages":[{"title":"Users","deprecated":false,"href":"/docs/drive-api/user"},{"title":"User groups","href":"/docs/drive-api/user-groups"}]},{"group":"Charging keys","pages":[{"title":"Charging Keys","deprecated":false,"hidden":false,"href":"/docs/drive-api/charging-keys"},{"title":"Plug\u0026Charge","deprecated":false,"hidden":false,"href":"/docs/drive-api/plug-and-charge"}]},{"group":"Payments","pages":[{"title":"Payment integration options","deprecated":false,"href":"/docs/drive-api/payment-integrations"},{"title":"Payments with Plugsurfing's PSP","deprecated":false,"href":"/docs/drive-api/payments"},{"title":"Vouchers","deprecated":false,"href":"/docs/drive-api/vouchers"}]},{"group":"Charging","pages":[{"title":"Sessions","deprecated":false,"hidden":false,"href":"/docs/drive-api/sessions"},{"title":"Session pre-authorization","deprecated":false,"href":"/docs/drive-api/session-pre-authorization"},{"title":"Events","deprecated":false,"href":"/docs/drive-api/events"},{"title":"CDR forwarding","href":"/docs/drive-api/cdr"}]},{"group":"Fleets","pages":[{"title":"Fleet Card Orders","deprecated":false,"hidden":false,"href":"/docs/drive-api/fleet-card-orders"},{"title":"Fleet Management","deprecated":false,"href":"/docs/drive-api/fleet-management"}]}]},{"group":"API reference","icon":"square-terminal","pages":[{"group":"Network","pages":[{"group":"Geosearch","expanded":false,"pages":[{"title":"Rectangle search","openapi":"reference/openapi.json POST /drive/v1/geosearch/rectangle","href":"/reference/searchLocationsByRectangle"},{"title":"Radius search","openapi":"reference/openapi.json POST /drive/v1/geosearch/radius","href":"/reference/searchLocationsByRadius"},{"title":"Route search","openapi":"reference/openapi.json POST /drive/v1/geosearch/route","href":"/reference/searchLocationsByRoute"},{"title":"Get location by id","openapi":"reference/openapi.json GET /drive/v1/locations/{locationId}","href":"/reference/getLocationById"},{"title":"Get location live data","openapi":"reference/openapi.json GET /drive/v1/locations/{locationId}/live-data","href":"/reference/getLocationLiveData"},{"title":"Batch locations","openapi":"reference/openapi.json GET /drive/v1/locations/batch","href":"/reference/getLocationsBatch"},{"title":"Get list of operators","openapi":"reference/openapi.json GET /drive/v1/locations/operators","href":"/reference/listOperators"}]}]},{"group":"Users","expanded":false,"pages":[{"title":"Create user","openapi":"reference/openapi.json POST /drive/v1/users","href":"/reference/createUser"},{"title":"Read user details","openapi":"reference/openapi.json GET /drive/v1/users/{userId}","href":"/reference/getUser"},{"title":"Update user details","openapi":"reference/openapi.json PATCH /drive/v1/users/{userId}","href":"/reference/updateUser"},{"title":"Remove user","openapi":"reference/openapi.json DELETE /drive/v1/users/{userId}","href":"/reference/deleteUser"},{"group":"User Groups","expanded":false,"pages":[{"title":"Add user to user group","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/user-groups/{groupId}","href":"/reference/createUserGroupMembership"},{"title":"Remove user from user group","openapi":"reference/openapi.json DELETE /drive/v1/users/{userId}/user-groups/{groupId}","href":"/reference/deleteUserGroupMembership"}]}]},{"group":"Charging keys","expanded":false,"pages":[{"title":"Activate a charging key","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/charging-keys/{referenceId}/activate","href":"/reference/activateUserChargingKey"},{"title":"Edit a charging key","openapi":"reference/openapi.json PATCH /drive/v1/users/{userId}/charging-keys/{identifier}","href":"/reference/updateUserChargingKey"},{"title":"Get user's charging keys","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/charging-keys","href":"/reference/listUserChargingKeys"},{"title":"Create a charging key","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/charging-keys","href":"/reference/createUserChargingKey"},{"title":"Create a Plug\u0026Charge key","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/charging-keys/plug-and-charge","href":"/reference/createPncChargingKey"},{"title":"Reserve a charging key","openapi":"reference/openapi.json POST /drive/v1/charging-keys/reservations","href":"/reference/createChargingKeyReservation"},{"group":"Charging Key Orders","expanded":false,"pages":[{"title":"Create charging key order","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/charging-keys/orders","href":"/reference/createChargingKeyOrder"},{"title":"Get list of charging key orders","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/charging-keys/orders","href":"/reference/listChargingKeyOrders"},{"title":"Get order receipt URL","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/charging-keys/orders/{orderId}/receipt","href":"/reference/getChargingKeyOrderReceiptUrl"},{"title":"Get pricing information per country","openapi":"reference/openapi.json GET /drive/v1/charging-keys/orders/configuration","href":"/reference/getChargingKeyOrderConfiguration"}]}]},{"group":"Payments","pages":[{"group":"Payment Options","expanded":false,"pages":[{"title":"Get user's payment methods","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/payment-options","href":"/reference/listPaymentOptions"},{"title":"Add a new payment method","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/payment-options","href":"/reference/createPaymentOption"},{"title":"Get Stripe SetupIntent to confirm a payment method","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/payment-options/stripe-setup-intent","href":"/reference/createStripeSetupIntent"},{"title":"Delete user's payment option","openapi":"reference/openapi.json DELETE /drive/v1/users/{userId}/payment-options/{id}","href":"/reference/deletePaymentOption"},{"title":"Get user's prepaid balance","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/prepaid","href":"/reference/listPrepaid"},{"title":"Get Stripe publishable API key","openapi":"reference/openapi.json GET /emp/v1/payment-options/stripe/publishable-api-key","href":"/reference/getStripePublishableApiKey"}]},{"group":"Vouchers","expanded":false,"pages":[{"title":"Redeem a voucher code","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/vouchers/{code}/redeem","href":"/reference/redeem"}]}]},{"group":"Charging","expanded":false,"pages":[{"title":"Get charging session history","description":"Retrieves the charging session history for a specific user. The response includes detailed information about each session including: - Session status and duration - Energy consumption - Cost and payment details - Charging location information The results can be filtered by: - Session status - Specific charging key - Date range Pagination is supported through the cursor parameter.","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/sessions/history","href":"/reference/listSessions"},{"title":"Get details of a specific charging session","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/sessions/{sessionId}","href":"/reference/getSessionById"},{"title":"Get a session receipt by session id","description":"Get session receipt. The response includes a time-limited URL to access the receipt. A new URL is required after expiration. Receipts are not available for sessions with a price of 0, and a 404 error will be returned if requested. The receipt will be in PDF format.","openapi":"reference/openapi.json GET /drive/v1/users/{userId}/sessions/{sessionId}/receipt","href":"/reference/getSessionReceipt"},{"title":"Retry session payment","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/sessions/{sessionId}/payments/retry","href":"/reference/retrySessionPayment"},{"group":"Remote Charging","expanded":false,"pages":[{"title":"Start a remote charging session","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/sessions/start","href":"/reference/startRemoteSession"},{"title":"Stop a remote charging session","openapi":"reference/openapi.json POST /drive/v1/users/{userId}/sessions/{sessionId}/stop","href":"/reference/stopRemoteSession"}]},{"group":"Session Events","expanded":false,"pages":[{"title":"Receive Session Event","openapi":"reference/openapi.json webhook sessionEventsWebhook","href":"/reference/sessionEventsWebhook"}]},{"group":"CDR Forwarding","expanded":false,"pages":[{"title":"Receive Forwarded CDR","openapi":"reference/openapi.json webhook cdrForwardingWebhook","href":"/reference/cdrForwardingWebhook"}]}]},{"group":"EMP mode","pages":[{"group":"EMP Geosearch","expanded":false,"pages":[{"title":"Search locations around a point","openapi":"reference/openapi.json POST /emp/v1/geosearch/radius","href":"/reference/searchEmpLocationsByRadius"},{"title":"Search locations within a rectangle","openapi":"reference/openapi.json POST /emp/v1/geosearch/rectangle","href":"/reference/searchEmpLocationsByRectangle"},{"title":"Search for locations along a route","openapi":"reference/openapi.json POST /emp/v1/geosearch/route","href":"/reference/searchEmpLocationsByRoute"},{"title":"Get location by id","openapi":"reference/openapi.json GET /emp/v1/locations/{locationId}","href":"/reference/getEmpLocationById"},{"title":"Get location live data","openapi":"reference/openapi.json GET /emp/v1/locations/{locationId}/live-data","href":"/reference/getEmpLocationLiveData"},{"title":"Get batch of locations","openapi":"reference/openapi.json GET /emp/v1/locations/batch","href":"/reference/getEmpLocationsBatch"}]},{"group":"EMP Orders","expanded":false,"pages":[{"title":"List available products","openapi":"reference/openapi.json GET /emp/v1/products","href":"/reference/getEmpProducts"},{"title":"Create a fleet charging key order","openapi":"reference/openapi.json POST /emp/v1/orders","href":"/reference/createEmpChargingKeyOrder"},{"title":"Fetch charging key orders","openapi":"reference/openapi.json GET /emp/v1/orders","href":"/reference/listEmpChargingKeyOrders"},{"title":"Fetch a charging key order","openapi":"reference/openapi.json GET /emp/v1/orders/{orderId}","href":"/reference/getEmpChargingKeyOrder"},{"title":"Mark an order as 'Assigned'","openapi":"reference/openapi.json POST /emp/v1/orders/{orderId}/assign","href":"/reference/assignEmpChargingKeyOrder"}]},{"group":"EMP Fleets","expanded":false,"pages":[{"title":"Create a fleet","openapi":"reference/openapi.json POST /emp/v1/fleets","href":"/reference/createFleet"},{"title":"Rename a fleet","openapi":"reference/openapi.json PUT /emp/v1/fleets/{fleetId}/rename","href":"/reference/renameFleet"},{"title":"Get fleet invitation codes","openapi":"reference/openapi.json GET /emp/v1/fleets/{fleetId}/invitation","href":"/reference/getFleetInvitationCodes"}]},{"group":"EMP Charging Keys","expanded":false,"pages":[{"title":"Get charging keys","openapi":"reference/openapi.json GET /emp/v1/charging-keys","href":"/reference/listEmpChargingKeys"},{"title":"Create a charging key","openapi":"reference/openapi.json POST /emp/v1/charging-keys","href":"/reference/createEmpChargingKey"},{"title":"Rename a charging key","openapi":"reference/openapi.json PUT /emp/v1/charging-keys/{keyIdentifier}/rename","href":"/reference/renameEmpChargingKey"},{"title":"Enable charging key","openapi":"reference/openapi.json PUT /emp/v1/charging-keys/{keyIdentifier}/enable","href":"/reference/enableEmpChargingKey"},{"title":"Disable charging key","openapi":"reference/openapi.json PUT /emp/v1/charging-keys/{keyIdentifier}/disable","href":"/reference/disableEmpChargingKey"},{"title":"Transfer a charging key","openapi":"reference/openapi.json PUT /emp/v1/charging-keys/{keyIdentifier}/transfer","href":"/reference/transferEmpChargingKey"}]},{"group":"EMP Sessions","expanded":false,"pages":[{"title":"Start a remote session","openapi":"reference/openapi.json POST /emp/v1/sessions/start","href":"/reference/startRemoteSessionEmp"},{"title":"Stop a remote session","openapi":"reference/openapi.json POST /emp/v1/sessions/{sessionId}/stop","href":"/reference/stopRemoteSessionEmp"},{"title":"Get a session receipt by session id","openapi":"reference/openapi.json GET /emp/v1/sessions/{sessionId}/receipt","href":"/reference/getSessionReceiptEmp"},{"title":"Get session by id","openapi":"reference/openapi.json GET /emp/v1/sessions/{sessionId}","href":"/reference/getSessionByIdEmp"}]}]}]}]},{"tab":"Roam OCPI","pages":[{"title":"Roam OCPI","href":"/docs/roam-ocpi/about-roam-ocpi"}]}]},"basePath":"","title":"Get details of a specific charging session - Plugsurfing Developer","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}