HERE

HERE Fuel types and brands API

Get available fuel types and brands

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /fuel/fueltypes List fuel types (v2) · Fuel types #
Ask an LLM
“Which fuel type IDs can I use in the v2 fuel station search?”
“Where is the list of fuel types for the legacy v2 fuel API?”
Tell an agent
List all fuel types from the v2 fuel API.
Show the v2 fuel type IDs.
GET /fuel/fuelbrands List fuel station brands (v2) · Fuel brands #
Ask an LLM
“Which station brand names does the v2 fuel search accept?”
“Can I get every fuel brand from the older v2 API?”
Tell an agent
List all fuel station brands from the v2 fuel API.
Show the brand names I can filter v2 stations by.
GET /fuelTypes List available fuel types · Fuel types #
Ask an LLM
“What fuel types, like diesel or LPG, can I search stations by?”
“Which fuel type ID should I pass to filter station searches?”
Tell an agent
List the available fuel types.
Give me the fuel type IDs for station searches.
GET /fuelBrands List fuel station brands by country · Fuel brands #
Ask an LLM
“Which fuel station brands operate in a given country?”
“Can I get the full list of station brands to filter results?”
Tell an agent
List fuel station brands in country {country}.
Show every fuel station brand available.

Documentation

📖
Documentation
https://docs.here.com/identity-and-access-management/docs
📖
APIReference
https://docs.here.com/identity-and-access-management/reference
📖
Documentation
https://docs.here.com/data-api/docs
📖
APIReference
https://docs.here.com/data-api/reference
📖
Documentation
https://docs.here.com/usage/docs
📖
APIReference
https://docs.here.com/usage/reference
📖
Documentation
https://docs.here.com/destination-weather/docs
📖
APIReference
https://docs.here.com/destination-weather/reference
📖
Documentation
https://docs.here.com/ev-products/docs
📖
APIReference
https://docs.here.com/ev-products/reference
📖
Documentation
https://docs.here.com/fuel-prices/docs
📖
APIReference
https://docs.here.com/fuel-prices/reference
📖
Documentation
https://docs.here.com/geocoding-and-search/docs
📖
APIReference
https://docs.here.com/geocoding-and-search/reference
📖
Documentation
https://docs.here.com/routing/docs
📖
APIReference
https://docs.here.com/routing/reference
📖
Documentation
https://docs.here.com/positioning/docs
📖
APIReference
https://docs.here.com/positioning/reference
📖
Documentation
https://docs.here.com/indoor-map/docs
📖
APIReference
https://docs.here.com/indoor-map/reference
📖
Documentation
https://docs.here.com/transit/docs
📖
APIReference
https://docs.here.com/transit/reference
📖
Documentation
https://docs.here.com/map-attributes/docs
📖
APIReference
https://docs.here.com/map-attributes/reference
📖
Documentation
https://docs.here.com/map-rendering/docs
📖
APIReference
https://docs.here.com/map-rendering/reference
📖
Documentation
https://docs.here.com/workspace/docs
📖
APIReference
https://docs.here.com/workspace/reference
📖
Documentation
https://docs.here.com/tour-planning/docs
📖
APIReference
https://docs.here.com/tour-planning/reference
📖
Documentation
https://docs.here.com/tracking/docs
📖
APIReference
https://docs.here.com/tracking/reference
📖
Documentation
https://docs.here.com/traffic-api/docs
📖
APIReference
https://docs.here.com/traffic-api/reference
📖
Documentation
https://docs.here.com/wego-pro/docs
📖
APIReference
https://docs.here.com/wego-pro/reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-fuel-types-and-brands-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/here:here-fuel-types-and-brands-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

here-fuel-types-and-brands-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Here Fuel types and brands API
  version: '1.0'
  description: 'Operations tagged Fuel types and brands 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 types and brands
  description: Get available fuel types and brands
paths:
  /fuel/fueltypes:
    get:
      parameters:
      - $ref: '#/components/parameters/X-Request-Id'
      tags:
      - Fuel types and brands
      summary: Fuel types
      description: Returns all available fuel types. Fuel type id can be used as fuelType query parameter in Fuel stations search
      operationId: FuelPricesAPIV2FuelTypes
      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/FuelTypes'
              examples:
                dieselFuelTypesExample:
                  $ref: '#/components/examples/FuelTypesExample'
        '401':
          $ref: '#/components/responses/Error401Response'
        '403':
          $ref: '#/components/responses/Error403Response'
        '500':
          $ref: '#/components/responses/Error500Response'
      security:
      - Bearer: []
      x-operation-id-source: normalized
      x-operation-id-original: Fuel Prices API v2 fuelTypes
    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/fuelbrands:
    get:
      parameters:
      - $ref: '#/components/parameters/X-Request-Id'
      tags:
      - Fuel types and brands
      summary: Fuel brands
      description: Returns all available fuel station brands. Fuel station brand can be used as brands query parameter in Fuel stations search
      operationId: FuelPricesAPIV2FuelBrands
      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/FuelBrands'
              examples:
                fuelBrandsExample:
                  $ref: '#/components/examples/FuelBrandsExample'
        '401':
          $ref: '#/components/responses/Error401Response'
        '403':
          $ref: '#/components/responses/Error403Response'
        '500':
          $ref: '#/components/responses/Error500Response'
      security:
      - Bearer: []
      x-operation-id-source: normalized
      x-operation-id-original: Fuel Prices API v2 fuelBrands
    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
  /fuelTypes:
    get:
      tags:
      - Fuel types and brands
      summary: Fuel types
      description: Returns all available fuel types. Fuel type id can be used as fuelType query parameter in Fuel stations search
      operationId: FuelPricesAPIV3FuelTypes
      parameters:
      - $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/FuelTypes'
              examples:
                dieselFuelTypesExample:
                  $ref: '#/components/examples/FuelTypesExample'
        '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: []
      x-operation-id-source: normalized
      x-operation-id-original: Fuel Prices API v3 fuelTypes
    servers:
    - url: https://fuel.hereapi.com/v3
      description: Production environment URL
  /fuelBrands:
    get:
      tags:
      - Fuel types and brands
      summary: Fuel brands
      description: Returns all available fuel station brands. Fuel station brand can be used as brands query parameter in Fuel stations search
      operationId: FuelPricesAPIV3FuelBrands
      parameters:
      - $ref: '#/components/parameters/X-Request-Id'
      - name: country
        in: query
        description: ISO 3166-1 alpha-3 country code for which list of brands is returned
        required: false
        schema:
          type: string
      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/FuelBrands_2'
              examples:
                fuelBrandsExample:
                  $ref: '#/components/examples/FuelBrandsExample_2'
        '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: []
      x-operation-id-source: normalized
      x-operation-id-original: Fuel Prices API v3 fuelBrands
    servers:
    - url: https://fuel.hereapi.com/v3
      description: Production environment URL
components:
  examples:
    FuelBrandsExample:
      value:
        fuelBrands:
        - 1 Stop
        - 1-2-3
        - 1a autoservice
        - 25 Chasov
        - 3A Barontini
        - 4 Petroli
        - 7-Eleven
        - Agip
        - Shell
    FuelTypesExample:
      value:
        fuelTypes:
        - id: -1
          name: All Truck Diesel
        - id: -2
          name: All Diesel
        - id: 1
          name: Diesel
          parentIds:
          - -2
        - id: 6
          name: Bio-Diesel
          parentIds:
          - -2
        - id: 7
          name: Bio-Diesel 10
          parentIds:
          - -2
        - id: 10
          name: Diesel plus
          parentIds:
          - -2
        - id: 12
          name: Red-Diesel
          parentIds:
          - -2
    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
    FuelBrandsExample_2:
      value:
        fuelBrands:
        - name: 1 Stop
        - name: 1-2-3
        - name: 1a autoservice
        - name: 25 Chasov
        - name: 3A Barontini
        - name: 4 Petroli
        - name: 7-Eleven
        - name: Agip
        - name: Shell
    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
  schemas:
    FuelBrands:
      type: object
      description: Fuel station brand list
      properties:
        fuelBrands:
          description: List of available fuel brands
          type: array
          items:
            type: string
    FuelTypes:
      type: object
      description: Fuel type list
      properties:
        fuelTypes:
          description: List of available fuel types
          type: array
          items:
            $ref: '#/components/schemas/FuelType'
    FuelType:
      type: object
      description: Fuel type
      properties:
        id:
          description: Unique fuel type identifier
          type: integer
          format: int32
          example: 1
        name:
          description: Fuel type name
          type: string
          example: Regular
        parentIds:
          description: "Container for ParentIds data type.\nE.g. if fuelType in search stations query is -3, returns all stations with fuel type that has parentId = -3. \nThis can be used to search stations with e.g. all types of Diesel - diesel, Bio-diesel, Red-diesel, etc.\n"
          type: array
          items:
            type: integer
            format: int32
            example: -3
    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
    FuelBrand:
      type: object
      description: Fuel brand detail
      properties:
        name:
          type: string
          description: Fuel brand name
          example: Shell
      required:
      - name
    FuelBrands_2:
      type: object
      description: Fuel station brand list
      properties:
        fuelBrands:
          description: List of available fuel brands
          type: array
          items:
            $ref: '#/components/schemas/FuelBrand'
  responses:
    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'
    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
    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
    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
    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'
    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'
    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
  headers:
    X-Correlation-Id:
      description: Auto-generated unique identifier to identify this request.
      schema:
        type: string
      example: 4d173a1e-6f1b-459b-b74f-23686354aaea
    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
  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
  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