Developer Network NREL NREL Developer Network
Documentation » Transportation » Alternative Fuel Stations » GET /api/alt-fuel-stations/v1

GET /api/alt-fuel-stations/v1

Return a full list of alternative fuel stations that match your query.

Request URL

GET http://developer.nrel.gov/api/alt-fuel-stations/v1.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

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.

status No
Type: string
Default: all
Options: all, E, P

Return stations that match the given status. A single status, or a comma-separated list of multiple statuses, may be given.

Option Description
all Include both open and planned stations.
E Open: The station is open and carries alternative fuel.
P Planned: The station is not yet open, but plans to carry alternative fuel in the future, or the station is temporarily out of service.
access No
Type: string
Default: all
Options: all, public, private

Return stations with the given access type.

fuel_type No
Type: string
Default: all
Options: all, BD, CNG, E85, ELEC, HY, LNGLPG

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.

Option Description
all Include all fuel types
BD Biodiesel (B20 and above)
CNG Compressed Natural Gas
E85 Ethanol (E85)
ELEC Electric
HY Hydrogen
LNG Liquefied Natural Gas
LPG Liquefied Petroleum Gas (Propane)
cards_accepted No
Type: string
Default: all
Options: all, A, D, M, V, Cash, Checks, CFN, CleanEnergy, FuelMan, GasCard, PHH, 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 Include all payment types
A American Express
D Discover
M MasterCard
V Visa
Cash  
Checks  
CFN  
CleanEnergy  
FuelMan  
GasCard  
PHH PHH Services
Wright_Exp Wright Express
owner_type No
Type: string
Default: all
Options: all, FG, 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 Include all owner types
P Privately owned
T Utility owned
FG Federal government owned
LG Local government owned
SG State government owned
J Jointly owned (combination of owner types)
federal_agency_id No
Type: integer
Default: all
Options: all, (see table to right for IDs)

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 Include all stations, regardless of federal agency owner
3 Defense Agencies
4 U.S. Department of Agriculture
5 Department of Air Force
6 Department of Army
7 Department of Commerce
8 U.S. Department of Energy
9 Department of Health and Human Services
10 Department of Homeland Security
12 Department of Justice
14 Department of Navy
16 Department of the Interior
17 U.S. Department of Transportation
19 Department of Veterans Affairs
20 U.S. Environmental Protection Agency
22 National Aeronautics and Space Administration
23 Smithsonian Institution
24 Social Security Administration
25 U.S. Postal Service
26 United States Marine Corps
ev_network No
Type: string
Default: all
Options: all, Blink Network, ChargeNet, ChargePoint Network, eVgo Network, EVSE LLC WebNet, RechargeAccess, Rideshare Online, Shorepower

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

Option
all
Blink Network
ChargeNet
ChargePoint Network
eVgo Network
EVSE LLC WebNet
RechargeAccess
Rideshare Online
Shorepower
ev_charging_level No
Type: string
Default: all
Options: all, 1, 2, dc_fast

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

Option Description
all Include all charging levels
1 Level 1 EVSE (standard 110V outlet)
2 Level 2 EVSE (J1772 connector)
dc_fast DC Fast Charging
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.
limit No
Type: integer
Default: None
Minimum: 1
The maximum number of results to return. Note: Since results are returned in no specific order, this has limited use, other than for testing purposes.

Response Fields

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

Field Value Description
total_results
Type: integer

How many total stations match your requested query (regardless of any "limit" applied).

station_locator_url
Type: string

The URL of the Alternative Fueling Station Locator, the web application that supplies this data.

fuel_stations
Type: array
An array of matching fuel station records returned in no specific order. See fuel station record fields for response details.

Fuel Station Record Fields

The individual fuel station records are returned in no specific order. 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
E85 Ethanol (E85)
ELEC Electric
HY Hydrogen
LNG Liquefied Natural Gas
LPG Liquefied Petroleum Gas (Propane)
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 U.S. state or Canadian province code 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).
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 Open: The station is open.
P Planned: The station is not yet open, but plans to carry alternative fuel in the future, or the station is temporarily out of service. See the "Expected Date" field for an anticipated open date.
expected_date
Type: date
For planned stations, the date the station is expected to open or start carrying alternative fuel.
groups_with_access_code
Type: string
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
D Discover
M MasterCard
V VISA
Cash  
Checks  
CFN  
CleanEnergy  
FuelMan  
GasCard  
PHH PHH Services
Voyager  
Wright_Exp Wright Express
owner_type_code
Type: string

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

Option Description
P Privately owned
T Utility owned
FG Federal government owned
LG Local government owned
SG State government owned
J Jointly owned (combination of owner types)
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.
ng_fill_type_code
Type: string

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

Value Description
Q Quick fill
T Timed fill
B Both: quick fill and timed fill
ng_psi
Type: string
For CNG stations, a space separated list of PSI pressures available.
ev_level1_evse_num
Type: integer
For electric stations, the number of Level 1 EVSE (standard 110V outlet).
ev_level2_evse_num
Type: integer
For electric stations, the number of Level 2 EVSE (J1772 connector).
ev_dc_fast_num
Type: integer
For electric stations, the number of DC Fast Chargers.
ev_other_evse
Type: string
For electric stations, the number and type of additional EVSE, such as:
  • SP Inductive - Small paddle inductive
  • LP Inductive - Large paddle inductive
  • Avcon Conductive
ev_network
Type: string
For electric stations, the name of the EVSE network, if applicable.
ev_network_web
Type: string
For electric stations, the EVSE network Web site, if applicable.
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 The location is from a real GPS readout at the station.
200-9 Premise (building name, property name, shopping center, etc.) level accuracy.
200-8 Address level accuracy.
200-7 Intersection level accuracy.
200-6 Street level accuracy.
200-5 ZIP code (postal code) level accuracy.
200-4 Town (city, village) level accuracy.
200-3 Sub-region (county, municipality, etc.) level accuracy.
200-2 Region (state, province, prefecture, etc.) level accuracy.
200-1 Country level accuracy.
200-0 Unknown accuracy.
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).
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.

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.

Examples

JSON Output Format

GET /api/alt-fuel-stations/v1.json?api_key=DEMO_KEY&fuel_type=E85,ELEC&state=CA&limit=2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
{
  "station_locator_url":"http://www.afdc.energy.gov/afdc/locator/stations/",
  "total_results":844,
  "fuel_stations":[
    {
      "access_days_time":"Site-specific ID and payment card required",
      "bd_blends":null,
      "cards_accepted":null,
      "city":"Livermore",
      "date_last_confirmed":"2011-09-30",
      "expected_date":null,
      "fuel_type_code":"E85",
      "geocode_status":"GPS",
      "groups_with_access_code":"Private - government only",
      "intersection_directions":null,
      "latitude":37.681216,
      "longitude":-121.698978,
      "owner_type_code":"FG",
      "plus4":"9234",
      "station_name":"Lawrence Livermore National Laboratory",
      "station_phone":null,
      "status_code":"E",
      "street_address":"7000 East Ave",
      "zip":"94551",
      "state":"CA",
      "ng_fill_type_code":null,
      "ng_psi":null,
      "ev_level1_evse_num":null,
      "ev_level2_evse_num":null,
      "ev_dc_fast_num":null,
      "ev_other_evse":null,
      "ev_network":null,
      "ev_network_web":null,
      "id":26019,
      "updated_at":"2011-10-11T16:57:52Z",
      "federal_agency":{
        "id":8,
        "name":"U.S. Department of Energy"
      }
    },
    {
      "access_days_time":"24 hours daily",
      "bd_blends":null,
      "cards_accepted":null,
      "city":"Santa Cruz",
      "date_last_confirmed":"2011-12-31",
      "expected_date":null,
      "fuel_type_code":"ELEC",
      "geocode_status":"200-8",
      "groups_with_access_code":"Public - see hours",
      "intersection_directions":null,
      "latitude":36.9736835,
      "longitude":-122.024717,
      "owner_type_code":"P",
      "plus4":null,
      "station_name":"Santa Cruz Garage",
      "station_phone":null,
      "status_code":"E",
      "street_address":"601 Front St",
      "zip":"95061",
      "state":"CA",
      "ng_fill_type_code":null,
      "ng_psi":null,
      "ev_level1_evse_num":3,
      "ev_level2_evse_num":null,
      "ev_dc_fast_num":null,
      "ev_other_evse":"2 SP Inductive  2 Avcon Conductive",
      "ev_network":null,
      "ev_network_web":null,
      "id":21794,
      "updated_at":"2012-01-13T20:51:11Z"
    }
  ]
}

XML Output Format

GET /api/alt-fuel-stations/v1.xml?api_key=DEMO_KEY&fuel_type=E85,ELEC&state=CA&limit=2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <station-locator-url>http://www.afdc.energy.gov/afdc/locator/stations/</station-locator-url>
  <total-results>844</total-results>
  <fuel-stations type="array">
    <fuel-station>
      <fuel-type-code>E85</fuel-type-code>
      <station-name>Lawrence Livermore National Laboratory</station-name>
      <street-address>7000 East Ave</street-address>
      <intersection-directions nil="true"/>
      <city>Livermore</city>
      <zip>94551</zip>
      <plus4>9234</plus4>
      <station-phone nil="true"/>
      <status-code>E</status-code>
      <expected-date nil="true"/>
      <groups-with-access-code>Private - government only</groups-with-access-code>
      <access-days-time>Site-specific ID and payment card required</access-days-time>
      <cards-accepted nil="true"/>
      <bd-blends nil="true"/>
      <geocode-status>GPS</geocode-status>
      <latitude>37.681216</latitude>
      <longitude>-121.698978</longitude>
      <date-last-confirmed>2011-09-30</date-last-confirmed>
      <owner-type-code>FG</owner-type-code>
      <state>CA</state>
      <ng-fill-type-code nil="true"/>
      <ng-psi nil="true"/>
      <ev-level1-evse-num nil="true"/>
      <ev-level2-evse-num nil="true"/>
      <ev-dc-fast-num nil="true"/>
      <ev-other-evse nil="true"/>
      <ev-network nil="true"/>
      <ev-network-web nil="true"/>
      <id>26019</id>
      <updated-at>2011-10-11T16:57:52Z</updated-at>
      <federal-agency>
        <id>8</id>
        <name>U.S. Department of Energy</name>
      </federal-agency>
    </fuel-station>
    <fuel-station>
      <fuel-type-code>ELEC</fuel-type-code>
      <station-name>Santa Cruz Garage</station-name>
      <street-address>601 Front St</street-address>
      <intersection-directions nil="true"/>
      <city>Santa Cruz</city>
      <zip>95061</zip>
      <plus4 nil="true"/>
      <station-phone nil="true"/>
      <status-code>E</status-code>
      <expected-date nil="true"/>
      <groups-with-access-code>Public - see hours</groups-with-access-code>
      <access-days-time>24 hours daily</access-days-time>
      <cards-accepted nil="true"/>
      <bd-blends nil="true"/>
      <geocode-status>200-8</geocode-status>
      <latitude>36.9736835</latitude>
      <longitude>-122.024717</longitude>
      <date-last-confirmed>2011-12-31</date-last-confirmed>
      <owner-type-code>P</owner-type-code>
      <state>CA</state>
      <ng-fill-type-code nil="true"/>
      <ng-psi nil="true"/>
      <ev-level1-evse-num>3</ev-level1-evse-num>
      <ev-level2-evse-num nil="true"/>
      <ev-dc-fast-num nil="true"/>
      <ev-other-evse>2 SP Inductive  2 Avcon Conductive</ev-other-evse>
      <ev-network nil="true"/>
      <ev-network-web nil="true"/>
      <id>21794</id>
      <updated-at>2012-01-13T20:51:11Z</updated-at>
    </fuel-station>
  </fuel-stations>
</response>

CSV Output Format

GET /api/alt-fuel-stations/v1.csv?api_key=DEMO_KEY&fuel_type=E85,ELEC&state=CA&limit=2
1
2
3
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,Updated At,Owner Type Code,Federal Agency ID,Federal Agency Name
E85,Lawrence Livermore National Laboratory,7000 East Ave,,Livermore,CA,94551,9234,,E,,Private - government only,Site-specific ID and payment card required,,,,,,,,,,,GPS,37.681216,-121.698978,2011-09-30,26019,2011-10-11 16:57:52 UTC,FG,8,U.S. Department of Energy
ELEC,Santa Cruz Garage,601 Front St,,Santa Cruz,CA,95061,,,E,,Public - see hours,24 hours daily,,,,,3,,,2 SP Inductive  2 Avcon Conductive,,,200-8,36.9736835,-122.024717,2011-12-31,21794,2012-01-13 20:51:11 UTC,P,,

Rate Limits

Standard rate limits apply. No more than 1,000 requests may be made in any hour. No more than 10,000 requests may be made in any day.

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.

Comments

blog comments powered by Disqus