openapi: 3.2.0 info: title: Here Fuel stations API version: '1.0' description: 'Operations tagged Fuel stations across 2 of this provider''s published API definitions: here-fuel-prices-v2-openapi.yml, here-fuel-prices-v3-openapi.yml. Each path carries the servers of the definition it was published in.' servers: - url: https://fuel-v2.cc.api.here.com description: Production environment URL - url: https://fuel-v2.cit.cc.api.here.com description: Staging environment URL - url: https://fuel.hereapi.com/v3 description: Production environment URL tags: - name: Fuel stations description: Search fuel stations paths: /fuel/stations: get: tags: - Fuel stations summary: Fuel stations search description: Retrieves fuel stations within geospatial area operationId: Fuel Prices API v2 fuelStationsSearch parameters: - name: prox in: query description: A circular search area defined by the latitude and longitude of its center (compliant with WGS 84) and an integer representing the radius of the area in meters, all separated by commas. required: false schema: type: string - name: bbox in: query description: Bounding box defined by the latitude and longitude (compliant with WGS 84) of its top left and bottom right corners. The top left and bottom right pairs are separated by a semicolon and the latitude and longitude pairs are separated by commas. required: false schema: type: string - name: corridor in: query description: A strip defined as a semicolon-separated list of points (pairs of comma-separated latitude and longitude WGS 84 required: false schema: type: string - name: corridorwidth in: query description: The width of the corridor in meters. This parameter takes effect only if corridor are included in the request. required: false schema: type: integer format: int32 default: 5000 - name: fueltype in: query description: 'An integer identifying the fuel type or category included in the response. Available types (all can be retrieved from `/fuel/fueltypes` endpoint): |Fuel type ID|Name| |---|---| |-1|All Truck Diesel| |-2|All Diesel |-3|All Petrol" |-4|All LPG| |-5|All CNG| |-6|All Ethanol| |-7|All Methanol| |-8|All Additives| |1|Diesel| |2|Regular| |3|Mid-grade| |4|Premium| |5|E-85| |6|Bio-Diesel| |7|Bio-Diesel 10| |8|Bio-Diesel 15| |9|Bio-Diesel 20| |10|Diesel plus| |11|Truck-Diesel| |12|Red-Diesel| |13|E-10| |14|LPG-GLP| |15|LRP| |16|Methane| |17|Midgrade-self| |18|Diesel-self| |19|AdBlue| |20|V-Power-95| |21|CNG| |22|Ethanol| |23|Ethanol w. additives| |24|GPL self| |25|Premium self| |26|Leaded Four| |27|Super Unleaded| |28|Super Unleaded Ultimate| |29|Diesel-plus self| |30|Methanol self| |31|Mid-grade E10| |32|Super-Diesel| |33|Unleaded E5| |34|Unleaded E25| |35|Unleaded| |36|Unleaded 91| |37|Unleaded 93| |38|Unleaded 97| |39|Unleaded 99| |40|Unleaded 100| |41|Unleaded 102| |42|Methanol| |43|Unleaded E10| |44|Shell V-Power Racing| |45|Shell V-Power 100| |46|Shell V-Power Diesel| |47|Aral Ultimate 102| |48|Aral Ultimate Diesel| |49|BP Ultimate Super| |50|BP Ultimate Diesel| |51|Blue One 95| |52|Diesel Cleanline| |53|Super E5| |54|Super E10| |55|Premium Diesel| |56|Unleaded 95| |57|Simple gasoline| |58|Simple diesel| |59|Super Unleaded 98| |60|Unleaded 98| |61|Premium gasoline| |62|Synergy Supreme+ Diesel| |63|Supreme Diesel| |64|Unleaded 92| |65|Unleaded 80| |66|Super Unleaded 95| |67|Super Unleaded 92| |68|LNG| |69|Super E5 Premium| |70|Heating oil| |71|AdBlue Car| |72|AdBlue Truck| |73|Hydrotreated vegetable oil| |74|Hydrogen| |75|E-85 cash (US ONLY)| |76|Diesel cash (US ONLY)| |77|Mid-grade cash (US ONLY)| |78|Regular cash (US ONLY)| |79|Regular clear - without ethanol (US ONLY)| |80|Premium cash (US ONLY)| |81|Two stroke petrol| |82|Unleaded 87| |83|Unleaded 89| |84|GTL - Gas to liquid fuel| |85|HVO 30 - Diesel with 30% of hydrotreated vegetable oil| |86|Premium Diesel cash| |87|Red-Diesel cash| |88|Bio-Diesel 20 cash| |89|Super E15| |90|Heating oil cash| |91|AdBlue cash| |92|AdBlue Truck cash| |93|Bio-Diesel cash| |94|Bio-Diesel 10 cash| |95|LPG-GLP cash| |96|CNG cash| |97|Truck Diesel cash| ' required: false schema: type: integer format: int32 - name: maxresults in: query description: The maximum number of results a response can contain. This parameter together with the offset parameter in the query and HasMore in the response can be used for pagination. required: false schema: type: integer format: int32 default: 50 - name: offset in: query description: A value specifying the index of the first result. This parameter together with the maxresults parameter in the query and HasMore in the response can be used for pagination. required: false schema: type: integer format: int32 default: 0 - name: sortkey in: query description: Criteria for sorting a list of search results. required: false schema: type: string enum: - price - distance - name: sortorder in: query description: The sort order of the results. required: false schema: type: string enum: - asc - desc - name: brand in: query description: '| List of brands to filter the stations in the response. The brand names in the list are separated with commas. The result will contain only the stations that have brand field that match to the one of those specified in the list. The matching is caseinsensitive. List of brands can be retireved using `/fuel/fuelbrands` endpoint ' required: false explode: false schema: type: array items: type: string - name: showallstations in: query description: Also fuel stations with unknown price or fuel type information will be included in the result set. This parameter works together with fueltype parameter. required: false schema: type: boolean default: false - name: imagedimensions in: query description: Request specific maximum size of brand icon image to match UI and bandwidth requirements The format is that specifies dimension for a scaled image by providing either the desired width, desired heigh, or both example: w20-h20 required: false schema: type: string - $ref: '#/components/parameters/X-Request-Id' responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsResult' application/xml: schema: $ref: '#/components/schemas/FuelStationsResult' '400': description: Invalid parameters were provided headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' application/xml: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] servers: - url: https://fuel-v2.cc.api.here.com description: Production environment URL - url: https://fuel-v2.cit.cc.api.here.com description: Staging environment URL /fuel/stations/{id}: get: tags: - Fuel stations summary: Fuel station details description: Retrieves fuel station details for given station id operationId: Fuel Prices API v2 fuelStationDetail parameters: - name: id in: path description: Fuel station id required: true schema: type: string - $ref: '#/components/parameters/X-Request-Id' responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsResult' application/xml: schema: $ref: '#/components/schemas/FuelStationsResult' '400': description: Invalid parameters were provided headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' application/xml: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '404': description: Fuel station with given id does not exist headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' application/xml: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/Error500Response' security: - Bearer: [] servers: - url: https://fuel-v2.cc.api.here.com description: Production environment URL - url: https://fuel-v2.cit.cc.api.here.com description: Staging environment URL /stations: get: tags: - Fuel stations summary: Fuel stations search description: Retrieves fuel stations within geospatial area operationId: Fuel Prices API v3 fuelStationsSearch parameters: - $ref: '#/components/parameters/X-Request-Id' - $ref: '#/components/parameters/in' - $ref: '#/components/parameters/fuelType' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/sort' - $ref: '#/components/parameters/brands' - $ref: '#/components/parameters/returnAllStations' - $ref: '#/components/parameters/iconSize' responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsResult_2' examples: proximitySearchExample: $ref: '#/components/examples/FuelStationsSearchExample' '400': description: Invalid parameters were provided headers: X-Correlation-ID: $ref: '#/components/headers/X-Correlation-Id' X-Request-ID: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: badRequestMissingMandatoryParameterExample: $ref: '#/components/examples/BadRequestStationsExample' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] - ApiKey: [] post: tags: - Fuel stations summary: Fuel stations along the route search description: Retrieves fuel stations along the route operationId: Fuel Prices API v3 fuelStationsCorridorSearch parameters: - $ref: '#/components/parameters/X-Request-Id' - $ref: '#/components/parameters/fuelType' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/sort' - $ref: '#/components/parameters/brands' - $ref: '#/components/parameters/returnAllStations' - $ref: '#/components/parameters/iconSize' requestBody: content: application/json: schema: $ref: '#/components/schemas/CorridorSearchRequest' required: true responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsResult_2' examples: proximitySearchExample: $ref: '#/components/examples/FuelStationsSearchExample' '400': description: Invalid parameters were provided headers: X-Correlation-ID: $ref: '#/components/headers/X-Correlation-Id' X-Request-ID: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: badRequestMissingMandatoryParameterExample: $ref: '#/components/examples/BadRequestStationsExample' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] - ApiKey: [] servers: - url: https://fuel.hereapi.com/v3 description: Production environment URL /stations/{id}: get: tags: - Fuel stations summary: One fuel station data description: Retrieves single fuel station information for given station id operationId: Fuel Prices API v3 fuelStationDetail parameters: - $ref: '#/components/parameters/X-Request-Id' - name: id in: path description: Fuel station id required: true schema: type: string - $ref: '#/components/parameters/iconSize' responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStation_2' examples: fuelStationExample: $ref: '#/components/examples/FuelStationExample' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '404': description: Fuel station with given id does not exist headers: X-Correlation-ID: $ref: '#/components/headers/X-Correlation-Id' X-Request-ID: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: notFoundtExample: $ref: '#/components/examples/NotFoundStationByIdExample' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] - ApiKey: [] servers: - url: https://fuel.hereapi.com/v3 description: Production environment URL /stations/bulk: get: tags: - Fuel stations summary: Return multiple fuel stations description: Retrieves multiple fuel stations by station ids operationId: Fuel Prices API v3 fuelStationBulk parameters: - $ref: '#/components/parameters/X-Request-Id' - name: ids in: query description: Fuel station ids required: true explode: false schema: type: array items: type: string - name: content in: query description: "Limit the content in the response.\n\nThe possible values are:\n\n * dynamic (returns only dynamic data - fuel prices)\n * all (return both, static and dynamic data)\n" required: false schema: type: string default: dynamic enum: - dynamic - all - $ref: '#/components/parameters/iconSize' responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsResult_2' examples: fuelStationsAllExample: $ref: '#/components/examples/FuelStationsSearchExample' fuelStationsDynamicExample: $ref: '#/components/examples/FuelStationBulkDynamicExample' '400': description: Invalid parameters were provided headers: X-Correlation-ID: $ref: '#/components/headers/X-Correlation-Id' X-Request-ID: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: badRequestMissingMandatoryParameterExample: $ref: '#/components/examples/BadRequestStationsNoIdExample' badRequestWrongContentParameterExample: $ref: '#/components/examples/BadRequestStationsContentExample' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] - ApiKey: [] servers: - url: https://fuel.hereapi.com/v3 description: Production environment URL /stations/count: get: tags: - Fuel stations summary: Number of fuel stations description: Return number of fuel stations within given geospatial area operationId: Fuel Prices API v3 fuelStationsCount parameters: - $ref: '#/components/parameters/X-Request-Id' - name: in description: "Return fuel stations within a geographical area.\nArea within which to return fuel stations.\n\nA geographic area can be one of the following:\n\n * A circular area, provided as latitude, longitude, and radius (in meters)\n\n Format: `circle:{latitude},{longitude};r={radius}`\n\n Type: `circle:{decimal},{decimal};r={integer}`\n\n Example: `circle:13.1,-43.1;r=10000`\n\n * A bounding box, provided as _west longitude_, _south latitude_, _east longitude_, _north latitude_\n\n Format: `bbox:{west longitude},{south latitude},{east longitude},{north latitude}`\n\n Example: `bbox:13.08836,52.33812,13.761,52.6755`\n\n * A corridor, provided as a polyline in\n [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoding and a\n radius (in meters). The radius is measured perpendicular to each segment of the\n polyline on both sides, so a radius of 50 meters will cover an area 50 meters on either\n side of the polyline and be 100 meters wide from one side to the other.\n\n Format: `corridor:{polyline};r={radius}`\n\n Example: `corridor:BF05xgKuy2xCx9B7vUl0OhnR54EqSzpEl-HxjD3pBiGnyGi2CvwFsgD3nD4vB6e:r=50`\n" in: query style: form required: true schema: type: string examples: circle: value: circle:13.1,-43.1;r=10000 summary: A circular area bbox: value: bbox:13.08836,52.33812,13.761,52.6755 summary: A bounding box corridor: value: corridor:BF05xgKuy2xCx9B7vUl0OhnR54EqSzpEl-HxjD3pBiGnyGi2CvwFsgD3nD4vB6e:r=50 summary: A corridor responses: '200': description: OK headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/FuelStationsCount' '400': description: Invalid parameters were provided headers: X-Correlation-ID: $ref: '#/components/headers/X-Correlation-Id' X-Request-ID: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingMandatoryInParameter: $ref: '#/components/examples/BadRequestStationsExample' '401': $ref: '#/components/responses/Error401Response' '403': $ref: '#/components/responses/Error403Response' '429': $ref: '#/components/responses/Error429Response' '500': $ref: '#/components/responses/Error500Response' '502': $ref: '#/components/responses/Error502Response' '503': $ref: '#/components/responses/Error503Response' '504': $ref: '#/components/responses/Error504Response' security: - Bearer: [] - ApiKey: [] servers: - url: https://fuel.hereapi.com/v3 description: Production environment URL components: schemas: FuelStationsResult: type: object properties: hasMore: type: boolean example: false description: More stations available (limit is 50 per one page if maxresults is not specified) fuelStations: type: object properties: fuelStation: type: array description: List of fuel stations found within search area items: $ref: '#/components/schemas/FuelStation' AddressType: type: object description: Fuel station address properties: city: type: string example: Berlin description: City name street: type: string example: Sonnenallee description: Street name of the fuel station streetNumber: type: string example: '56' description: House number of the fuel station region: type: string example: Berlin description: Region district: type: string example: Mitte description: District country: type: string example: DEU description: ISO 3166 3-lettre country code postalCode: type: string example: '12045' description: Postal code unparsedAddress: type: string example: Sonnenallee 56 Berlin 12045 DEU description: The string with unparsed address ContactType: type: object description: Fuel station contacts properties: phone: type: array items: $ref: '#/components/schemas/KeyValueType' example: - value: '+49306811313' label: PHONE fax: type: array items: $ref: '#/components/schemas/KeyValueType' example: - value: '+493068893007' label: FAX email: type: array items: $ref: '#/components/schemas/KeyValueType' example: - value: shellcustomercare@shell.com label: EMAIL website: type: array items: $ref: '#/components/schemas/KeyValueType' example: - value: https://find.shell.com/de/fuel/10024324-berlin-karl-marx-str label: WEBADDRESS AuthError: description: Error object reported in case of authentication or authorization errors. type: object properties: error: type: string description: Error message error_description: type: string description: Detailed information about the error example: error: Unauthorized error_description: ApiKey invalid. ApiKey not found. ErrorResponse: type: object properties: status: type: integer format: int32 description: The HTTP status code title: type: string description: Human-readable error description code: type: string description: Error code cause: type: string description: Human-readable explanation for the error action: type: string description: Human-readable action for the user correlationId: type: string description: Auto-generated ID univocally identifying this request required: - title - status - code - cause - action - correlationId OpeningHoursType: type: object properties: regularOpeningHours: type: array items: $ref: '#/components/schemas/OpeningHoursDetailsType' annualOpenings: type: array items: $ref: '#/components/schemas/AnnualOpeningHoursDetailType' FuelPriceType: type: object description: Information on the prices for fuels at the station. properties: price: type: number format: double example: 1.169 description: Real-time price for the fuel. errorMargin: type: number format: double example: 0.038 description: The difference between estimated and real-time prices averaged over all reported fuel prices for the specified fuel type and for this particular station and rounded to the nearest hundredth. For example, +/- 0.05 EUR indicates an error rate of 5 cents in the estimated fuel prices. If the price is not an estimate, field errorMargin will be suppressed. deltaPrice: type: number format: double example: 0.049 description: The difference between the price and the price for the cheapest station/fuel type pair for the specified geometry. indexScore: type: integer format: int32 minimum: 0 maximum: 100 example: 78 description: Also known as a Fuel Price Index, this is a relative ranking for the fuel station for the specified area. When a fuel station has a low score, then its fuel price is lower than the prices at other stations with higher scores. Values are between 0 and 100. available: type: boolean example: true description: The fuel type is available (true) for refuelling or is not available (false) at this moment fuelType: type: string example: '1' description: Fuel type. xml: attribute: true unit: type: string enum: - l - gal example: l description: Unit of measurement for fuel. xml: attribute: true currency: type: string example: EUR description: Currency used in the price. xml: attribute: true lastUpdateTimestamp: type: string example: '2020-09-07T05:16:36.000Z' description: Information about when the fuel price information was last updated, in ISO 8601 format. If the time is UTC, a Z is added. An example of this kind of timestamp value is 2013-12-31T12:00:00.000Z. If the time is not UTC , then the offset is added as a ±[hh][mm] value (for example, 2014-01-14T10:00:00.000+0100). xml: attribute: true HydrogenStatus: type: string description: Status of hydrogen dispensor example: limited enum: - online - offline - limited - offHours - refresh - unknown FuelStation: type: object properties: id: type: string example: 276u33d9-a17acb43a137436ba33808cab15bc914 description: Unique fuel station identifier. xml: attribute: true pvId: type: string example: '50664035' description: PVID identifier. xml: attribute: true lastUpdateTimestamp: type: string format: datetime example: '2020-04-23T14:32:20.371Z' description: Timestamp of the last update of information about this POI by the content supplier. Represents a datetime in ISO 8601 format. If time is UTC, 'Z' is added directly after the time without a space (e.g. 2014-01-14T10:00Z). Otherwise, time offsets from UTC is added after time in format ±[hh][mm] (e.g. 2014-01-14T10:00:00+0100) xml: attribute: true timeZone: type: string example: Europe/Berlin description: Time zone of the POI. Represents the standard denominator of the time zone. xml: attribute: true name: type: string example: Shell description: Fuel station name brand: type: string example: Shell description: Fuel station brand brandIcon: type: string example: https://download.vcdn.cc.data.here.com/p/d/autox/pr/icons/2015-09-11/shell.png description: Link to fuel station brand icon distance: type: integer format: int32 example: 125 description: Air distance to the station in meters from given location open24x7: type: boolean example: true description: Boolean value indicating if the fuel station is open 24 hours a day. address: $ref: '#/components/schemas/AddressType' contacts: $ref: '#/components/schemas/ContactType' position: $ref: '#/components/schemas/PositionType' entrancePosition: $ref: '#/components/schemas/PositionType' fuelPrice: type: array items: $ref: '#/components/schemas/FuelPriceType' stationDetails: $ref: '#/components/schemas/FuelStationDetailType' FuelStationDetailType: type: object description: Other fuel station details - opening hours, accessibility, etc properties: openingHours: $ref: '#/components/schemas/OpeningHoursType' restrictedAccess: type: boolean example: false description: "Indicating if the access to this Fuel station is restricted. \n\nTrue when re-fuelling at this station required subscription, driver must be member and verified by card or mobile application.\n" default: false accessibilities: description: "Fuel station accessibility details. \n\nInformation for the driver about access restrictions and suitabilities. \n\nE.g. `Members only`, `Suitable for wheel chair`, `Vertical clearance 4 m`, etc.\n" type: array items: type: string example: - Members only - Vertical clearance 4m hydrogenPressures: type: array items: type: integer enum: - 350 - 700 example: 350 description: "Pressure level of the dispensed hydrogen (in bar). \n \nOnly present for fuel type=74 (Hydrogen)\n" hydrogenVehicleTypes: type: array items: type: string enum: - car - bus - truck example: car description: "Category of FCEV the hydrogen can be dispensed to.\n \nOnly present for fuel type=74 (Hydrogen)\n" operationalState: $ref: '#/components/schemas/OperationalStateType' OpeningHoursDetailsType: type: object properties: daymask: type: integer format: int32 example: 127 description: A mask representing the days of the week as an 8-bit integer mask. period: $ref: '#/components/schemas/TimePeriodType' Error: type: object properties: Type: type: string example: Invalid Request description: Type of error Message: type: array description: Detailed error description items: type: string example: Request parameter 'product' does not conform with expected data type. Please check the documentation. OperationalStateType: type: object description: "An \"operational state\" for a fuel station refers to its current \nstatus, which can be active and selling fuel or closed, \nand is determined by factors like the availability of fuel, \npower, and the ability to dispense it.\n" properties: h350Status: $ref: '#/components/schemas/HydrogenStatus' example: online h700Status: $ref: '#/components/schemas/HydrogenStatus' example: limited h350Inventory: type: number format: double example: 4.25 description: Actual inventory of 350bar hydrogen in kg h700Inventory: type: number format: double example: 9.6 description: Actual inventory of 7000bar hydrogen in kg eventMessage: type: string description: Ongoing even message. example: The station is undergoing maintenance until further notice. KeyValueType: type: object properties: value: type: string example: '+49306233662' description: Contact value - phone or fax number, web site URL, email address, etc label: type: string example: XYZ description: Contact type identifier PositionType: type: object description: WGS84 format co-ordinates for the fuel station properties: latitude: type: number format: double example: 52.48468 description: Latitude in WGS84 format of the fuel station. longitude: type: number format: double example: 13.42942 description: Longitude in WGS84 format of the fuel station. AnnualOpeningHoursDetailType: type: object properties: date: type: string format: date example: '2020-12-24' description: Date of special opening hours period: $ref: '#/components/schemas/TimePeriodType' closed: type: boolean example: true description: True if station is closed on particular date. Either the Closed or the Period elements are included in the response, not both. TimePeriodType: type: object properties: from: type: string format: time example: 06:00:00 description: Start time, in hh:mm:ss format to: type: string format: time example: '21:30:00' description: End time, in hh:mm:ss format FuelStationsResult_2: type: object properties: total: type: integer format: int32 example: 125 description: Total number of stations within search area limit: type: integer format: int32 example: 50 description: Maximum number of stations in the response count: type: integer format: int32 example: 50 description: Number of stations returned nextOffset: type: integer format: int32 example: 51 description: Next offset stations: type: array description: List of fuel stations found within search area items: $ref: '#/components/schemas/FuelStation_2' ContactType_2: type: object description: Fuel station contacts properties: phones: type: array items: $ref: '#/components/schemas/KeyValueType' faxes: type: array items: $ref: '#/components/schemas/KeyValueType' emails: type: array items: $ref: '#/components/schemas/KeyValueType' websites: type: array items: $ref: '#/components/schemas/KeyValueType' Address: type: object properties: label: type: string description: Requested address. example: Schulstraße 4, 32547 Bad Oeynhausen, Germany countryCode: type: string description: A three-letter country code. example: DEU countryName: type: string description: The localised country name. example: Deutschland state: type: string description: A code/abbreviation for the state division of a country. example: North Rhine-Westphalia county: type: string description: A division of a state; typically, a secondary-level administrative division of a country or equivalent. example: Mitte city: type: string description: The name of the primary locality of the place. example: Bad Oyenhausen district: type: string description: A division of city; typically an administrative unit within a larger city or a customary name of a city's neighborhood. example: Bad Oyenhausen subdistrict: type: string description: A subdivision of a district. example: Minden-Lübbecke street: type: string description: Name of street. example: Schulstrasse postalCode: type: string description: An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code. example: '32547' houseNumber: type: string description: House number. example: '4' OpeningHoursType_2: type: object properties: regularSchedule: type: array items: $ref: '#/components/schemas/OpeningHoursDetailsType_2' exceptions: type: array items: $ref: '#/components/schemas/AnnualOpeningHoursDetailType_2' FuelPriceType_2: type: object description: Information on the prices for fuels at the station. properties: price: type: number format: double example: 1.169 description: Real-time price for the fuel. errorMargin: type: number format: double example: 0.038 description: The difference between estimated and real-time prices averaged over all reported fuel prices for the specified fuel type and for this particular station and rounded to the nearest hundredth. For example, +/- 0.05 EUR indicates an error rate of 5 cents in the estimated fuel prices. If the price is not an estimate, field errorMargin will be suppressed. deltaPrice: type: number format: double example: 0.049 description: The difference between the price and the price for the cheapest station/fuel type pair for the specified geometry. indexScore: type: integer format: int32 minimum: 0 maximum: 100 example: 78 description: Also known as a Fuel Price Index, this is a relative ranking for the fuel station for the specified area. When a fuel station has a low score, then its fuel price is lower than the prices at other stations with higher scores. Values are between 0 and 100. fuelType: type: string example: '1' description: Fuel type. unit: type: string example: l description: Unit of measurement for fuel. currency: type: string example: EUR description: Currency used in the price. available: type: boolean example: true description: The fuel type is available (true) for refuelling or is not available (false) at this moment modified: type: string format: date-time example: '2020-09-07T05:16:36.000Z' description: Information about when the fuel price information was last updated, in ISO 8601 format. The time is UTC. FuelStation_2: type: object properties: id: type: string example: 276u33d9-a17acb43a137436ba33808cab15bc914 description: Unique fuel station identifier. modified: type: string format: date-time example: '2020-04-23T14:32:20.371Z' description: Timestamp of the last update of information about this POI by the content supplier. Represents a datetime in ISO 8601 format. The time is UTC. timeZone: type: string example: Europe/Berlin description: Time zone of the POI. Represents the standard denominator of the time zone. name: type: string example: Shell description: Fuel station name brand: type: string example: Shell description: Fuel station brand name brandIcon: type: string example: https://download.vcdn.cc.data.here.com/p/d/autox/pr/icons/2015-09-11/shell.png description: Link to fuel station brand icon distance: type: integer format: int32 example: 125 description: "Air distance to the station in meters from given location. \nPresent only for proximity search - query parameter in=circle.\n" open24x7: type: boolean example: true description: Boolean value indicating if the fuel station is open 24 hours a day. address: $ref: '#/components/schemas/Address' contacts: $ref: '#/components/schemas/ContactType_2' position: allOf: - $ref: '#/components/schemas/Location' description: The coordinates (latitude, longitude) of a pin on a map corresponding to the searched fuel station. access: allOf: - $ref: '#/components/schemas/Location' description: Coordinates of the fuel station you are navigating to (for example, driving or walking). This is a point on a road or in a parking lot. prices: type: array items: $ref: '#/components/schemas/FuelPriceType_2' stationDetails: $ref: '#/components/schemas/FuelStationDetailType' FuelStationsCount: type: object description: Number of fuel stations response properties: count: description: Total number of fuel stations within requested area type: integer format: int32 example: 148 CorridorSearchRequest: type: object description: Body payload for corridor search example: corridor: - lat: 52.5310898 lng: 13.3849497 - lat: 52.5378799 lng: 13.3735304 - lat: 52.5476799 lng: 13.3569899 - lat: 52.5622292 lng: 13.3263397 width: 5000 properties: corridor: type: array items: $ref: '#/components/schemas/Location' width: type: integer format: int32 example: 7000 default: 5000 minimum: 5000 maximum: 20000 OpeningHoursDetailsType_2: type: object properties: days: type: array items: type: string enum: - mo - tu - we - th - fr - sa - su description: A list of days for which opening time is valid periods: type: array items: $ref: '#/components/schemas/TimePeriodType' Location: type: object description: Location on the Earth properties: lat: description: Location of a point on Earth north or south of the equator in decimal degrees. type: number format: double example: 52.531677 lng: description: Location of a place on Earth east or west of the prime meridian in decimal degrees. type: number format: double example: 13.381777 elv: description: The elevation of a point above mean sea level in meters. type: number example: 512.5 example: lat: 52.531677 lng: 13.381777 required: - lat - lng AnnualOpeningHoursDetailType_2: type: object properties: date: type: string format: date example: '2020-12-24' description: Date of special opening hours periods: type: array items: $ref: '#/components/schemas/TimePeriodType' closed: type: boolean example: true description: True if station is closed on particular date. Either the Closed or the Period elements are included in the response, not both. examples: InternalServerErrorExample: value: status: 500 title: Internal Server Error cause: There was some issue processing the request. action: Please retry after some time. code: E612010 correlationId: c1281609-7a9a-45d0-8438-f4ac82c4e2c2 504errorResponseExample: value: title: Gateway timeout status: 504 code: E612101 cause: Gateway Timeout action: Did not receive a timely response from an upstream server correlationId: dfe3b1a5-214f-49a9-b8a0-d78bd623bac0 502errorResponseExample: value: title: Bad Gateway status: 502 code: E612201 cause: Bad Gateway action: Failure of communication with external system. correlationId: dfe3b1a5-214f-49a9-b8a0-d78bd623bac0 InternalServerErrorExample_2: value: status: 500 title: Internal Server Error cause: There was some issue processing the request. action: Please retry after some time. code: E612010 correlationId: b99171db-1ac7-4f5b-8888-caf8613ec5f8 NotFoundStationByIdExample: value: status: 404 title: Not Found cause: Fuel station with given id not found. action: Please provide existing fuel staion ID. code: E612002 correlationId: 03bb0003-0f2d-4761-a57d-8f6349967272 FuelStationExample: value: id: 276u33d9-a17acb43a137436ba33808cab15bc914 modified: '2020-04-23T14:32:20.371Z' timeZone: Europe/Berlin name: Shell brand: Shell brandIcon: https://download.vcdn.cc.data.here.com/p/d/autox/pr/icons/2015-09-11/shell.png distance: 125 open24x7: true address: label: Schulstraße 4, 32547 Bad Oeynhausen, Germany countryCode: DEU countryName: Deutschland state: North Rhine-Westphalia county: Mitte city: Bad Oyenhausen district: Bad Oyenhausen subdistrict: Minden-Lübbecke street: Schulstrasse postalCode: '32547' houseNumber: '4' contacts: phones: - value: '+49306811313' label: PHONE faxes: - value: '+493068893007' label: FAX emails: - value: shellcustomercare@shell.com label: EMAIL websites: - value: https://find.shell.com/de/fuel/10024324-berlin-karl-marx-str label: WEBADDRESS position: lat: 52.531677 lng: 13.381777 access: lat: 52.531677 lng: 13.381777 prices: - price: 1.169 errorMargin: 0.038 deltaPrice: 0.049 indexScore: 78 fuelType: '1' unit: l currency: EUR modified: '2020-09-07T05:16:36.000Z' stationDetails: openingHours: regularSchedule: - days: - mo - tu - we - th - fr - sa - su periods: - from: 06:00:00 to: '21:30:00' exceptions: - date: '2020-12-24' periods: - from: 06:00:00 to: '21:30:00' closed: true BadRequestStationsExample: value: status: 400 title: Invalid Request cause: Mandatory parameter 'in' is missing.. action: Please provide required 'in' query parameter. code: E612001 correlationId: 7f163ef9-28cb-4e55-8f78-800e4c1c4a0f FuelStationsSearchExample: value: total: 125 limit: 50 count: 50 nextOffset: 51 stations: - id: 276u33d9-a17acb43a137436ba33808cab15bc914 modified: '2020-04-23T14:32:20.371Z' timeZone: Europe/Berlin name: Shell brand: Shell brandIcon: https://download.vcdn.cc.data.here.com/p/d/autox/pr/icons/2015-09-11/shell.png distance: 125 open24x7: true address: label: Schulstraße 4, 32547 Bad Oeynhausen, Germany countryCode: DEU countryName: Deutschland state: North Rhine-Westphalia county: Mitte city: Bad Oyenhausen district: Bad Oyenhausen subdistrict: Minden-Lübbecke street: Schulstrasse postalCode: '32547' houseNumber: '4' contacts: phones: - value: '+49306811313' label: PHONE faxes: - value: '+493068893007' label: FAX emails: - value: shellcustomercare@shell.com label: EMAIL websites: - value: https://find.shell.com/de/fuel/10024324-berlin-karl-marx-str label: WEBADDRESS position: lat: 52.531677 lng: 13.381777 access: lat: 52.531677 lng: 13.381777 prices: - price: 9.9 errorMargin: 0.038 deltaPrice: 0.049 indexScore: 1 fuelType: '74' unit: kg currency: EUR available: true modified: '2020-09-07T05:16:36.000Z' stationDetails: restrictedAccess: false accessibilities: - Vertical clearance 4 m - Suitable for medium truck hydrogenPressures: - 350 - 700 hydrogenVehicleTypes: - car - bus operationalState: h350Status: limited h350Inventory: 4.55 openingHours: regularSchedule: - days: - mo - tu - we - th - fr - sa - su periods: - from: 06:00:00 to: '21:30:00' exceptions: - date: '2020-12-24' periods: - from: 06:00:00 to: '21:30:00' closed: true BadRequestStationsNoIdExample: value: status: 400 title: Invalid Request cause: QueryParameter 'ids' is required. action: Please provide required 'ids' query parameter. code: E612003 correlationId: d2b7e3d1-d09e-4834-90a0-9759e5d98165 BadRequestStationsContentExample: value: status: 400 title: Invalid Request cause: QueryParameter 'content' is wrong. action: Please provide valid 'content' query parameter (all, dynamic). code: E612004 correlationId: 6bb2e9b6-05a6-428e-a8f0-a3814887a9af FuelStationBulkDynamicExample: value: hasMore: false fuelStations: - id: 276u33d3-d493ff3df1e24107b5f35d3481569c14 fuelPrice: - price: 1.039 fuelType: '11' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 1.459 fuelType: '44' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 1.039 fuelType: '1' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 1.249 fuelType: '46' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 1.249 fuelType: '53' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 1.199 fuelType: '54' unit: l currency: EUR modified: '2020-10-30T09:21:06.000Z' - price: 9.9 fuelType: '74' unit: kg currency: EUR available: true modified: '2020-10-30T09:21:06.000Z' responses: Error401Response: description: API response in case of lacking valid authorization credentials. headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/AuthError' example: error: Unauthorized error_description: No credentials found Error503Response: description: API response in case of service unavailable headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 503 code: E611001 title: Service not available cause: Service current not available action: Retry later correlationId: efefe455-d2e3-4e23-86aa-4e9a8a1680d4 Error500Response: description: API response in case of internal server error headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: errorResponseExample: $ref: '#/components/examples/InternalServerErrorExample' Error429Response: description: API response in case of too many requests headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: 429 code: E611125 title: Too many requests cause: Request rate limit reached action: Retry later, lower the request rate correlationId: efefe455-d2e3-4e23-86aa-4e9a8a1680d4 Error504Response: description: API response in case of gateway timeout. headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: errorResponseExample: $ref: '#/components/examples/504errorResponseExample' Error502Response: description: API response in case of bad gateway headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: errorResponseExample: $ref: '#/components/examples/502errorResponseExample' Error403Response: description: API response in case of insufficient credentials for access to the requested resource. headers: X-Correlation-Id: $ref: '#/components/headers/X-Correlation-Id' X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/AuthError' example: error: Forbidden error_description: These credentials do not authorize access parameters: X-Request-Id: name: X-Request-Id in: header description: User-provided token that can be used to trace a request or a group of requests sent to the service. schema: type: string iconSize: name: iconSize in: query description: 'Request specific size of brand icon image - in pixels - to match UI and bandwidth requirements. ' example: 20 required: false schema: type: integer format: int32 enum: - 8 - 16 - 20 - 24 - 32 - 40 - 48 limit: name: limit in: query description: The maximum number of results a response can contain. This parameter together with the offset parameter in the query and HasMore in the response can be used for pagination. required: false schema: type: integer format: int32 default: 50 in: name: in description: "Return fuel stations within a geographical area.\nArea within which to return fuel stations.\n\nA geographic area can be one of the following:\n\n * A circular area, provided as latitude, longitude, and radius (in meters)\n\n Format: `circle:{latitude},{longitude};r={radius}`\n\n Type: `circle:{decimal},{decimal};r={integer}`\n\n Example: `circle:13.1,-43.1;r=10000`\n\n * A bounding box, provided as _west longitude_, _south latitude_, _east longitude_, _north latitude_\n\n Format: `bbox:{west longitude},{south latitude},{east longitude},{north latitude}`\n\n Example: `bbox:13.08836,52.33812,13.761,52.6755`\n\n * A corridor, provided as a polyline in\n [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoding and a\n radius (in meters). The radius is measured perpendicular to each segment of the\n polyline on both sides, so a radius of 50 meters will cover an area 50 meters on either\n side of the polyline and be 100 meters wide from one side to the other.\n\n Format: `corridor:{polyline};r={radius}`\n\n Example: `corridor:BF05xgKuy2xCx9B7vUl0OhnR54EqSzpEl-HxjD3pBiGnyGi2CvwFsgD3nD4vB6e:r=50`\n" in: query style: form required: true schema: type: string examples: circle: value: circle:13.1,-43.1;r=10000 summary: A circular area bbox: value: bbox:13.08836,52.33812,13.761,52.6755 summary: A bounding box corridor: value: corridor:BF05xgKuy2xCx9B7vUl0OhnR54EqSzpEl-HxjD3pBiGnyGi2CvwFsgD3nD4vB6e:r=50 summary: A corridor brands: name: brands in: query description: 'List of brands to filter the stations in the response. The brand names in the list are separated with commas. The result will contain only the stations that have brand field that match to the one of those specified in the list. The matching is caseinsensitive. List of brands can be retireved using `/fuelBrands` endpoint ' required: false explode: false schema: type: array items: type: string offset: name: offset in: query description: A value specifying the index of the first result. This parameter together with the maxresults parameter in the query and HasMore in the response can be used for pagination. required: false schema: type: integer format: int32 default: 0 fuelType: name: fuelTypes in: query description: "An integer identifying the fuel type or category included in the response.\nList of available fuel types can be retireved using `/fuelTypes` endpoint\n |Fuel type ID|Name|\n |---|---|\n |-1|All Truck Diesel|\n |-2|All Diesel\n |-3|All Petrol\"\n |-4|All LPG|\n |-5|All CNG|\n |-6|All Ethanol|\n |-7|All Methanol|\n |-8|All Additives|\n |1|Diesel|\n |2|Regular|\n |3|Mid-grade|\n |4|Premium|\n |5|E-85|\n |6|Bio-Diesel|\n |7|Bio-Diesel 10|\n |8|Bio-Diesel 15|\n |9|Bio-Diesel 20|\n |10|Diesel plus|\n |11|Truck-Diesel|\n |12|Red-Diesel|\n |13|E-10|\n |14|LPG-GLP|\n |15|LRP|\n |16|Methane|\n |17|Midgrade-self|\n |18|Diesel-self|\n |19|AdBlue|\n |20|V-Power-95|\n |21|CNG|\n |22|Ethanol|\n |23|Ethanol w. additives|\n |24|GPL self|\n |25|Premium self|\n |26|Leaded Four|\n |27|Super Unleaded|\n |28|Super Unleaded Ultimate|\n |29|Diesel-plus self|\n |30|Methanol self|\n |31|Mid-grade E10|\n |32|Super-Diesel|\n |33|Unleaded E5|\n |34|Unleaded E25|\n |35|Unleaded|\n |36|Unleaded 91|\n |37|Unleaded 93|\n |38|Unleaded 97|\n |39|Unleaded 99|\n |40|Unleaded 100|\n |41|Unleaded 102|\n |42|Methanol|\n |43|Unleaded E10|\n |44|Shell V-Power Racing|\n |45|Shell V-Power 100|\n |46|Shell V-Power Diesel|\n |47|Aral Ultimate 102|\n |48|Aral Ultimate Diesel|\n |49|BP Ultimate Super|\n |50|BP Ultimate Diesel|\n |51|Blue One 95|\n |52|Diesel Cleanline|\n |53|Super E5|\n |54|Super E10|\n |55|Premium Diesel|\n |56|Unleaded 95|\n |57|Simple gasoline|\n |58|Simple diesel|\n |59|Super Unleaded 98|\n |60|Unleaded 98|\n |61|Premium gasoline|\n |62|Synergy Supreme+ Diesel|\n |63|Supreme Diesel|\n |64|Unleaded 92|\n |65|Unleaded 80|\n |66|Super Unleaded 95|\n |67|Super Unleaded 92|\n |68|LNG|\n |69|Super E5 Premium|\n |70|Heating oil|\n |71|AdBlue Car|\n |72|AdBlue Truck|\n |73|Hydrotreated vegetable oil|\n |74|Hydrogen|\n |75|E-85 cash (US ONLY)|\n |76|Diesel cash (US ONLY)|\n |77|Mid-grade cash (US ONLY)|\n |78|Regular cash (US ONLY)|\n |79|Regular clear - without ethanol (US ONLY)|\n |80|Premium cash (US ONLY)|\n |81|Two stroke petrol|\n |82|Unleaded 87|\n |83|Unleaded 89|\n |84|GTL - Gas to liquid fuel|\n |85|HVO 30 - Diesel with 30% of hydrotreated vegetable oil|\n |86|Premium Diesel cash|\n |87|Red-Diesel cash|\n |88|Bio-Diesel 20 cash|\n |89|Super E15|\n |90|Heating oil cash|\n |91|AdBlue cash|\n |92|AdBlue Truck cash|\n |93|Bio-Diesel cash|\n |94|Bio-Diesel 10 cash|\n |95|LPG-GLP cash|\n |96|CNG cash|\n |97|Truck Diesel cash|\n" required: false explode: false schema: type: array items: type: integer format: int32 returnAllStations: name: returnAllStations in: query description: 'Also fuel stations with unknown price (but fuel type is known, only price is not up to date) or unknown fuel type information will be included in the result set: In the response stations with fuel prices are in the beginning followed with stations without information about fuel types and prices. This gives client at least information about all available fuel stations within requested area so client can select also station without price information, but its closest to current client position. This parameter works together with `fuelType` parameter. If `fuelType` parameter is not set, all stations within search area are in the response - with and without fuel prices. ' required: false schema: type: boolean default: false sort: name: sort in: query description: "Criteria for sorting a list of search results. \nFormat: `{sortKey}:{sortDirection}`\n\nwhere sortKey can be one of:\n * distance\n * price\n \nand sortDirection:\n * asc\n * desc\n\nSorting by distance make sense only for circle search and sorting is by air distance.\n" required: false schema: type: string headers: X-Request-Id: description: 'User-provided token that can be used to trace a request or a group of requests sent to the service. ' schema: type: string X-Correlation-Id: description: Auto-generated unique identifier to identify this request. schema: type: string example: 4d173a1e-6f1b-459b-b74f-23686354aaea securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: 'A token obtained from a separate endpoint using client credentials and an OAuth 1.0a HMAC-SHA256 signed request. For more information on how to get a bearer token, see https://developer.here.com/documentation/identity-access-management/dev_guide/index.html. ' ApiKey: type: apiKey in: query name: apiKey description: 'A key generated specifically to authenticate API requests. For more information on how to get an API key, see https://developer.here.com/documentation/identity-access-management/dev_guide/index.html. ' externalDocs: description: The developer guide and related API references are available here. url: https://www.here.com/docs/category/fuel-prices x-refined-from: - here-fuel-prices-v2-openapi.yml - here-fuel-prices-v3-openapi.yml