{"openapi":"3.1.0","info":{"title":"HERE EV Charge Points API (your key) API","version":"0.1.0","description":"HERE EV Charge Points API (your key) lets an AI assistant read your own HERE EV Charge Points data through the HERE EV Charge Points API with a key you supply (HERE API key). Read-only: 6 tools (get_charging_locations, get_charging_location, get_charging_connectors, get_charging_tariffs, get_country_metadata, get_service_version). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-here-ev-charge-points.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-here-ev-charge-points/docs"},"termsOfService":"https://connectorbay.com/byok-here-ev-charge-points/terms"},"servers":[{"url":"https://byok-here-ev-charge-points.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-here-ev-charge-points/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_charging_locations":{"post":{"operationId":"get_charging_locations","summary":"Get EV charging locations by id with name, operator, position, restrictions and supported vehicles; add fields such as a","description":"Get EV charging locations by id with name, operator, position, restrictions and supported vehicles; add fields such as address or locationInfo for more; returns the provider's JSON with items and missing ids. Use for \"What is charging location here:pds:place:276u33db-8ce1fe1fd8b44f81b7a5ca5ba4f3be1e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated charging location ids (at most 100; use the last id component alone when sending more than 50).","maxLength":4000,"title":"Ids","type":"string"},"fields":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":"address","description":"Comma-separated extra fields: address, locationInfo (opening hours, time zone, phone), emsps, nearby.","title":"Fields"}},"required":["ids"],"title":"get_charging_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_charging_location":{"post":{"operationId":"get_charging_location","summary":"Get one EV charging location by id with address, opening hours, time zone and operator details. Use for \"Show charging l","description":"Get one EV charging location by id with address, opening hours, time zone and operator details. Use for \"Show charging location here:pds:place:276u33db-8ce1fe1fd8b44f81b7a5ca5ba4f3be1e in detail\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location_id":{"description":"Charging location id, for example from HERE Geocoding and Search.","maxLength":200,"title":"Location Id","type":"string"},"fields":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":"address,locationInfo","description":"Comma-separated extra fields: address, locationInfo, emsps, connectorGroups, evses, nearby.","title":"Fields"}},"required":["location_id"],"title":"get_charging_locationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_charging_connectors":{"post":{"operationId":"get_charging_connectors","summary":"Get the chargers (EVSEs) and connector groups of charging locations by id: connector standards, maximum power, counts an","description":"Get the chargers (EVSEs) and connector groups of charging locations by id: connector standards, maximum power, counts and live status where available. Use for \"Which connector types and power levels does charging location here:pds:place:276u33db-8ce1fe1fd8b44f81b7a5ca5ba4f3be1e have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated charging location ids (at most 100; use the last id component alone when sending more than 50).","maxLength":4000,"title":"Ids","type":"string"},"fields":{"anyOf":[{"const":"evses,connectorGroups","type":"string"},{"type":"null"}],"default":"evses,connectorGroups","description":"Fixed to evses and connectorGroups.","title":"Fields"},"connector_types":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only EVSEs with these connector types, comma-separated (see get_country_metadata connectorTypes standards), for example 'iec62196Type2CCS'.","title":"Connector Types"}},"required":["ids"],"title":"get_charging_connectorsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_charging_tariffs":{"post":{"operationId":"get_charging_tariffs","summary":"Get charging tariffs (ad-hoc by default, or all, cpo, emsp or a partner id) for the chargers of charging locations by id","description":"Get charging tariffs (ad-hoc by default, or all, cpo, emsp or a partner id) for the chargers of charging locations by id. Use for \"What does it cost to charge at here:pds:place:276u33db-8ce1fe1fd8b44f81b7a5ca5ba4f3be1e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated charging location ids (at most 100; use the last id component alone when sending more than 50).","maxLength":4000,"title":"Ids","type":"string"},"fields":{"anyOf":[{"const":"evses,tariffs","type":"string"},{"type":"null"}],"default":"evses,tariffs","description":"Fixed to evses and tariffs.","title":"Fields"},"tariff":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":"adhoc","description":"Which tariffs: adhoc (default), all, cpo, emsp or 'partner:<partnerId>' (one value).","title":"Tariff"}},"required":["ids"],"title":"get_charging_tariffsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_country_metadata":{"post":{"operationId":"get_country_metadata","summary":"Get EV charging metadata for countries: roaming providers (eMSPs), charge point operators and connector types, selected ","description":"Get EV charging metadata for countries: roaming providers (eMSPs), charge point operators and connector types, selected with fields; without countries returns all. Use for \"Which charging operators and connector types does HERE know in Germany\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country_codes":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISO 3166-1 alpha-3 country codes, for example 'DEU,NLD'.","title":"Country Codes"},"fields":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated parts to return: eMobilityServiceProviders, operators, connectorTypes (default only the country list).","title":"Fields"}},"title":"get_country_metadataArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_service_version":{"post":{"operationId":"get_service_version","summary":"Show the EV Charge Points API version information. Use for \"Which version of the HERE EV Charge Points API is running\".","description":"Show the EV Charge Points API version information. Use for \"Which version of the HERE EV Charge Points API is running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_service_versionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}