# Open Charge Map API > Open Charge Map returns charging location data and is available as a workflow and API. Open Charge Map, also called OpenChargeMap or OCM, returns nearby charging locations, ordered nearest first. Search chargers needs an address, city, or postcode; optional filters include connector, radius, maximum results, and minimum power. - Page: https://fous.com/workflows/open-charge-map - Handle: `@open-charge-map` - Category: [Travel](https://fous.com/workflows/category/travel) - Source website: https://openchargemap.org - Last verified: Sep 29, 2026 - Fous is not affiliated with Open Charge Map. ## Methods ### Search chargers Operation `search_chargers`, version 1. 1 credit per call. Find Open Charge Map charging locations near an address, city, or postcode, nearest first. Unreported point counts, connector counts, operating status, and verification dates are left blank. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `location` | string | yes | `"New York, NY"` | Address, city, or postcode near which to search, for example Oxford, UK. | | `connector` | string | no | `"CCS"` | Connector to require, for example CCS; any accepts all. | | `radius_km` | number | no | `5` | Search radius in kilometres, for example 10 (maximum 100). | | `max_results` | integer | no | `5` | Maximum number of locations, for example 20 (maximum 100). | | `min_power_kw` | number | no | `50` | Minimum power in kW for a matching connector, for example 50; 0 accepts any power. | **Input schema** ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "minLength": 2, "description": "Address, city, or postcode near which to search, for example Oxford, UK.", "examples": [ "New York, NY", "Oxford, UK" ] }, "connector": { "enum": [ "any", "CCS", "CHAdeMO", "Type 2", "Tesla/NACS", "J1772" ], "type": "string", "default": "any", "description": "Connector to require, for example CCS; any accepts all.", "examples": [ "CCS", "CHAdeMO" ] }, "radius_km": { "type": "number", "default": 10, "maximum": 100, "minimum": 0.1, "description": "Search radius in kilometres, for example 10 (maximum 100).", "examples": [ 5, 2 ] }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of locations, for example 20 (maximum 100).", "x-fous-developer": true, "examples": [ 5 ] }, "min_power_kw": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum power in kW for a matching connector, for example 50; 0 accepts any power.", "examples": [ 50 ] } }, "additionalProperties": false, "examples": [ { "location": "New York, NY", "connector": "CCS", "radius_km": 5, "max_results": 5, "min_power_kw": 50 }, { "location": "Oxford, UK" }, { "location": "Oxford, UK", "connector": "CHAdeMO", "radius_km": 2, "max_results": 5, "min_power_kw": 50 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `chargers` | array | | | | `chargers[].cost` | string or null | | | | `chargers[].name` | string or null | `"Delancey & Essex Municipal Parking Garage"` | | | `chargers[].town` | string or null | `"Manhattan"` | | | `chargers[].access` | string or null | `"public"` | | | `chargers[].address` | string or null | `"107 Essex St"` | | | `chargers[].country` | string or null | `"United States"` | | | `chargers[].latitude` | number or null | `40.719051` | | | `chargers[].map_link` | string | `"https://map.openchargemap.io/?id=102832"` | | | `chargers[].operator` | string or null | `"EV Connect"` | | | `chargers[].postcode` | string or null | `"10002"` | | | `chargers[].longitude` | number or null | `-73.988181` | | | `chargers[].connectors` | array | | | | `chargers[].distance_km` | number or null | `1.66` | | | `chargers[].operational` | boolean or null | `true` | | | `chargers[].distance_miles` | number or null | `1.03` | | | `chargers[].last_verified_date` | string or null | `"2024-03-11"` | | | `chargers[].open_charge_map_id` | integer | `102832` | | | `chargers[].number_of_charging_points` | integer or null | `11` | | **Example input** ```json { "location": "New York, NY", "connector": "CCS", "radius_km": 5, "max_results": 5, "min_power_kw": 50 } ``` **Example output** ```json { "chargers": [ { "cost": null, "name": "Delancey & Essex Municipal Parking Garage", "town": "Manhattan", "access": "public", "address": "107 Essex St", "country": "United States", "latitude": 40.719051, "map_link": "https://map.openchargemap.io/?id=102832", "operator": "EV Connect", "postcode": "10002", "longitude": -73.988181, "connectors": [ { "type": "Type 1 (J1772)", "count": 8, "power_kw": 7.5 }, { "type": "CHAdeMO", "count": 4, "power_kw": 50 } ], "distance_km": 1.66, "operational": true, "distance_miles": 1.03, "last_verified_date": "2024-03-11", "open_charge_map_id": 102832, "number_of_charging_points": null }, { "cost": null, "name": "DES - Delancey and Essex Municipal Parking Garage", "town": "New York", "access": "public", "address": "107 Essex Street", "country": "United States", "latitude": 40.719319, "map_link": "https://map.openchargemap.io/?id=353340", "operator": "EV Connect", "postcode": "10002", "longitude": -73.988197, "connectors": [ { "type": "Type 1 (J1772)", "count": 8, "power_kw": 3.7 }, { "type": "CHAdeMO", "count": 1, "power_kw": 50 } ], "distance_km": 1.67, "operational": true, "distance_miles": 1.04, "last_verified_date": "2025-11-11", "open_charge_map_id": 353340, "number_of_charging_points": null } ] } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@open-charge-map", "visibility": "public", "operation": "search_chargers", "version": 1, "input": { "location": "New York, NY", "connector": "CCS", "radius_km": 5, "max_results": 5, "min_power_kw": 50 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@open-charge-map\",\n \"visibility\": \"public\",\n \"operation\": \"search_chargers\",\n \"version\": 1,\n \"input\": {\n \"location\": \"New York, NY\",\n \"connector\": \"CCS\",\n \"radius_km\": 5,\n \"max_results\": 5,\n \"min_power_kw\": 50\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@open-charge-map", "visibility": "public", "operation": "search_chargers", "version": 1, "input": { "location": "New York, NY", "connector": "CCS", "radius_km": 5, "max_results": 5, "min_power_kw": 50 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@open-charge-map","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## Use cases - Find charging locations near a planned stop - Compare charger distance, connectors, and power - Check a location’s operator and access details - Review reported operating status and verification dates ## FAQ ### Is Fous affiliated with Open Charge Map? No. Fous is not affiliated with Open Charge Map. This workflow reads the public openchargemap.org website and returns its data. ### How much does it cost? Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit. ### Do I need a Open Charge Map account? No. You only need a Fous account. ### How current is the data? Fous gets the data from openchargemap.org when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026. ### What charging locations are near an address or city? Search chargers returns nearby locations ordered by distance, with address, town, distance, and map details. ### Which nearby chargers have a particular connector? Search chargers can filter locations by connector and minimum power. ### What is reported about a charger’s status? Search chargers returns operating status and last verified date when reported; unreported values are left blank. ## Related - [PlugShare API](https://fous.com/workflows/plugshare.md): EV charging station map and driver reviews. - [Tesla API](https://fous.com/workflows/tesla.md): Tesla offers new and certified pre-owned vehicles across the United States and nearby open Supercharger sites, with delivery estimates and opening hours only when available. - [OpenStreetMap API](https://fous.com/workflows/openstreetmap.md): OpenStreetMap returns place coordinates, address details, nearby readable place information, and ordered place search results from contributor-created data; results reflect mapped features and may be incomplete or differ from landmarks. - [Alternative Fuels Data Center API](https://fous.com/workflows/alternative-fuels-data-center.md): U.S. Department of Energy data on alternative fuel stations and vehicles. - [Google Maps API](https://fous.com/workflows/google-maps.md): Google Maps returns nearby places, public place details, up to 100 public reviews, and up to three routes; transit options vary by departure time. - [Postcodes.io API](https://fous.com/workflows/postcodes-io.md): Postcodes.io provides UK postcode, location and administrative information; nearby postcode results include distance and coordinates, while retired postcodes lack administrative details. - [OfferUp API](https://fous.com/workflows/offerup.md): Local marketplace for buying and selling items. - [McDonald's API](https://fous.com/workflows/mcdonalds.md): McDonald’s provides menu-item food information for US, UK and Canadian items, plus nearby US restaurants and listed hours today, which may miss unexpected closures. - [All Travel workflows](https://fous.com/workflows/category/travel)