Electric Vehicle Charging Ports (GET /api/alt-fuel-stations/v1/ev-charging-units)
Return a CSV file of EV charging ports for stations that match your query. For JSON or other file formats, this information is available via the All Stations API.
Request URL
GET /api/alt-fuel-stations/v1/ev-charging-units.csv?parameters
Request Parameters
The following query parameters may be passed in the request to control the output:
| Parameter | Required | Value | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| access | No |
Type: string
Default: all
Options: all, public, private
|
Return stations with the given access type.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| api_key | Yes |
Type: string
Default: None
|
Your developer API key. See API key usage for more information. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cards_accepted | No |
Type: string
Default: all
Options: all, A, CREDIT, Debit, D, M, V, Cash, Checks, ACCOUNT_BALANCE, ALLIANCE, ANDROID_PAY, APPLE_PAY, ARI, CleanEnergy, Comdata, CFN, EFS, FleetOne, FuelMan, GasCard, PacificPride, PHH, Proprietor, Speedway, SuperPass, TCH, Tchek, Trillium, Voyager, Wright_Exp
|
Return stations that accept any of the given payment methods. A single payment method, or a comma-separated list of multiple payment methods, may be given.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| country | No |
Type: string
Default: US
Options: all, US, CA
|
Return only stations within the given country code.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_charging_level | No |
Type: string
Default: all
Options: all, 1, 2, dc_fast
|
Return only EV charging stations that provide the given level of electric vehicle supply equipment (EVSE).
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_connector_type | No |
Type: string
Default: all
Options: all, NEMA1450, NEMA515, NEMA520, J1772, TESLA, J1772COMBO, CHADEMO, J3271
|
Return only EV charging stations that provide the given connector types.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_connector_type_operator | No |
Type: string
Default: OR
Options: OR, AND
|
Control how multiple connector type options passed to the For example, with the default |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_network | No |
Type: string
Default: all
Options: all, 7CHARGE, ABM, AMPED_UP, AMPUP, APPLEGREEN, AUTEL, BCHYDRO, Blink Network, BP_PULSE, CHAEVI, CHARGELAB, CHARGENET, ChargePoint Network, CHARGESMART_EV, CHARGEUP, CHARGIE, CIRCLE_K, COUCHE_TARD, Circuit électrique, DIRT_ROAD, eCharge Network, ELECTRIC_ERA, Electrify America, Electrify Canada, Enel X Way, ENVIROSPARK, EPIC_CHARGING, EVBOLT, EV Connect, EVCS, EVGATEWAY, eVgo Network, EVIUM, EVMATCH, EVOKE, EVPASSPORT, EVPOWER, EVRANGE, EVXY, FLASH, FLITWAY, FLO, FORD_CHARGE, FPLEV, FCN, GO_TO_U, GRAVITI_ENERGY, GRAVITY_CHARGING_CENTER, HONEY_BADGER, Hwisel, HYPERFUEL, IN_CHARGE, IONNA, IVY, JULE, KWIK_CHARGE, LAKELAND_EV, LOOP, MATCHA, MERCEDES_BENZ, Non-Networked, NOODOE, OBE_POWER, ON_THE_RUN_EV, OpConnect, PETROCAN, POWERCHARGE, POWERFLEX, POWERPORT_EVC, POWERPUMP, QUICKCHARGE, RED_E, REVEL, REVITALIZE, RIVIAN_ADVENTURE, RIVIAN_WAYPOINTS, ROVE, SHELL_RECHARGE, STAY_N_CHARGE, Sun Country Highway, SWTCH, Tesla Destination, Tesla, TURNONGREEN, UNIVERSAL, VIALYNK, WATT_EV, WAVE, ZEFNET
|
Return only EV charging stations that belong to the given network. A single network, or a comma-separated list of multiple networks, may be given.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_power_kw_max | No |
Type: decimal
Default: None
|
Return stations that have at least one charging port with power output no greater than this value. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ev_power_kw_min | No |
Type: decimal
Default: None
|
Return stations that have at least one charging port with power output no less than this value. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| facility_type | No |
Type: string
Default: all
Options: all, AIRPORT, ARENA, AUTO_REPAIR, BANK, B_AND_B, BREWERY_DISTILLERY_WINERY, CAMPGROUND, CAR_DEALER, CARWASH, COLLEGE_CAMPUS, CONVENIENCE_STORE, CONVENTION_CENTER, COOP, FACTORY, FED_GOV, FIRE_STATION, FLEET_GARAGE, FUEL_RESELLER, GROCERY, HARDWARE_STORE, HOSPITAL, HOTEL, INN, LIBRARY, MIL_BASE, MOTOR_POOL, MULTI_UNIT_DWELLING, MUNI_GOV, MUSEUM, NATL_PARK, OFFICE_BLDG, OTHER, OTHER_ENTERTAINMENT, PARK, PARKING_GARAGE, PARKING_LOT, PAY_GARAGE, PAY_LOT, PHARMACY, PLACE_OF_WORSHIP, PRISON, PRIVATE, PUBLIC, REC_SPORTS_FACILITY, REFINERY, RENTAL_CAR_RETURN, RESEARCH_FACILITY, RESTAURANT, REST_STOP, RETAIL, RV_PARK, SCHOOL, GAS_STATION, SHOPPING_CENTER, SHOPPING_MALL, STADIUM, STANDALONE_STATION, STATE_GOV, STORAGE, STREET_PARKING, TNC, TRAVEL_CENTER, TRUCK_STOP, UTILITY, WORKPLACE
|
Return only EV charging stations located at the given facility type. A single facility type, or a comma-separated list of multiple facility types, may be given.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| federal_agency | No |
Type: string
Default: all
Options: all, AAF, CH, CHSW, USACE_CW, CSOSA, DEF, DAF, DA, DOC, HHS, DHS, HUD, DOJ, DOL, DON, DOS, DOI, DOT, DTS, VA, EWDL, ECC, FCSD, FTC, FIN, FOCCG, GSA, GAFA, GAID, GAIT, HLTH, IRC, INA, IC, ISED, JUS, LGHC, NASA, NDEF, NREV, NRES, PARL, PQPCC, PM, PSEP, PSP, SCI, SBT, SI, SSA, TVA, TRANS, TREAS, USMC, CBP, USDA, DOD, EDU, DOE, EPA, FAA, IRS, NRC, USPS, VAFF
|
Return stations owned by the given federal agency. A federal agency code, or a comma-separated list of multiple federal agency codes, may be given.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | No |
Type: integer or string
Default: all
Range: 0 to 200, or all
|
The maximum number of results to return. An explicit limit of up to 200 may be passed in, or the special all string may be passed in to return all results. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| status | No |
Type: string
Default: all
Options: all, E, P, T
|
Return stations that match the given status. A single status, or a comma-separated list of multiple statuses, may be given.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| state | No |
Type: string
Default: None
|
Return only stations within the given state. State must be given as a two-character state code (eg, "CO" for Colorado). A single state, or a comma-separate list of multiple states, may be given. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| zip | No |
Type: string
Default: None
|
Return only stations within the given ZIP code. ZIP codes must be exactly 5 digits long. A single ZIP code, or a comma-separate list of multiple ZIP codes, may be given. |
Response Fields
The response is a CSV data download that includes information about EV charging power output by connector type matching the requested query. Each row in the spreadsheet represents an EV charging unit that might have one or more ports and one or more connectors. A single station location may have multiple rows in the spreadsheet.
The table below documents the columns unique to this data download. For documentation on the remaining columns in the CSV, see the response fields for the All Stations endpoint.
| Field | Description |
|---|---|
| EV Level1 EVSE Num | Total number of Level 1 charging ports at station location |
| EV Level2 EVSE Num | Total number of Level 2 charging ports at station location |
| EV DC Fast Count | Total number of DC Fast charging ports at station location |
| EV J1772 Connector Count | Total number of J1772 connectors at station location |
| EV J1772 Power Output (kW) | Power output in kilowatts of J1772 ports |
| EV CCS Connector Count | Total number of CCS/J1772 Combo connectors at station location |
| EV CCS Power Output (kW) | Power output in kilowatts of CCS/J1772 Combo ports |
| EV CHAdeMO Connector Count | Total number of CHAdeMO connectors at station location |
| EV CHAdeMO Power Output (kW) | Power output in kilowatts of CHAdeMO ports |
| EV J3400 Connector Count | Total number of NACS/J3400 connectors at station location |
| EV J3400 Power Output (kW) | Power output in kilowatts of NACS/J3400 ports |
| EV J3271 Connector Count | Total number of MCS/J3271 connectors at station location |
| EV J3271 Power Output (kW) | Power output in kilowatts of MCS/J3271 ports |
Rate Limits
Standard rate limits apply. No more than 1,000 requests may be made in any hour
Errors
Standard errors may be returned. In addition, the following service-specific errors may be returned:
| HTTP Status Code | Description |
|---|---|
| 422 | Unprocessable Entity - An invalid value was given for a query parameter. The response body will describe the specific error. |