Developer Network NREL NREL Developer Network

Nearest Stations (GET /api/alt-fuel-stations/v1/nearest)

Return the nearest alternative fuel stations within a distance of a given location.

Request URL

GET /api/alt-fuel-stations/v1/nearest.format?parameters

Request Parameters

The following query parameters may be passed in the request to control the output:

Parameter Required Value Description
format Yes
Type: string
Default: None
Options: json, xml, csv, geojson, kml

The output response format. Given in the URL as the file extension.

api_key Yes
Type: string
Default: None

Your developer API key. See API key usage for more information.

location Depends
Type: string
Default: None

A free-form input describing the address of the location. This may include the address given in a variety of formats, such as:

  • street, city, state, postal code
  • street, city, state
  • street, postal code
  • postal code
  • city, state

(Either the location parameter or both the latitude and longitude parameters are required)

latitude Depends
Type: decimal
Range: -90 to 90

The latitude of the desired location.

(Either the location parameter or both the latitude and longitude parameters are required)

longitude Depends
Type: decimal
Range: -180 to 180

The longitude of the desired location.

(Either the location parameter or both the latitude and longitude parameters are required)

radius No
Type: decimal or string
Default: 5.0
Range: 0.0 to 500.0, or infinite

The radius (in miles) around the search location to search for stations within.

An explicit radius of up to 500.0 miles may be passed in, or the special infinite string may be passed in to find the nearest stations regardless of distance.

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.

Option Description
all All
E Available
P Planned
T Temporarily Unavailable
access No
Type: string
Default: all
Options: all, public, private

Return stations with the given access type.

Option Description
all All
public Public
private Private
fuel_type No
Type: string
Default: all
Options: all, BD, CNG, ELEC, E85, HY, LNG, LPG

Return stations that supply any of the given fuel types. A single fuel type, or a comma-separated list of multiple fuel types, may be given.

Value Description
all All Fuels
BD Biodiesel (B20 and above)
CNG Compressed Natural Gas (CNG)
ELEC Electric
E85 Ethanol (E85)
HY Hydrogen
LNG Liquefied Natural Gas (LNG)
LPG Propane (LPG)
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.

Option Description
all All
A American Express
CREDIT Credit
Debit Debit
D Discover
M MasterCard
V Visa
Cash Cash
Checks Check
ACCOUNT_BALANCE Account Balance
ALLIANCE Alliance AutoGas
ANDROID_PAY Android Pay
APPLE_PAY Apple Pay
ARI ARI
CleanEnergy Clean Energy
Comdata Comdata
CFN Commercial Fueling Network
EFS EFS
FleetOne Fleet One
FuelMan Fuelman
GasCard GASCARD
PacificPride Pacific Pride
PHH PHH
Proprietor Proprietor Fleet Card
Speedway Speedway
SuperPass SuperPass
TCH TCH
Tchek T-Chek T-Card
Trillium Trillium
Voyager Voyager
Wright_Exp WEX
owner_type No
Type: string
Default: all
Options: all, FG, J, LG, P, SG, T

Return stations owned by the given types of owners. A single owner type, or a comma-separated list of multiple owner types, may be given.

Option Description
all All
FG Federal Government Owned
J Jointly Owned
LG Local/Municipal Government Owned
P Privately Owned
SG State/Provincial Government Owned
T Utility Owned
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, TRANS, TREAS, USMC, CBP, USDA, DOD, DOE, EPA, FAA, IRS, 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.

Option Description
all All
AAF Agriculture and Agri-Food (CA)
CH Canadian Heritage (CA)
CHSW Canadian Heritage (Status of Women) (CA)
USACE_CW Corps of Engineers, Civil Works (US)
CSOSA Court Services and Offender Supervision Agency (US)
DEF Defense Agencies (US)
DAF Department of Air Force (US)
DA Department of Army (US)
DOC Department of Commerce (US)
HHS Department of Health and Human Services (US)
DHS Department of Homeland Security (US)
HUD Department of Housing and Urban Development (US)
DOJ Department of Justice (US)
DOL Department of Labor (US)
DON Department of Navy (US)
DOS Department of State (US)
DOI Department of the Interior (US)
DOT Department of Transportation (US)
DTS Department of Treasury (US)
VA Department of Veterans Affairs (US)
EWDL Employment, Workforce Development and Labour (CA)
ECC Environment and Climate Change (CA)
FCSD Families, Children and Social Development (CA)
FTC Federal Trade Commission (US)
FIN Finance (CA)
FOCCG Fisheries, Oceans and the Canadian Coast Guard (CA)
GSA General Services Administration (US)
GAFA Global Affairs (Foreign Affairs) (CA)
GAID Global Affairs (International Development) (CA)
GAIT Global Affairs (International Trade) (CA)
HLTH Health (CA)
IRC Immigration, Refugees and Citizenship (CA)
INA Indigenous and Northern Affairs (CA)
IC Infrastructure and Communities (CA)
ISED Innovation, Science and Economic Development (CA)
JUS Justice (CA)
LGHC Leader of the Government in the House of Commons (CA)
NASA National Aeronautics and Space Administration (US)
NDEF National Defence (CA)
NREV National Revenue (CA)
NRES Natural Resources (CA)
PARL Parliament (CA)
PQPCC President of the Queen's Privy Council for Canada (CA)
PM Prime Minister (CA)
PSEP Public Safety and Emergency Preparedness (CA)
PSP Public Services and Procurement (CA)
SCI Science (CA)
SBT Small Business and Tourism (CA)
SI Smithsonian Institution (US)
SSA Social Security Administration (US)
TRANS Transport (CA)
TREAS Treasury Board (CA)
USMC United States Marine Corps (US)
CBP U.S. Customs and Border Protection (US)
USDA U.S. Department of Agriculture (US)
DOD U.S. Department of Defense (US)
DOE U.S. Department of Energy (US)
EPA U.S. Environmental Protection Agency (US)
FAA U.S. Federal Aviation Administration (US)
IRS U.S. Internal Revenue Service (US)
USPS U.S. Postal Service (US)
VAFF Veterans Affairs (CA)
federal_agency_id No
Type: integer
Default: all
Options: all, 32, 33, 34, 2, 28, 3, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 35, 36, 37, 31, 38, 39, 21, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 22, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 23, 24, 60, 61, 26, 1, 4, 29, 8, 20, 30, 27, 25, 62

Deprecated: See federal_agency. (Note: this query parameter will remain for legacy application support)

Return stations owned by the given federal agency. A federal agency ID, or a comma-separated list of multiple federal agency IDs, may be given.

Option Description
all All
32 Agriculture and Agri-Food (CA)
33 Canadian Heritage (CA)
34 Canadian Heritage (Status of Women) (CA)
2 Corps of Engineers, Civil Works (US)
28 Court Services and Offender Supervision Agency (US)
3 Defense Agencies (US)
5 Department of Air Force (US)
6 Department of Army (US)
7 Department of Commerce (US)
9 Department of Health and Human Services (US)
10 Department of Homeland Security (US)
11 Department of Housing and Urban Development (US)
12 Department of Justice (US)
13 Department of Labor (US)
14 Department of Navy (US)
15 Department of State (US)
16 Department of the Interior (US)
17 Department of Transportation (US)
18 Department of Treasury (US)
19 Department of Veterans Affairs (US)
35 Employment, Workforce Development and Labour (CA)
36 Environment and Climate Change (CA)
37 Families, Children and Social Development (CA)
31 Federal Trade Commission (US)
38 Finance (CA)
39 Fisheries, Oceans and the Canadian Coast Guard (CA)
21 General Services Administration (US)
40 Global Affairs (Foreign Affairs) (CA)
41 Global Affairs (International Development) (CA)
42 Global Affairs (International Trade) (CA)
43 Health (CA)
44 Immigration, Refugees and Citizenship (CA)
45 Indigenous and Northern Affairs (CA)
46 Infrastructure and Communities (CA)
47 Innovation, Science and Economic Development (CA)
48 Justice (CA)
49 Leader of the Government in the House of Commons (CA)
22 National Aeronautics and Space Administration (US)
50 National Defence (CA)
51 National Revenue (CA)
52 Natural Resources (CA)
53 Parliament (CA)
54 President of the Queen's Privy Council for Canada (CA)
55 Prime Minister (CA)
56 Public Safety and Emergency Preparedness (CA)
57 Public Services and Procurement (CA)
58 Science (CA)
59 Small Business and Tourism (CA)
23 Smithsonian Institution (US)
24 Social Security Administration (US)
60 Transport (CA)
61 Treasury Board (CA)
26 United States Marine Corps (US)
1 U.S. Customs and Border Protection (US)
4 U.S. Department of Agriculture (US)
29 U.S. Department of Defense (US)
8 U.S. Department of Energy (US)
20 U.S. Environmental Protection Agency (US)
30 U.S. Federal Aviation Administration (US)
27 U.S. Internal Revenue Service (US)
25 U.S. Postal Service (US)
62 Veterans Affairs (CA)
cng_fill_type No
Type: string
Default: all
Options: all, B, Q, T

Return only CNG stations that provide the specified type of dispensing capability. A single type, or a comma separated list of multiple types, may be given.

Value Description
all All
B Fast-fill and time-fill
Q Fast-fill
T Time-fill
cng_psi No
Type: string
Default: all
Options: all, 2400, 3000, 3600

Return only CNG stations that provide the specified PSI pressure. A single pressure level, or a comma separated list of multiple pressure levels, may be given.

Value Description
all All
2400 2400 psi
3000 3000 psi
3600 3600 psi
cng_vehicle_class No
Type: string
Default: all
Options: all, LD, MD, HD

Return only CNG stations that can accomodate the specified vehicle class size or greater.

Value Description
all All
LD Passenger vehicles (class 1-2)
MD Medium-duty (class 3-5)
HD Heavy-duty (class 6-8)
e85_has_blender_pump No
Type: string
Default: all
Options: all, true

If true, then return only E85 stations that also have a blender pump capable of providing mid-level ethanol blends.

ev_network No
Type: string
Default: all
Options: all, AMPUP, BCHYDRO, Blink Network, CHARGELAB, ChargePoint Network, Circuit électrique, eCharge Network, Electrify America, Electrify Canada, EVCS, EV Connect, EVGATEWAY, eVgo Network, FLO, FPLEV, FCN, GE WattStation, Greenlots, IVY, LIVINGSTON, Non-Networked, OpConnect, PETROCAN, POWERFLEX, SemaCharge Network, Sun Country Highway, SWTCH, Tesla Destination, Tesla, Volta, Webasto, ZEFNET

Return only electric charging stations that belong to the given network. A single network, or a comma separated list of multiple networks, may be given.

Option Description
all All
AMPUP AmpUp
BCHYDRO BC Hydro
Blink Network Blink
CHARGELAB ChargeLab
ChargePoint Network ChargePoint
Circuit électrique Circuit électrique
eCharge Network eCharge Network
Electrify America Electrify America
Electrify Canada Electrify Canada
EVCS EV Charging Solutions
EV Connect EV Connect
EVGATEWAY evGateway
eVgo Network EVgo
FLO FLO
FPLEV FPL EVolution
FCN Francis
GE WattStation GE WattStation
Greenlots Greenlots
IVY Ivy
LIVINGSTON Livingston Energy Group
Non-Networked Non-Networked
OpConnect OpConnect
PETROCAN Petro-Canada
POWERFLEX PowerFlex
SemaCharge Network SemaConnect
Sun Country Highway Sun Country Highway
SWTCH Swtch Energy
Tesla Destination Tesla Destination
Tesla Tesla Supercharger
Volta Volta
Webasto Webasto
ZEFNET ZEF Network
ev_charging_level No
Type: string
Default: all
Options: all, 1, 2, 3, dc_fast, legacy

Return only electric charging stations that provide the given level of electric vehicle supply equipment (EVSE).

Option Description
all All
1 Level 1
2 Level 2
3 Level 3
dc_fast DC Fast
legacy Legacy chargers
ev_connector_type No
Type: string
Default: all
Options: all, NEMA1450, NEMA515, NEMA520, J1772, J1772COMBO, CHADEMO, TESLA

Return only electric charging stations that provide the given connector types.

Option Description
all All
NEMA1450 NEMA 14-50
NEMA515 NEMA 5-15
NEMA520 NEMA 5-20
J1772 J1772
J1772COMBO CCS
CHADEMO CHAdeMO
TESLA Tesla
ev_connector_type_operator No
Type: string
Default: OR
Options: OR, AND

Control how multiple connector type options passed to the ev_connector_type parameter behave. The default of OR will return stations that have any of the connectors present. Specifying AND will only return stations that have all of the connectors present.

For example, with the default OR value, then performing a query for ev_connector_type=CHADEMO,J1772COMBO will return any station that has either CHADEMO or J1772COMBO connectors present. Compare that to a query for ev_connector_type=CHADEMO,J1772COMBO​&ev_connector_type_operator=AND which will return stations that must have both CHADEMO and J1772COMBO connectors present at the same station.

hy_is_retail No
Type: string
Default: all
Options: all, true, false

Return only hydrogen stations that match the value. A single retail value, or a comma-separated list of multiple retail values, may be given.

Value Description
all Include all hydrogen stations.
true Station meets the criteria to be considered retail.
false Station does not meet the criteria to be considered retail.
lng_vehicle_class No
Type: string
Default: all
Options: all, LD, MD, HD

Return only LNG stations that can accomodate the specified vehicle class size or greater.

Value Description
all All
LD Passenger vehicles (class 1-2)
MD Medium-duty (class 3-5)
HD Heavy-duty (class 6-8)
lpg_include_secondary No
Type: string
Default: all
Options: all, false

If false, then exclude LPG stations that do not meet the criteria to be considered primary.

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.
country No
Type: string
Default: US
Options: all, US, CA

Return only stations within the given country code.

Value Description
all U.S. and Canada
US United States
CA Canada
limit No
Type: integer or string
Default: 20
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.
offset No
Type: integer
Default: 0
Minimum: 0
Offset the results found (can be used with the limit parameter to paginate the results).

Response Fields

The response is composed of the fuel stations matching the requested query. For JSON, GeoJSON, or XML formats, additional metadata is supplied in the following structure:

Field Value Description
total_results
Type: integer
How many total fuel station records match your requested query (regardless of any limit applied).
station_counts
Type: record
A record that details the total number of stations and charging outlets that match your requested query (regardless of any limit applied). See station count record fields for response details.
station_locator_url
Type: string
The URL of the Alternative Fueling Station Locator, the web application that supplies this data.
offset
Type: integer

The result offset applied to this query (if the "offset" parameter was given).

latitude Type: decimal The latitude of the given location. This either matches the "latitude" parameter passed in, or is the geocoded latitude of the "location" parameter.
longitude Type: decimal The longitude of the given location. This either matches the "longitude" parameter passed in, or is the geocoded longitude of the "location" parameter.
precision Type: record Details on the precision of the geocoded "location" parameter (if given). See precision record fields for response details.
fuel_stations
Type: array
An array of matching fuel station records returned in order of ascending distance from the given location. See fuel station record fields for response details.

Fuel Station Record Fields

The individual fuel station records are returned in order of ascending distance from the given location. Each station has the following attributes:

Field Value Description
fuel_type_code
Type: string

The type of alternative fuel the station provides. Fuel types are given as code values as described below:

Value Description
BD Biodiesel (B20 and above)
CNG Compressed Natural Gas (CNG)
ELEC Electric
E85 Ethanol (E85)
HY Hydrogen
LNG Liquefied Natural Gas (LNG)
LPG Propane (LPG)
station_name
Type: string
The name of the station.
street_address
Type: string
The street address of the station's location.
intersection_directions
Type: string
Brief additional information about how to locate the station.
city
Type: string
The city of the station's location.
state
Type: string
The two character code for the U.S. state or Canadian province/territory of the station's location.
zip
Type: string
The ZIP code (postal code) of the station's location.
plus4
Type: string
The plus-4 portion of the station's ZIP code (U.S. ZIP codes only).
country
Type: string

The two character country code of the station's location.

Value Description
US United States
CA Canada
station_phone
Type: string
The phone number of the station.
status_code
Type: string

The current status of the station, given as code values as described below:

Value Description
E Available
P Planned
T Temporarily Unavailable
expected_date
Type: date
For planned stations, the date the station is expected to open or start carrying alternative fuel. For temporarily unavailable stations, the date the station is expected to reopen. This date is estimated.
access_code
Type: string

A description of who is allowed to access the station, given as code values as described below:

Value Description
public Public
private Private
access_detail_code
Type: string

A description of other station access information, given as code values as described below:

Value Description
CALL Call ahead
KEY_AFTER_HOURS Card key after hours
KEY_ALWAYS Card key at all times
CREDIT_CARD_AFTER_HOURS Credit card after hours
CREDIT_CARD_ALWAYS Credit card at all times
FLEET Fleet customers only
GOVERNMENT Government only
LIMITED_HOURS Limited hours
RESIDENTIAL Residential
groups_with_access_code
Type: string

Deprecated: See the access_code, access_detail_code, and status_code fields for equivalent information in a more structured format. (Note: this field will remain for legacy application support)

A description of who is allowed to access the station and other station access information.

access_days_time
Type: string
Hours of operation for the station.
cards_accepted
Type: string

A space-separated list of payment methods accepted. Payment methods are given as code values as described below:

Value Description
A American Express
CREDIT Credit
Debit Debit
D Discover
M MasterCard
V Visa
Cash Cash
Checks Check
ACCOUNT_BALANCE Account Balance
ALLIANCE Alliance AutoGas
ANDROID_PAY Android Pay
APPLE_PAY Apple Pay
ARI ARI
CleanEnergy Clean Energy
Comdata Comdata
CFN Commercial Fueling Network
EFS EFS
FleetOne Fleet One
FuelMan Fuelman
GasCard GASCARD
PacificPride Pacific Pride
PHH PHH
Proprietor Proprietor Fleet Card
Speedway Speedway
SuperPass SuperPass
TCH TCH
Tchek T-Chek T-Card
Trillium Trillium
Voyager Voyager
Wright_Exp WEX
owner_type_code
Type: string

The type of organization that owns the fueling infrastructure. Owner types are given as code values as described below:

Value Description
FG Federal Government Owned
J Jointly Owned
LG Local/Municipal Government Owned
P Privately Owned
SG State/Provincial Government Owned
T Utility Owned
federal_agency
Type: record
If the station is owned by a federal agency, a record for the federal agency that owns this station. See federal agency record fields for response details.
bd_blends
Type: string
For biodiesel stations, the level of biodiesel blends the station provides.
e85_blender_pump
Type: boolean

For E85 stations, an indication of whether the station has a blender pump on site, given as a boolean:

Value Description
true In addition to E85, the station has a blender pump capable of providing mid-level ethanol blends.
false The station does not have a blender pump.
e85_other_ethanol_blends
Type: array

For E85 stations, an array of strings identifying the range(s) of blends other than E85 available at the station, given as code values described below:

Value Description
E15 E15
E20-E25 E20-E25
E30-E35 E30-E35
E40-Plus E40 and above
lpg_nozzle_types
Type: array

For LPG stations, an array of strings, identifying the type of nozzles available at the station, given as code values described below:

Value Description
ACME ACME
QUICK_CONNECT Quick-connect
lpg_primary
Type: boolean

For propane stations, the type of station, given as a boolean:

Value Description
true Primary: A propane station is considered primary because it meets the following criteria, developed based on feedback from the propane industry:
  1. The station is staffed and able to fuel vehicles during normal business hours (e.g., 8am-5pm M-F), and does not require drivers to call ahead;
  2. The station can fill vehicles at a rate of 8-12 gallons per minute or faster, or at a rate similar to filling a gasoline vehicle; and
  3. The station accepts credit cards or fleet cards.
false Secondary: The station does not meet the criteria to be considered primary.
ng_fill_type_code
Type: string
Deprecated: See cng_fill_type_code. (Note: this field will remain for legacy application support)
ng_psi
Type: string
Deprecated: See cng_psi. (Note: this field will remain for legacy application support)
ng_vehicle_class
Type: string
Deprecated: For CNG stations, see cng_vehicle_class. For LNG stations, see lng_vehicle_class. (Note: this field will remain for legacy application support)
cng_dispenser_num
Type: integer
For CNG stations, the number of CNG dispensers installed.
cng_fill_type_code
Type: string

For CNG stations, the type of dispensing capability available, given as code values as described below:

Value Description
B Fast-fill and time-fill
Q Fast-fill
T Time-fill
cng_psi
Type: string

For CNG stations, a space separated list of PSI pressures available.

Value Description
2400 2400 psi
3000 3000 psi
3600 3600 psi
cng_renewable_source
Type: string

For CNG stations, the type of renewable energy used to generate CNG on-site, given as code values as described below:

Value Description
GEOTHERMAL Geothermal
HYDRO Hydropower
LANDFILL Landfill
LIVESTOCK Livestock Operations
NONE None
SOLAR Solar
WASTEWATER Wastewater Treatment
WIND Wind
cng_total_compression
Type: integer
For CNG stations, the total compressor capacity per compressor, measured in standard cubic feet per minute (scfm).
cng_total_storage
Type: integer
For CNG stations, the total storage capacity, measured in standard cubic feet (scf).
cng_vehicle_class
Type: string

For CNG stations, the maximum vehicle size that can physically access the fueling infrastructure, given as code values as described below:

Value Description
LD Passenger vehicles (class 1-2)
MD Medium-duty (class 3-5)
HD Heavy-duty (class 6-8)

Note: This field does not take into account station capacity or other considerations.

lng_renewable_source
Type: string

For LNG stations, the type of renewable energy used to generate LNG on-site, given as code values as described below:

Value Description
GEOTHERMAL Geothermal
HYDRO Hydropower
LANDFILL Landfill
LIVESTOCK Livestock Operations
NONE None
SOLAR Solar
WASTEWATER Wastewater Treatment
WIND Wind
lng_vehicle_class
Type: string

For LNG stations, the maximum vehicle size that can physically access the fueling infrastructure, given as code values as described below:

Value Description
LD Passenger vehicles (class 1-2)
MD Medium-duty (class 3-5)
HD Heavy-duty (class 6-8)

Note: This field does not take into account station capacity or other considerations.

ev_level1_evse_num
Type: integer
For electric stations, the number of Level 1 EVSE ports.
ev_level2_evse_num
Type: integer
For electric stations, the number of Level 2 EVSE ports.
ev_dc_fast_num
Type: integer
For electric stations, the number of DC Fast EVSE ports.
ev_other_evse
Type: string
For electric stations, the number and type of additional EVSE ports, such as:
  • SP Inductive - Small paddle inductive
  • LP Inductive - Large paddle inductive
  • Avcon Conductive
ev_connector_types
Type: array

For electric stations, an array of strings identifying the connector types available at this station. Valid connector types are:

Value Description
NEMA1450 NEMA 14-50
NEMA515 NEMA 5-15
NEMA520 NEMA 5-20
J1772 J1772
J1772COMBO CCS
CHADEMO CHAdeMO
TESLA Tesla
ev_network
Type: string
For electric stations, the name of the EV charging network, if applicable.
ev_network_ids
Type: record
For electric stations, if the station belongs to an EV charging network, a record describing the network-specific IDs for this station. See EV network ID record fields for response details.
ev_network_web
Type: string
For electric stations, the EV charging network Web site, if applicable.
ev_pricing
Type: string
For electric stations, information about whether and how much users must pay to use the EVSE port.
ev_renewable_source
Type: string

For electric stations, the type of renewable energy used to generate electricity on-site, given as code values as described below:

Value Description
GEOTHERMAL Geothermal
HYDRO Hydropower
LANDFILL Landfill
LIVESTOCK Livestock Operations
NONE None
SOLAR Solar
WASTEWATER Wastewater Treatment
WIND Wind
hy_is_retail
Type: array

For hydrogen stations, whether a station offers the retail sale of hydrogen by accepting payment at the point of sale, given as code values as described below:

Value Description
true Station meets the criteria to be considered retail.
false Station does not meet the criteria to be considered retail.
hy_pressures
Type: array

For hydrogen stations, any array of strings identifying the pressures of the hydrogen available (in bar), given as code values as described below:

Value Description
350 350
700 700
hy_standards
Type: array

For hydrogen stations, any array of strings identifying which SAE International fueling protocol standard(s) the infrastructure meets, given as code values as described below:

Value Description
J2601 J2601
J2601-2 J2601-2
hy_status_link
Type: string
For hydrogen stations, a link to a website that provides up-to-date information about the current status of this hydrogen station.
geocode_status
Type: string

A rating indicating the approximate accuracy of the latitude and longitude for the station's address, given as code values as described below:

Value Description
GPS GPS
200-9 Point
200-8 Address
200-7 Intersection
200-6 Street
200-5 Neighborhood
200-5 Postal Code - Extended
200-5 Postal Code
200-4 City/Town
200-3 County
200-2 State/Province
200-1 Country
200-0 Unknown
latitude
Type: decimal
Range: -90 to 90
The latitude of the station's address (see the "Geocode Status" field for details on the latitude's accuracy).
longitude
Type: decimal
Range: -180 to 180
The longitude of the station's address (see the "Geocode Status" field for details on the longitude's accuracy).
open_date
Type: date
The date that the station began offering the fuel. Note that most propane (LPG) stations do not have open dates. Some open dates are approximate. For electric stations added to the Station Locator through automated data feeds from EV charging networks, this is the date provided by the EV charging network or the date the station appeared in the Station Locator if the EV charging network does not provide an open date. See the About the Alternative Fueling Station Data page for more information.

For planned and temporarily unavailable stations, see expected_date for the date when the station is expected to open or reopen.
date_last_confirmed
Type: date
The date the station's details were last confirmed.
updated_at
Type: datetime
The time the station's details were last updated (ISO 8601 format).
id
Type: integer
A unique identifier for this specific station.
facility_type
Type: string

The type of facility at which the station is located, given as code values as described below:

Value Description
AIRPORT Airport
ARENA Arena
AUTO_REPAIR Auto Repair Shop
BANK Bank
B_AND_B B&B
BREWERY_DISTILLERY_WINERY Brewery/Distillery/Winery
CAMPGROUND Campground
CAR_DEALER Car Dealer
CARWASH Carwash
COLLEGE_CAMPUS College Campus
CONVENIENCE_STORE Convenience Store
CONVENTION_CENTER Convention Center
COOP Co-Op
FACTORY Factory
FED_GOV Federal Government
FIRE_STATION Fire Station
FLEET_GARAGE Fleet Garage
FUEL_RESELLER Fuel Reseller
GROCERY Grocery Store
HARDWARE_STORE Hardware Store
HOSPITAL Hospital
HOTEL Hotel
INN Inn
LIBRARY Library
MIL_BASE Military Base
MOTOR_POOL Motor Pool
MULTI_UNIT_DWELLING Multi-Family Housing
MUNI_GOV Municipal Government
MUSEUM Museum
NATL_PARK National Park
OFFICE_BLDG Office Building
OTHER Other
OTHER_ENTERTAINMENT Other Entertainment
PARK Park
PARKING_GARAGE Parking Garage
PARKING_LOT Parking Lot
PAY_GARAGE Pay-Parking Garage
PAY_LOT Pay-Parking Lot
PHARMACY Pharmacy
PLACE_OF_WORSHIP Place of Worship
PRISON Prison
PUBLIC Public
REC_SPORTS_FACILITY Recreational Sports Facility
REFINERY Refinery
RENTAL_CAR_RETURN Rental Car Return
RESEARCH_FACILITY Research Facility/Laboratory
RESTAURANT Restaurant
REST_STOP Rest Stop
RETAIL Retail
RV_PARK RV Park
SCHOOL School
GAS_STATION Service/Gas Station
SHOPPING_CENTER Shopping Center
SHOPPING_MALL Shopping Mall
STADIUM Stadium
STANDALONE_STATION Standalone Station
STATE_GOV State/Provincial Government
STORAGE Storage Facility
STREET_PARKING Street Parking
TNC Transportation Network Company
TRAVEL_CENTER Travel Center
TRUCK_STOP Truck Stop
UTILITY Utility
WORKPLACE Workplace
distance
Type: decimal
The distance, in miles, from the given location and this station.
intersection_directions_fr
Type: string
Brief additional information about how to locate the station, in French, if available.
access_days_time_fr
Type: string
Hours of operation for the station, in French, if available.
bd_blends_fr
Type: string
For biodiesel stations, the level of biodiesel blends the station provides, in French, if available.
groups_with_access_code_fr
Type: string

Deprecated: See the access_code, access_detail_code, and status_code fields for equivalent information in a more structured format. (Note: this field will remain for legacy application support)

A description of who is allowed to access the station and other station access information, in French, if available.

ev_pricing_fr
Type: string
For electric stations, information about whether and how much users must pay to use the EVSE port, in French, if available.

Federal Agency Record Fields

Field Value Description
id
Type: integer
A unique identifier for the federal agency.
name
Type: string
The name of the federal agency.

EV Network ID Record Fields

Field Value Description
station
Type: string
The identifier for the station provided by the EV network, if available.
posts
Type: array
An array of strings containing the identifier(s) for the post(s) provided by the EV network, if available.
ports
Type: array
An array of strings containing the identifier(s) for the port(s) provided by EV network, if available.

Precision Record Fields

Field Value Description
name
Type: string
A textual code for the accuracy of the geocoded location.
value
Type: integer
A numeric code for the accuracy of the geocoded location. These generally match the Google Geocoding API V2 accuracy values.
types
Type: array
An array of strings describing the type of location matched. These refer to the Google Geocoding API V3 address component types.

Station Count Record Fields

Field Value Description
total
Type: integer
The total number of stations for all fuel types that matched your query. Individual stations count multiple times if the station offers more than one fuel type. For electric, the count includes charging outlets.
fuels
Type: record
The number of stations for individual fuel types that mached your query. This object's structure provides a total field under each fuel key. For electric, the count includes charging outlets. For electric, there is a further stations.total field that returns the number of fuel station records matched, not counting charging outlets.

Examples

JSON Output Format

GET /api/alt-fuel-stations/v1/nearest.json?api_key=DEMO_KEY&location=1617+Cole+Blvd+Golden+CO&fuel_type=ELEC&limit=1
{
  "latitude": 39.74311,
  "longitude": -105.152332,
  "location_country": "US",
  "precision": {
    "value": 9,
    "name": "premise",
    "types": [
      "premise"
    ]
  },
  "station_locator_url": "http://www.afdc.energy.gov/afdc/locator/stations/",
  "total_results": 34,
  "station_counts": {
    "total": 106,
    "fuels": {
      "BD": {
        "total": 0
      },
      "E85": {
        "total": 0
      },
      "ELEC": {
        "total": 106,
        "stations": {
          "total": 34
        }
      },
      "HY": {
        "total": 0
      },
      "LNG": {
        "total": 0
      },
      "CNG": {
        "total": 0
      },
      "LPG": {
        "total": 0
      }
    }
  },
  "offset": 0,
  "fuel_stations": [
    {
      "access_code": "public",
      "access_days_time": "MO: 12:00am-12:00am; TU: 12:00am-12:00am; WE: 12:00am-12:00am; TH: 12:00am-12:00am; FR: 12:00am-12:00am; SA: 12:00am-12:00am; SU: 12:00am-12:00am",
      "access_detail_code": null,
      "cards_accepted": null,
      "date_last_confirmed": "2019-04-02",
      "expected_date": null,
      "fuel_type_code": "ELEC",
      "groups_with_access_code": "Public",
      "id": 118375,
      "open_date": null,
      "owner_type_code": null,
      "status_code": "E",
      "station_name": "Denver West Bldg 17",
      "station_phone": "800-663-5633",
      "updated_at": "2019-04-02T09:03:50Z",
      "facility_type": null,
      "geocode_status": "GPS",
      "latitude": 39.744703073211,
      "longitude": -105.15229735145,
      "city": "Lakewood",
      "intersection_directions": "The stations are located in the back of the building on the I-70 side.",
      "plus4": null,
      "state": "CO",
      "street_address": "1626 Cole Boulevard",
      "zip": "80401",
      "country": "US",
      "bd_blends": null,
      "cng_dispenser_num": null,
      "cng_fill_type_code": null,
      "cng_psi": null,
      "cng_renewable_source": null,
      "cng_total_compression": null,
      "cng_total_storage": null,
      "cng_vehicle_class": null,
      "e85_blender_pump": null,
      "e85_other_ethanol_blends": null,
      "ev_connector_types": [
        "J1772"
      ],
      "ev_dc_fast_num": null,
      "ev_level1_evse_num": null,
      "ev_level2_evse_num": 2,
      "ev_network": "SemaCharge Network",
      "ev_network_web": "http://www.semacharge.com/",
      "ev_other_evse": null,
      "ev_pricing": "FREE",
      "hy_is_retail": null,
      "hy_pressures": null,
      "hy_standards": null,
      "hy_status_link": null,
      "lng_renewable_source": null,
      "lng_vehicle_class": null,
      "lpg_primary": null,
      "lpg_nozzle_types": null,
      "ng_fill_type_code": null,
      "ng_psi": null,
      "ng_vehicle_class": null,
      "access_days_time_fr": null,
      "intersection_directions_fr": null,
      "bd_blends_fr": null,
      "groups_with_access_code_fr": "Public",
      "ev_pricing_fr": null,
      "ev_network_ids": {
        "station": [
          "1309"
        ],
        "posts": [
          "2976",
          "3633"
        ]
      },
      "distance": 0.10992,
      "distance_km": 0.1769
    }
  ]
}

GeoJSON Output Format

GET /api/alt-fuel-stations/v1/nearest.geojson?api_key=DEMO_KEY&location=1617+Cole+Blvd+Golden+CO&fuel_type=ELEC&limit=1
{
  "type": "FeatureCollection",
  "metadata": {
    "latitude": 39.74311,
    "longitude": -105.152332,
    "location_country": "US",
    "precision": {
      "value": 9,
      "name": "premise",
      "types": [
          "premise"
      ]
    },
    "station_locator_url": "http://www.afdc.energy.gov/afdc/locator/stations/",
    "total_results": 32,
    "station_counts": {
      "total": 186,
      "fuels": {
        "BD": {
          "total": 0
        },
        "E85": {
          "total": 0
        },
        "ELEC": {
          "total": 186,
          "stations": {
              "total": 32
          }
        },
        "HY": {
          "total": 0
        },
        "LNG": {
          "total": 0
        },
        "CNG": {
          "total": 0
        },
        "LPG": {
          "total": 0
        }
      }
    },
    "offset": 0
  },
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -105.154583,
          39.733102
        ]
      },
      "properties": {
        "access_code": "public",
        "access_days_time": "24 hours daily",
        "access_detail_code": null,
        "cards_accepted": null,
        "date_last_confirmed": "2020-02-04",
        "expected_date": null,
        "fuel_type_code": "ELEC",
        "groups_with_access_code": "Public",
        "id": 124975,
        "open_date": null,
        "owner_type_code": null,
        "status_code": "E",
        "station_name": "Colorado Mills Mall",
        "station_phone": "833-632-2778",
        "updated_at": "2020-02-04T11:06:07Z",
        "facility_type": null,
        "geocode_status": "GPS",
        "city": "Lakewood",
        "intersection_directions": null,
        "plus4": null,
        "state": "CO",
        "street_address": "14500 W. Colfax Ave",
        "zip": "80401",
        "country": "US",
        "bd_blends": null,
        "cng_dispenser_num": null,
        "cng_fill_type_code": null,
        "cng_psi": null,
        "cng_renewable_source": null,
        "cng_total_compression": null,
        "cng_total_storage": null,
        "cng_vehicle_class": null,
        "e85_blender_pump": null,
        "e85_other_ethanol_blends": null,
        "ev_connector_types": [
          "CHADEMO",
          "J1772COMBO"
        ],
        "ev_dc_fast_num": 6,
        "ev_level1_evse_num": null,
        "ev_level2_evse_num": null,
        "ev_network": "Electrify America",
        "ev_network_web": "https://www.electrifyamerica.com/",
        "ev_other_evse": null,
        "ev_pricing": null,
        "ev_renewable_source": null,
        "hy_is_retail": null,
        "hy_pressures": null,
        "hy_standards": null,
        "hy_status_link": null,
        "lng_renewable_source": null,
        "lng_vehicle_class": null,
        "lpg_primary": null,
        "lpg_nozzle_types": null,
        "ng_fill_type_code": null,
        "ng_psi": null,
        "ng_vehicle_class": null,
        "access_days_time_fr": null,
        "intersection_directions_fr": null,
        "bd_blends_fr": null,
        "groups_with_access_code_fr": "Public",
        "ev_pricing_fr": null,
        "ev_network_ids": {
          "station": [
            "67"
          ],
          "posts": [
            "100125-01",
            "100125-02",
            "100125-03",
            "100125-04",
            "100125-05",
            "100125-06"
          ]
        },
        "distance": 0.70079,
        "distance_km": 1.12781
      }
    }
  ]
}

XML Output Format

GET /api/alt-fuel-stations/v1/nearest.xml?api_key=DEMO_KEY&location=1617+Cole+Blvd+Golden+CO&fuel_type=ELEC&limit=1
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <latitude>39.74311</latitude>
  <longitude>-105.152332</longitude>
  <location-country>US</location-country>
  <precision>
    <value type="integer">9</value>
    <name>premise</name>
    <types type="array">
      <type>premise</type>
    </types>
  </precision>
  <station-locator-url>http://www.afdc.energy.gov/afdc/locator/stations/</station-locator-url>
  <total-results>34</total-results>
  <station-counts>
    <total>106</total>
    <fuels>
      <BD>
        <total>0</total>
      </BD>
      <E85>
        <total>0</total>
      </E85>
      <ELEC>
        <total>106</total>
        <stations>
          <total>34</total>
        </stations>
      </ELEC>
      <HY>
        <total>0</total>
      </HY>
      <LNG>
        <total>0</total>
      </LNG>
      <CNG>
        <total>0</total>
      </CNG>
      <LPG>
        <total>0</total>
      </LPG>
    </fuels>
  </station-counts>
  <offset>0</offset>
  <fuel-stations type="array">
    <fuel-station>
      <access-code>public</access-code>
      <access-days-time>MO: 12:00am-12:00am; TU: 12:00am-12:00am; WE: 12:00am-12:00am; TH: 12:00am-12:00am; FR: 12:00am-12:00am; SA: 12:00am-12:00am; SU: 12:00am-12:00am</access-days-time>
      <access-detail-code nil="true"/>
      <cards-accepted nil="true"/>
      <date-last-confirmed>2019-04-02</date-last-confirmed>
      <expected-date nil="true"/>
      <fuel-type-code>ELEC</fuel-type-code>
      <groups-with-access-code>Public</groups-with-access-code>
      <id>118375</id>
      <open-date nil="true"/>
      <owner-type-code nil="true"/>
      <status-code>E</status-code>
      <station-name>Denver West Bldg 17</station-name>
      <station-phone>800-663-5633</station-phone>
      <updated-at>2019-04-02 09:03:50 UTC</updated-at>
      <facility-type nil="true"/>
      <geocode-status>GPS</geocode-status>
      <latitude>39.744703073211</latitude>
      <longitude>-105.15229735145</longitude>
      <city>Lakewood</city>
      <intersection-directions>The stations are located in the back of the building on the I-70 side.</intersection-directions>
      <plus4 nil="true"/>
      <state>CO</state>
      <street-address>1626 Cole Boulevard</street-address>
      <zip>80401</zip>
      <country>US</country>
      <bd-blends nil="true"/>
      <cng-dispenser-num nil="true"/>
      <cng-fill-type-code nil="true"/>
      <cng-psi nil="true"/>
      <cng-renewable-source nil="true"/>
      <cng-total-compression nil="true"/>
      <cng-total-storage nil="true"/>
      <cng-vehicle-class nil="true"/>
      <e85-blender-pump nil="true"/>
      <e85-other-ethanol-blends nil="true"/>
      <ev-connector-types>
        <ev-connector-type>J1772</ev-connector-type>
      </ev-connector-types>
      <ev-dc-fast-num nil="true"/>
      <ev-level1-evse-num nil="true"/>
      <ev-level2-evse-num>2</ev-level2-evse-num>
      <ev-network>SemaCharge Network</ev-network>
      <ev-network-web>http://www.semacharge.com/</ev-network-web>
      <ev-other-evse nil="true"/>
      <ev-pricing>FREE</ev-pricing>
      <hy-is-retail nil="true"/>
      <hy-pressures nil="true"/>
      <hy-standards nil="true"/>
      <hy-status-link nil="true"/>
      <lng-renewable-source nil="true"/>
      <lng-vehicle-class nil="true"/>
      <lpg-primary nil="true"/>
      <lpg-nozzle-types nil="true"/>
      <ng-fill-type-code nil="true"/>
      <ng-psi nil="true"/>
      <ng-vehicle-class nil="true"/>
      <access-days-time-fr nil="true"/>
      <intersection-directions-fr nil="true"/>
      <bd-blends-fr nil="true"/>
      <groups-with-access-code-fr>Public</groups-with-access-code-fr>
      <ev-pricing-fr nil="true"/>
      <ev-network-ids>
        <station>
          <station>1309</station>
        </station>
        <posts>
          <post>2976</post>
          <post>3633</post>
        </posts>
      </ev-network-ids>
      <distance>0.10992</distance>
      <distance-km>0.1769</distance-km>
    </fuel-station>
  </fuel-stations>
</response>

KML Output Format

GET /api/alt-fuel-stations/v1/nearest.kml?api_key=DEMO_KEY&location=1617+Cole+Blvd+Golden+CO&fuel_type=ELEC&limit=1
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <Placemark>
      <name>Colorado Mills Mall</name>
      <address>14500 W. Colfax Ave</address>
      <phoneNumber>833-632-2778</phoneNumber>
      <Point>
        <coordinates>-105.154583,39.733102</coordinates>
      </Point>
      <ExtendedData>
        <Data name="access_code">
          <Value>public</Value>
        </Data>
        <Data name="access_days_time">
          <Value>24 hours daily</Value>
        </Data>
        <Data name="date_last_confirmed">
          <Value>2020-02-04</Value>
        </Data>
        <Data name="fuel_type_code">
          <Value>ELEC</Value>
        </Data>
        <Data name="groups_with_access_code">
          <Value>Public</Value>
        </Data>
        <Data name="id">
          <Value>124975</Value>
        </Data>
        <Data name="status_code">
          <Value>E</Value>
        </Data>
        <Data name="updated_at">
          <Value>2020-02-04 11:06:07 UTC</Value>
        </Data>
        <Data name="geocode_status">
          <Value>GPS</Value>
        </Data>
        <Data name="city">
          <Value>Lakewood</Value>
        </Data>
        <Data name="state">
          <Value>CO</Value>
        </Data>
        <Data name="zip">
          <Value>80401</Value>
        </Data>
        <Data name="country">
          <Value>US</Value>
        </Data>
        <Data name="ev_connector_types">
          <Value>["CHADEMO", "J1772COMBO"]</Value>
        </Data>
        <Data name="ev_dc_fast_num">
          <Value>6</Value>
        </Data>
        <Data name="ev_network">
          <Value>Electrify America</Value>
        </Data>
        <Data name="ev_network_web">
          <Value>https://www.electrifyamerica.com/</Value>
        </Data>
        <Data name="groups_with_access_code_fr">
          <Value>Public</Value>
        </Data>
        <Data name="ev_network_ids_station">
          <Value>["67"]</Value>
        </Data>
        <Data name="ev_network_ids_posts">
          <Value>["100125-01", "100125-02", "100125-03", "100125-04", "100125-05", "100125-06"]</Value>
        </Data>
        <Data name="distance">
          <Value>0.70079</Value>
        </Data>
        <Data name="distance_km">
          <Value>1.12781</Value>
        </Data>
      </ExtendedData>
    </Placemark>
  </Document>
</kml>

CSV Output Format

GET /api/alt-fuel-stations/v1/nearest.csv?api_key=DEMO_KEY&location=1617+Cole+Blvd+Golden+CO&fuel_type=ELEC&limit=1
Fuel Type Code,Station Name,Street Address,Intersection Directions,City,State,ZIP,Plus4,Station Phone,Status Code,Expected Date,Groups With Access Code,Access Days Time,Cards Accepted,BD Blends,NG Fill Type Code,NG PSI,EV Level1 EVSE Num,EV Level2 EVSE Num,EV DC Fast Count,EV Other Info,EV Network,EV Network Web,Geocode Status,Latitude,Longitude,Date Last Confirmed,ID,Distance,Updated At,Owner Type Code,Federal Agency ID,Federal Agency Name,Open Date,Hydrogen Status Link,NG Vehicle Class,LPG Primary,E85 Blender Pump,EV Connector Types,Country,Distance (km),Intersection Directions (French),Access Days Time (French),BD Blends (French),Groups With Access Code (French),Hydrogen Is Retail,Access Code,Access Detail Code,Federal Agency Code,Facility Type,CNG Dispenser Num,CNG On-Site Renewable Source,CNG Total Compression Capacity,CNG Storage Capacity,LNG On-Site Renewable Source,E85 Other Ethanol Blends,EV Pricing,EV Pricing (French),LPG Nozzle Types,Hydrogen Pressures,Hydrogen Standards,CNG Fill Type Code,CNG PSI,CNG Vehicle Class,LNG Vehicle Class
ELEC,Denver West Bldg 17,1626 Cole Boulevard,The stations are located in the back of the building on the I-70 side.,Lakewood,CO,80401,,800-663-5633,E,,Public,MO: 12:00am-12:00am; TU: 12:00am-12:00am; WE: 12:00am-12:00am; TH: 12:00am-12:00am; FR: 12:00am-12:00am; SA: 12:00am-12:00am; SU: 12:00am-12:00am,,,,,,2,,,SemaCharge Network,http://www.semacharge.com/,GPS,39.744703073211,-105.15229735145,2019-04-02,118375,0.10992,2019-04-02 09:03:50 UTC,,,,,,,,,J1772,US,0.1769,,,,Public,,public,,,,,,,,,,FREE,,,,,,,,

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.
Help Improve this Content