{
"message": "Invalid request payload",
"details": [
"field X is required"
]
}
{
"message": "Resource not found"
}
Geosearch
Rectangle search
Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id
Controls the size of aggregation grid cells. Values range from 2 (largest cells) to 9 (smallest cells). Higher precision means smaller clusters but more data. If not specified, an appropriate value based on the search radius is used.
Present only if 'aggregate' request param = true. Contains only aggregates of 2 or more locations. Single locations are returned in 'locations' array.
Show child attributes
{"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/searchLocationsByRectangle","slug":"/reference/searchLocationsByRectangle","pageMetadata":{"title":"Rectangle search","description":"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the `topLatitude`, `bottomLatitude`, `leftLongitude`, and `rightLongitude` query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id","openapi":"reference/openapi.json POST /drive/v1/geosearch/rectangle","href":"/reference/searchLocationsByRectangle"},"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: [\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the \", _jsx(_components.code, {\n children: \"topLatitude\"\n }), \", \", _jsx(_components.code, {\n children: \"bottomLatitude\"\n }), \", \", _jsx(_components.code, {\n children: \"leftLongitude\"\n }), \", and \", _jsx(_components.code, {\n children: \"rightLongitude\"\n }), \" query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\"]\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":"Rectangle search","description":"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the `topLatitude`, `bottomLatitude`, `leftLongitude`, and `rightLongitude` query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id","openapi":"reference/openapi.json POST /drive/v1/geosearch/rectangle","href":"/reference/searchLocationsByRectangle"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Rectangle search","description":"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the `topLatitude`, `bottomLatitude`, `leftLongitude`, and `rightLongitude` query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id","operationId":"searchLocationsByRectangle","tags":["Geosearch"],"requestBody":"1d3c2475-ca02-4f03-b4bd-a57105d58613","parameters":["5808223b-3cd1-493f-9658-ec46431ab212","0779444e-37f2-4f34-a082-678f143bd6a0","fa6868cf-8e77-4273-b430-c594b58e0265","58b8a106-83ab-4cc7-8ebe-4c30843ab0e2","0ac0d5d7-34f2-476e-a15e-103e06938311","53d8b77e-200c-45b2-b8c4-1027d523ac7f","cce0efba-b594-48fa-86ed-adf67a08e4d3","665e41b6-218a-4f33-8880-c8239be47fc9"],"responses":{"200":"8461a151-0f3e-4f87-bb24-512901949dea","400":"7929d716-2678-4e2a-a33f-45a198e136aa","500":"eee58f4c-51a1-4173-9bdc-086a593962a7"},"security":["13245e77-342a-4d12-bb6d-2ca8a71030d8"],"method":"post","type":"path","servers":["d182482e-3124-4b10-8634-aa7baa7ebd43"],"path":"/drive/v1/geosearch/rectangle","baseUrlOptions":["https://{environment}.plugsurfing.com"],"title":"Rectangle search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5808223b-3cd1-493f-9658-ec46431ab212":{"name":"topLatitude","in":"query","required":true,"description":"Latitude of the top edge of the rectangle in decimal degrees (e.g. N58°30' is represented as 58.5). Must be greater than bottomLatitude.","example":52.354551,"schema":{"type":"number","format":"double","minimum":-90,"maximum":90,"isRequired":true,"description":"Latitude of the top edge of the rectangle in decimal degrees (e.g. N58°30' is represented as 58.5). Must be greater than bottomLatitude.","uniqueKey":"","typeLabel":"number\u003cdouble>"}},"0779444e-37f2-4f34-a082-678f143bd6a0":{"name":"bottomLatitude","in":"query","required":true,"description":"Latitude of the bottom edge of the rectangle in decimal degrees (e.g. S58°30' is represented as -58.5)","example":52.354551,"schema":{"type":"number","format":"double","minimum":-90,"maximum":90,"isRequired":true,"description":"Latitude of the bottom edge of the rectangle in decimal degrees (e.g. S58°30' is represented as -58.5)","uniqueKey":"","typeLabel":"number\u003cdouble>"}},"fa6868cf-8e77-4273-b430-c594b58e0265":{"name":"leftLongitude","in":"query","required":true,"description":"Longitude of the left edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75). Must be less than rightLongitude.","example":4.7391593,"schema":{"type":"number","format":"double","minimum":-180,"maximum":180,"isRequired":true,"description":"Longitude of the left edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75). Must be less than rightLongitude.","uniqueKey":"","typeLabel":"number\u003cdouble>"}},"58b8a106-83ab-4cc7-8ebe-4c30843ab0e2":{"name":"rightLongitude","in":"query","required":true,"description":"Longitude of the right edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75)","example":4.7391593,"schema":{"type":"number","format":"double","minimum":-180,"maximum":180,"isRequired":true,"description":"Longitude of the right edge of the rectangle in decimal degrees (e.g. E014°45' is represented as 14.75)","uniqueKey":"","typeLabel":"number\u003cdouble>"}},"0ac0d5d7-34f2-476e-a15e-103e06938311":{"name":"limit","in":"query","description":"Maximum number of individual locations to return. Not applicable when aggregation is enabled. Use a lower limit for faster response times.","required":false,"schema":{"type":"integer","maximum":300,"default":300,"isRequired":false,"description":"Maximum number of individual locations to return. Not applicable when aggregation is enabled. Use a lower limit for faster response times.","uniqueKey":"","typeLabel":"integer"}},"53d8b77e-200c-45b2-b8c4-1027d523ac7f":{"name":"aggregate","in":"query","description":"Enable result aggregation. Recommended for large search radii to improve response time.","required":false,"schema":{"type":"boolean","default":false,"isRequired":false,"description":"Enable result aggregation. Recommended for large search radii to improve response time.","uniqueKey":"","typeLabel":"boolean"}},"cce0efba-b594-48fa-86ed-adf67a08e4d3":{"name":"aggregationPrecision","in":"query","description":"Controls the size of aggregation grid cells. Values range from 2 (largest cells) to 9 (smallest cells). Higher precision means smaller clusters but more data. If not specified, an appropriate value based on the search radius is used.","required":false,"schema":{"type":"integer","minimum":2,"maximum":9,"isRequired":false,"description":"Controls the size of aggregation grid cells. Values range from 2 (largest cells) to 9 (smallest cells). Higher precision means smaller clusters but more data. If not specified, an appropriate value based on the search radius is used.","uniqueKey":"","typeLabel":"integer"}},"665e41b6-218a-4f33-8880-c8239be47fc9":{"name":"language","schema":{"type":"string","minLength":2,"maxLength":2,"isRequired":false,"description":"Supported languages: en, bg, cy, de, es, fi, fr, hu, is, it, lt, nb, nl, pl, pt, ro, sv.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false,"example":"en","description":"Supported languages: en, bg, cy, de, es, fi, fr, hu, is, it, lt, nb, nl, pl, pt, ro, sv."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","example":{"filters":{"locationStatuses":["AVAILABLE","CHARGING","OCCUPIED","RESERVED","UNKNOWN","OUTOFORDER"],"powerType":"AC"}},"properties":{"filters":{"type":"object","properties":{"connectorStandards":{"type":"array","items":{"type":"string","description":"Connector standard accepted by the API. Use `Combo` for CCS connectors. `CHADEMO` is the preferred token; `Chademo` is a legacy alias.","enum":["3PinSquare","Cee2Poles","CeeBlue","CeePlus","CeeRed","Combo","Marechal","Nema5","Scame","CHADEMO","Chademo","Type1","Type2","Type3","TypeE","Schuko","UNKNOWN","T23","T13","T15","Tesla","DOMESTIC_A","DOMESTIC_B","DOMESTIC_C","DOMESTIC_D","DOMESTIC_E","DOMESTIC_F","DOMESTIC_G","DOMESTIC_H","DOMESTIC_I","DOMESTIC_J","DOMESTIC_K","DOMESTIC_L","IEC_60309_2_single_16","IEC_60309_2_three_16","IEC_60309_2_three_32","IEC_60309_2_three_64","IEC_62196_T1","IEC_62196_T1_COMBO","IEC_62196_T2","IEC_62196_T2_COMBO","IEC_62196_T3A","IEC_62196_T3C","TESLA_R","TESLA_S"],"example":"Type2","uniqueKey":"filters.connectorStandards.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Accepted connector standards.","uniqueKey":"filters.connectorStandards","typeLabel":"enum\u003cstring>[]"},"locationStatuses":{"type":"array","example":["AVAILABLE","CHARGING","OCCUPIED","RESERVED","UNKNOWN","OUTOFORDER"],"items":{"type":"string","enum":["AVAILABLE","CHARGING","BLOCKED","INOPERATIVE","OCCUPIED","OFFLINE","OUTOFORDER","PLANNED","REMOVED","RESERVED","UNKNOWN","UNAVAILABLE"],"example":"AVAILABLE","uniqueKey":"filters.locationStatuses.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Only return locations whose status is included in this list. A common default is `[AVAILABLE, CHARGING, OCCUPIED, RESERVED, UNKNOWN, OUTOFORDER]`, which excludes statuses such as `BLOCKED`, `INOPERATIVE`, `OFFLINE`, and `REMOVED`.","uniqueKey":"filters.locationStatuses","typeLabel":"enum\u003cstring>[]"},"capabilities":{"type":"array","items":{"type":"string","enum":["REMOTE_START_STOP_CAPABLE","PLUG_AND_CHARGE_CAPABLE"],"uniqueKey":"filters.capabilities.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Required EVSE capabilities.","uniqueKey":"filters.capabilities","typeLabel":"enum\u003cstring>[]"},"power":{"type":"integer","example":30000,"description":"Minimum power in W","uniqueKey":"filters.power","typeLabel":"integer"},"powerType":{"type":"string","enum":["AC","DC"],"description":"AC filter will contain both AC 1-phase and 3-phase.","uniqueKey":"filters.powerType","typeLabel":"enum\u003cstring>"},"operatorIds":{"type":"array","items":{"type":"integer","uniqueKey":"filters.operatorIds.items.[INDEX]","typeLabel":"integer"},"description":"Get stations only from these operators. (When provided, excludedOperatorIds will be ignored.)","uniqueKey":"filters.operatorIds","typeLabel":"integer[]"},"excludedOperatorIds":{"type":"array","items":{"type":"integer","uniqueKey":"filters.excludedOperatorIds.items.[INDEX]","typeLabel":"integer"},"description":"Exclude stations from these operators. (This parameter will be ignored when operatorIds are provided.)","uniqueKey":"filters.excludedOperatorIds","typeLabel":"integer[]"},"open247":{"type":"boolean","description":"Return only stations open 24/7.","uniqueKey":"filters.open247","typeLabel":"boolean"},"openNow":{"type":"boolean","description":"Returns only stations now opened (based on data provided by CPOs). This parameter is not supported with aggregations.","uniqueKey":"filters.openNow","typeLabel":"boolean"},"evseIds":{"type":"array","items":{"type":"string","uniqueKey":"filters.evseIds.items.[INDEX]","typeLabel":"string"},"example":["+49*839","*075*000075"],"description":"Return only stations with evses id match a pattern","uniqueKey":"filters.evseIds","typeLabel":"string[]"},"countries":{"type":"array","items":{"type":"string","example":["NOR","SWE","DEU"],"uniqueKey":"filters.countries.items.[INDEX]","typeLabel":"string"},"description":"Array of 3-letter country codes","uniqueKey":"filters.countries","typeLabel":"string[]"}},"description":"Filtering criteria for location selection.","uniqueKey":"filters","typeLabel":"object"}},"description":"Geosearch request constrained to a rectangular area.","uniqueKey":"","typeLabel":"object"},"examples":{"chargingProfileFilter":{"title":"chargingProfileFilter","value":{"filters":{"connectorStandards":["Combo"],"capabilities":["CHARGING_PROFILE_CAPABLE"]}}},"plugAndChargeFilter":{"title":"plugAndChargeFilter","value":{"filters":{"connectorStandards":["Combo"],"capabilities":["PLUG_AND_CHARGE_CAPABLE"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"8461a151-0f3e-4f87-bb24-512901949dea":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["locations"],"properties":{"locations":{"type":"array","items":{"required":["id","name","coordinates","address","evses","country","city","last_updated"],"type":"object","properties":{"id":{"minLength":0,"type":"string","example":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0gQhJv/Yjp5FXBJt14SccU9zFRdnC4SV7juPdCRaWkEZo=","isRequired":true,"uniqueKey":"locations.items.[INDEX].id","typeLabel":"string"},"name":{"maxLength":255,"minLength":0,"type":"string","description":"Human-readable name of the charging location","example":"Ebee Smart Technologies","isRequired":true,"uniqueKey":"locations.items.[INDEX].name","typeLabel":"string"},"coordinates":{"type":"object","description":"Geographic coordinates of the charging location. These values are returned as strings.","properties":{"latitude":{"pattern":"-?[0-9]{1,2}\\.[0-9]{6}","type":"string","description":"Latitude serialized as a string, for example `52.475911`.","example":"52.475911","uniqueKey":"locations.items.[INDEX].coordinates.latitude","typeLabel":"string"},"longitude":{"pattern":"-?[0-9]{1,3}\\.[0-9]{6}","type":"string","description":"Longitude serialized as a string, for example `13.350794`.","example":"13.350794","uniqueKey":"locations.items.[INDEX].coordinates.longitude","typeLabel":"string"}},"isRequired":true,"uniqueKey":"locations.items.[INDEX].coordinates","typeLabel":"object"},"evses":{"type":"array","description":"List of Electric Vehicle Supply Equipment (EVSE) at this location. Each EVSE may have multiple connectors.","items":{"required":["uid","status","connectors","capabilities","last_updated"],"type":"object","description":"Electric Vehicle Supply Equipment (EVSE) represents a charging station unit that may have multiple connectors. Only one connector can be active at a time.","properties":{"uid":{"minLength":0,"type":"string","example":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0g3wFt7gLfnV3ulxmnoAzR4W/DFEMs63CndZpPK6L2aJG9qMC0Dp9OqeegGRXmiTOE","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].uid","typeLabel":"string"},"status":{"type":"string","enum":["AVAILABLE","CHARGING","BLOCKED","INOPERATIVE","OCCUPIED","OFFLINE","OUTOFORDER","PLANNED","REMOVED","RESERVED","UNKNOWN","UNAVAILABLE"],"example":"AVAILABLE","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"connectors":{"type":"array","items":{"required":["id","standard","power_type"],"type":"object","properties":{"id":{"minLength":0,"type":"string","description":"Unique identifier for this connector. Use this ID when starting charging sessions.","example":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0g3wFt7gLfnV3ulxmnoAzR4W/DFEMs63CndZpPK6L2aJEM0D69tJVN05/1hZ1zxqZSJ9kBdNsmfryS0+gvjLNZvdF1pDHJuCTydsJX6vPZh7U=","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].id","typeLabel":"string"},"standard":{"type":"string","description":"Physical connector type/standard (e.g., Type2, Combo, CHADEMO). Use `Combo` for CCS connectors.","enum":["3PinSquare","Cee2Poles","CeeBlue","CeePlus","CeeRed","Combo","Marechal","Nema5","Scame","CHADEMO","Chademo","Type1","Type2","Type3","TypeE","Schuko","UNKNOWN","T23","T13","T15","Tesla","DOMESTIC_A","DOMESTIC_B","DOMESTIC_C","DOMESTIC_D","DOMESTIC_E","DOMESTIC_F","DOMESTIC_G","DOMESTIC_H","DOMESTIC_I","DOMESTIC_J","DOMESTIC_K","DOMESTIC_L","IEC_60309_2_single_16","IEC_60309_2_three_16","IEC_60309_2_three_32","IEC_60309_2_three_64","IEC_62196_T1","IEC_62196_T1_COMBO","IEC_62196_T2","IEC_62196_T2_COMBO","IEC_62196_T3A","IEC_62196_T3C","TESLA_R","TESLA_S"],"example":"Type2","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].standard","typeLabel":"enum\u003cstring>"},"power_type":{"type":"string","enum":["AC_1_PHASE","AC_3_PHASE","DC","AC"],"example":"AC_3_PHASE","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].power_type","typeLabel":"enum\u003cstring>"},"power":{"type":"integer","description":"Maximum power output in Watts. For AC chargers, this is typically between 3.7kW and 43kW. For DC chargers, typically between 50kW and 350kW.","example":22000,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].power","typeLabel":"integer"},"price":{"description":"Pricing information for this connector. Only available when retrieving a specific location.","type":"object","properties":{"id":{"type":"string","example":"4370769f30bd7927","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.id","typeLabel":"string"},"description":{"type":"string","example":"€ 0.56/kWh, € 0.10/min (> 2 h)","description":"Human-readable description of the pricing structure","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.description","typeLabel":"string"},"currency":{"type":"string","description":"Three-letter currency code ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format)","example":"EUR","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.currency","typeLabel":"string"},"priceIncludesVat":{"type":"boolean","description":"Indicates whether the price includes VAT or not (same meaning as for the CDR object)","example":"true","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.priceIncludesVat","typeLabel":"boolean"},"vatRate":{"type":"string","description":"The VAT rate that is applied to the price (in case priceIncludesVat=true) or the VAT rate that should be applied to the price (in case priceIncludesVat=false)","example":"22","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.vatRate","typeLabel":"string"},"elements":{"type":"array","description":"Possible prices for that connector, depending on restrictions","items":{"type":"object","required":["price_components"],"description":"Defines a complete pricing structure that may apply under certain conditions. Multiple price elements may exist for different times or usage patterns.","properties":{"price_components":{"type":"array","description":"List of individual price components that make up this pricing structure","items":{"type":"object","description":"Defines a single component of a charging price. A price can have multiple components (e.g., energy cost + time cost).","properties":{"price":{"type":"number","example":0,"description":"Cost in the currency stated above. VAT is included. Decimal number. For example, if currency is EUR and price is 1.10, the cost is €1.10. More information can be found in https://developer.plugsurfing.com/docs/geosearch#explanation","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].price_components.items.[INDEX].price","typeLabel":"number"},"type":{"type":"string","example":"FLAT","description":"More information can be found in https://developer.plugsurfing.com/docs/geosearch#explanation","enum":["TIME","ENERGY","FLAT","CAPPED","PARKING_TIME","CONGESTION_TIME"],"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].price_components.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"step_size":{"type":"number","example":1,"description":"The smallest unit of usage that will be billed. Unit: seconds for `TIME`, `PARKING_TIME`, and `CONGESTION_TIME`; watt-hours (Wh) for `ENERGY`; ignored for `FLAT` and `CAPPED`. More information can be found in https://developer.plugsurfing.com/docs/geosearch#explanation","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].price_components.items.[INDEX].step_size","typeLabel":"number"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].price_components.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].price_components","typeLabel":"object[]"},"restrictions":{"type":"object","description":"Conditions under which this price element applies. Multiple restrictions can be combined.","properties":{"start_time":{"type":"string","example":"08:30","description":"Time of day when this price starts applying (local time at the charging location)","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.start_time","typeLabel":"string"},"end_time":{"type":"string","example":"22:30","description":"Time of day when this price stops applying (local time at the charging location)","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.end_time","typeLabel":"string"},"day_of_week":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"],"description":"Days of the week when this price applies","example":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY"],"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.day_of_week","typeLabel":"enum\u003cstring>"},"min_duration":{"type":"number","example":7200,"description":"Minimum charging duration in seconds before this price applies (e.g., 7200 means this price applies after 2 hours)","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.min_duration","typeLabel":"number"},"max_duration":{"type":"number","example":10000,"description":"Maximum charging duration in seconds for this price to apply","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.max_duration","typeLabel":"number"},"min_kwh":{"type":"number","example":2,"description":"Minimum energy consumption in kWh before this price applies","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.min_kwh","typeLabel":"number"},"max_kwh":{"type":"number","example":5,"description":"Maximum energy consumption in kWh for this price to apply","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.max_kwh","typeLabel":"number"},"min_vehicle_soc":{"type":"number","example":80,"description":"Minimum vehicle state of charge percentage for which this price element is valid","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.min_vehicle_soc","typeLabel":"number"},"max_vehicle_soc":{"type":"number","example":95,"description":"Maximum vehicle state of charge percentage for which this price element is valid","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.max_vehicle_soc","typeLabel":"number"},"min_congestion_threshold":{"type":"number","example":70,"description":"Minimum location utilization percentage for which this price element is valid","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.min_congestion_threshold","typeLabel":"number"},"max_congestion_threshold":{"type":"number","example":90,"description":"Maximum location utilization percentage for which this price element is valid","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions.max_congestion_threshold","typeLabel":"number"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX].restrictions","typeLabel":"object"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price.elements","typeLabel":"object[]"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].price","typeLabel":"object"},"max_amperage":{"description":"Maximum current in Amperes that this connector can provide","type":"number","example":32,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].max_amperage","typeLabel":"number"},"max_voltage":{"description":"Maximum voltage in Volts that this connector can provide","type":"number","example":400,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX].max_voltage","typeLabel":"number"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].connectors","typeLabel":"object[]"},"capabilities":{"type":"array","description":"Values: `PLUG_AND_CHARGE_CAPABLE`, `REMOTE_START_STOP_CAPABLE`. New values in this array might be added without notice, so unknown values should be handled gracefully.","items":{"type":"string","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].capabilities.items.[INDEX]","typeLabel":"string"},"example":["RESERVABLE","PLUG_AND_CHARGE_CAPABLE","PLUG_AND_CHARGE_CAPABLE"],"isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].capabilities","typeLabel":"string[]"},"last_updated":{"type":"string","format":"date-time","description":"Time the EVSE data was last updated by the operator. Any EVSE data update changes it, so it does not show when the current `status` started. Use `status_since` from Get location live data for charging timing.","isRequired":true,"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].last_updated","typeLabel":"string\u003cdate-time>"},"evse_id":{"minLength":1,"type":"string","example":"+49*839*030*000074","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].evse_id","typeLabel":"string"},"physical_reference":{"type":"string","description":"The 'physical reference' is used by some CPOs to represent the label printed on the charging station itself. For example, in a charging location, the physical references could be '1', '2', '3', '4', for the four different charging stations","example":"4","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].physical_reference","typeLabel":"string"},"parking_restrictions":{"type":"array","description":"Parking restrictions for this EVSE.","items":{"type":"string","enum":["EV_ONLY","PLUGGED","DISABLED","CUSTOMERS","MOTORCYCLES"],"example":"EV_ONLY","uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].parking_restrictions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["EV_ONLY","CUSTOMERS"],"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX].parking_restrictions","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"locations.items.[INDEX].evses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"locations.items.[INDEX].evses","typeLabel":"object[]"},"country":{"maxLength":3,"minLength":3,"description":"Three-letter country code (ISO 3166-1 alpha-3) where the charging location is situated","type":"string","example":"DEU","isRequired":true,"uniqueKey":"locations.items.[INDEX].country","typeLabel":"string"},"city":{"type":"string","description":"City where the charging location is situated","example":"Berlin","isRequired":true,"uniqueKey":"locations.items.[INDEX].city","typeLabel":"string"},"address":{"type":"string","description":"Street address of the charging location","example":"EUREF CAMPUS 4-5","isRequired":true,"uniqueKey":"locations.items.[INDEX].address","typeLabel":"string"},"last_updated":{"type":"string","description":"ISO 8601 timestamp of when this location's data was last updated. Use this to track changes and implement efficient polling.","example":"2024-03-15T14:30:00Z","isRequired":true,"uniqueKey":"locations.items.[INDEX].last_updated","typeLabel":"string"},"parking_type":{"type":"string","description":"Parking type for the charging location.","enum":["ALONG_MOTORWAY","PARKING_GARAGE","PARKING_LOT","ON_DRIVEWAY","ON_STREET","UNDERGROUND_GARAGE"],"example":"PARKING_LOT","uniqueKey":"locations.items.[INDEX].parking_type","typeLabel":"enum\u003cstring>"},"operator":{"required":["id","name"],"type":"object","properties":{"id":{"type":"string","example":"881941","isRequired":true,"uniqueKey":"locations.items.[INDEX].operator.id","typeLabel":"string"},"name":{"maxLength":100,"minLength":0,"type":"string","example":"Ebee Smart Technologies","isRequired":true,"uniqueKey":"locations.items.[INDEX].operator.name","typeLabel":"string"},"hotline":{"type":"string","example":"+498944255071","uniqueKey":"locations.items.[INDEX].operator.hotline","typeLabel":"string"},"external_id":{"type":"string","example":"DE*ABC","uniqueKey":"locations.items.[INDEX].operator.external_id","typeLabel":"string"}},"description":"Information about the Charging Point Operator (CPO) managing this location","uniqueKey":"locations.items.[INDEX].operator","typeLabel":"object"},"operator_display_name":{"description":"An enhanced display name of the operator. This may be the operator name as found in the operator object, or the sub-operator of the location. When showing the location to end users, this is the operator name that should be shown.","type":"string","example":"Sub-operator X","uniqueKey":"locations.items.[INDEX].operator_display_name","typeLabel":"string"},"opening_times":{"required":["twentyfourseven"],"type":"object","properties":{"twentyfourseven":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.twentyfourseven","typeLabel":"boolean"},"regular_hours":{"type":"array","items":{"description":"Only to be used if twentyfourseven = false","required":["weekday","period_begin","period_end"],"properties":{"weekday":{"type":"integer","description":"Number of day in the week, from Monday (1) till Sunday (7)","example":1,"isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.regular_hours.items.[INDEX].weekday","typeLabel":"integer"},"period_begin":{"type":"string","format":"([0-1][0-9]|2[0-3]):[0-5][0-9]","example":"00:10","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.regular_hours.items.[INDEX].period_begin","typeLabel":"string\u003c([0-1][0-9]|2[0-3]):[0-5][0-9]>"},"period_end":{"type":"string","format":"([0-1][0-9]|2[0-3]):[0-5][0-9]","example":"29:59","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.regular_hours.items.[INDEX].period_end","typeLabel":"string\u003c([0-1][0-9]|2[0-3]):[0-5][0-9]>"}},"type":"object","uniqueKey":"locations.items.[INDEX].opening_times.regular_hours.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations.items.[INDEX].opening_times.regular_hours","typeLabel":"object[]"},"exceptional_openings":{"type":"array","items":{"required":["period_begin","period_end"],"properties":{"period_begin":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_openings.items.[INDEX].period_begin","typeLabel":"string\u003cdate-time>"},"period_end":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_openings.items.[INDEX].period_end","typeLabel":"string\u003cdate-time>"}},"type":"object","uniqueKey":"locations.items.[INDEX].opening_times.exceptional_openings.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_openings","typeLabel":"object[]"},"exceptional_closings":{"type":"array","items":{"required":["period_begin","period_end"],"properties":{"period_begin":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_closings.items.[INDEX].period_begin","typeLabel":"string\u003cdate-time>"},"period_end":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_closings.items.[INDEX].period_end","typeLabel":"string\u003cdate-time>"}},"type":"object","uniqueKey":"locations.items.[INDEX].opening_times.exceptional_closings.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations.items.[INDEX].opening_times.exceptional_closings","typeLabel":"object[]"}},"description":"Operating hours of the charging location","uniqueKey":"locations.items.[INDEX].opening_times","typeLabel":"object"},"directions":{"type":"array","description":"Navigation instructions to help locate the charging points, available in multiple languages","items":{"type":"object","required":["language","text"],"properties":{"language":{"type":"string","maxLength":2,"minLength":2,"example":"DE","isRequired":true,"uniqueKey":"locations.items.[INDEX].directions.items.[INDEX].language","typeLabel":"string"},"text":{"type":"string","maxLength":512,"example":"example","isRequired":true,"uniqueKey":"locations.items.[INDEX].directions.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"locations.items.[INDEX].directions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations.items.[INDEX].directions","typeLabel":"object[]"},"state":{"description":"State, region, or province where the charging location is situated. Format varies by country.","type":"string","example":"Bayern","uniqueKey":"locations.items.[INDEX].state","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal code of the charging location","example":10829,"uniqueKey":"locations.items.[INDEX].postal_code","typeLabel":"string"},"openNow":{"type":"boolean","description":"Indicates if the location is currently open based on opening_hours and local timezone. Use this for quick filtering of available locations.","example":false,"uniqueKey":"locations.items.[INDEX].openNow","typeLabel":"boolean"},"is_green_energy":{"type":"boolean","description":"Indicates if the location uses renewable energy sources for charging, based on CPO-provided data","example":false,"uniqueKey":"locations.items.[INDEX].is_green_energy","typeLabel":"boolean"}},"uniqueKey":"locations.items.[INDEX]","typeLabel":"object"},"description":"Locations matching the geosearch criteria.","isRequired":true,"uniqueKey":"locations","typeLabel":"object[]"},"aggregates":{"type":"array","description":"Present only if 'aggregate' request param = true. Contains only aggregates of 2 or more locations. Single locations are returned in 'locations' array.","items":{"type":"object","required":["coordinates","count"],"properties":{"coordinates":{"type":"object","description":"Aggregate center coordinates returned as strings.","properties":{"latitude":{"pattern":"-?[0-9]{1,2}\\.[0-9]{6}","type":"string","description":"Latitude serialized as a string, for example `52.475911`.","example":"52.475911","uniqueKey":"aggregates.items.[INDEX].coordinates.latitude","typeLabel":"string"},"longitude":{"pattern":"-?[0-9]{1,3}\\.[0-9]{6}","type":"string","description":"Longitude serialized as a string, for example `13.350794`.","example":"13.350794","uniqueKey":"aggregates.items.[INDEX].coordinates.longitude","typeLabel":"string"}},"isRequired":true,"uniqueKey":"aggregates.items.[INDEX].coordinates","typeLabel":"object"},"count":{"type":"integer","description":"Number of locations around this point.","minimum":2,"isRequired":true,"uniqueKey":"aggregates.items.[INDEX].count","typeLabel":"integer"}},"uniqueKey":"aggregates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"aggregates","typeLabel":"object[]"}},"description":"Response payload containing matching locations and aggregate metadata for a geosearch query.","uniqueKey":"","typeLabel":"object"},"example":{"locations":[{"id":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0gQhJv/Yjp5FXBJt14SccU9zFRdnC4SV7juPdCRaWkEZo=","name":"Ebee Smart Technologies","coordinates":{"latitude":"52.475911","longitude":"13.350794"},"evses":[{"uid":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0g3wFt7gLfnV3ulxmnoAzR4W/DFEMs63CndZpPK6L2aJG9qMC0Dp9OqeegGRXmiTOE","evse_id":"+49*839*030*000074","physical_reference":"4","status":"AVAILABLE","connectors":[{}],"capabilities":["RESERVABLE","PLUG_AND_CHARGE_CAPABLE","PLUG_AND_CHARGE_CAPABLE"],"last_updated":"2025-01-15T10:30:00Z"}],"operator":{"id":"881941","name":"Ebee Smart Technologies","hotline":"+498944255071","external_id":"DE*ABC"},"operator_display_name":"Sub-operator X","opening_times":{"twentyfourseven":false,"regular_hours":[{"weekday":1,"period_begin":"00:10","period_end":"29:59"}],"exceptional_openings":[{"period_begin":"2025-01-15T10:30:00Z","period_end":"2025-01-15T10:30:00Z"}],"exceptional_closings":[{"period_begin":"2025-01-15T10:30:00Z","period_end":"2025-01-15T10:30:00Z"}]},"directions":[{"language":"DE","text":"example"}],"country":"DEU","state":"Bayern","city":"Berlin","postal_code":10829,"address":"EUREF CAMPUS 4-5","openNow":false,"is_green_energy":false,"last_updated":"2024-03-15T14:30:00Z"}],"aggregates":[{"coordinates":{"latitude":"52.475911","longitude":"13.350794"},"count":1}]},"examples":{"Example":{"title":"Example","value":{"locations":[{"id":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0gQhJv/Yjp5FXBJt14SccU9zFRdnC4SV7juPdCRaWkEZo=","name":"Ebee Smart Technologies","coordinates":{"latitude":"52.475911","longitude":"13.350794"},"evses":[{"uid":"8rMCionje8s2LtheVGEK90mYnJdJe5OZd48ecF/w1StRJSodFFzfQ3GhJbYbxG0g3wFt7gLfnV3ulxmnoAzR4W/DFEMs63CndZpPK6L2aJG9qMC0Dp9OqeegGRXmiTOE","evse_id":"+49*839*030*000074","physical_reference":"4","status":"AVAILABLE","connectors":[{}],"capabilities":["RESERVABLE","PLUG_AND_CHARGE_CAPABLE","PLUG_AND_CHARGE_CAPABLE"],"last_updated":"2025-01-15T10:30:00Z"}],"operator":{"id":"881941","name":"Ebee Smart Technologies","hotline":"+498944255071","external_id":"DE*ABC"},"operator_display_name":"Sub-operator X","opening_times":{"twentyfourseven":false,"regular_hours":[{"weekday":1,"period_begin":"00:10","period_end":"29:59"}],"exceptional_openings":[{"period_begin":"2025-01-15T10:30:00Z","period_end":"2025-01-15T10:30:00Z"}],"exceptional_closings":[{"period_begin":"2025-01-15T10:30:00Z","period_end":"2025-01-15T10:30:00Z"}]},"directions":[{"language":"DE","text":"example"}],"country":"DEU","state":"Bayern","city":"Berlin","postal_code":10829,"address":"EUREF CAMPUS 4-5","openNow":false,"is_green_energy":false,"last_updated":"2024-03-15T14:30:00Z"}],"aggregates":[{"coordinates":{"latitude":"52.475911","longitude":"13.350794"},"count":1}]}}},"exampleType":"examples"}},"exampleType":"examples"},"7929d716-2678-4e2a-a33f-45a198e136aa":{"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"},"eee58f4c-51a1-4173-9bdc-086a593962a7":{"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":{"13245e77-342a-4d12-bb6d-2ca8a71030d8":{"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":"Rectangle search - Plugsurfing Developer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-29T12:11:21.045Z","originalFileLocation":"reference/searchLocationsByRectangle.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=\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\">\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=\"Rectangle search - Plugsurfing Developer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Plugsurfing Developer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle\">\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=Geosearch\u0026amp;title=Rectangle+search\u0026amp;description=Find+charging+locations+within+a+specified+rectangle+defined+by+two+diagonal+points.+The+rectangle+coordinates+are+passed+via+the+%60topLatitude%60%2C+%60bottomLatitude\u0026amp;theme=ead381321109242992897df9\u0026amp;signature=bd639285a7c075bf56fb9b3970703c68fde481d5ca43bd5d632fe3643e594007\">\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=\"Rectangle search - Plugsurfing Developer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plugsurfing.mintlify.site/_mintlify/api/og/v2?division=Geosearch\u0026amp;title=Rectangle+search\u0026amp;description=Find+charging+locations+within+a+specified+rectangle+defined+by+two+diagonal+points.+The+rectangle+coordinates+are+passed+via+the+%60topLatitude%60%2C+%60bottomLatitude\u0026amp;theme=ead381321109242992897df9\u0026amp;signature=bd639285a7c075bf56fb9b3970703c68fde481d5ca43bd5d632fe3643e594007\">\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/searchLocationsByRectangle\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/searchLocationsByRectangle.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/searchLocationsByRectangle#webpage\",\"url\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle\",\"name\":\"Rectangle search\",\"description\":\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\",\"dateModified\":\"2026-07-29T12:11:21.045Z\",\"isPartOf\":{\"@id\":\"https://developer.plugsurfing.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Plugsurfing Developer\",\"item\":\"https://developer.plugsurfing.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rectangle search\",\"item\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle#apireference\",\"headline\":\"Rectangle search\",\"name\":\"Rectangle search\",\"description\":\"Find charging locations within a specified rectangle defined by two diagonal points. The rectangle coordinates are passed via the topLatitude, bottomLatitude, leftLongitude, and rightLongitude query parameters; the request body contains only filters and options. Returns up to 300 locations. Prices are not included. To get prices for a given location, use Get location by id\",\"url\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle\",\"mainEntityOfPage\":{\"@id\":\"https://developer.plugsurfing.com/reference/searchLocationsByRectangle#webpage\"},\"dateModified\":\"2026-07-29T12:11:21.045Z\",\"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,"description":null,"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","description":"Find charging locations within a specified radius around a geographic point. The center point, distance, limit, and aggregation settings are passed via query parameters; the request body contains only filters. Use an empty JSON body (`{}`) when no filters are needed. Returns up to 300 locations sorted by proximity to the search center (nearest first). Prices are not included. To get prices for a given location, use Get location by id.","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","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","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":"Rectangle search - 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"]}