Price History

This page contains API endpoints for gas station prices history. A few settings on how data is returned can be altered by an administrator or can be viewed by user at Settings.

POST/prices-history

Get all prices

This endpoint allows you to retrieve prices for particular gas stations.

Body parameters

  • Name
    stations
    Type
    array
    Description

    List of gas stations.

Optional body parameters

  • Name
    diesel
    Type
    int
    Description

    Total amount (in litres) of diesel to calculate the total price. A list of available types: ad_blue, diesel, bio_diesel, hvo_diesel, super_sans_plomb, E10, E85, cng, lng, gnr, gplc, sp_95, sp_98

    Price will only contain total_cost if desired fuel type property is provided.

  • Name
    vehicle
    Type
    string
    Description

    Vehicle plate identification number. Applies rules that have been set on a specific vehicle.

  • Name
    terminalId
    Type
    string
    Description

    Station id to track for price changes.

  • Name
    time_parameter
    Type
    string
    Description

    Select time column to use.
    Default : available_at
    Available : available_at, created_at

  • Name
    date
    Type
    datetime
    Description

    Datetime for prices history.

Request

POST
/prices-history
curl -G /prices \
-H "Accept: application/json" \
-H "Content-type: application/json" \
-H "Authorization: Bearer {token}" \

Body

{
    "stations": ["1234", "1236"],
    "diesel": 100,
    "ad_blue": 50,
    "vehicle" : "AAB123",
    "terminalId": "ASDASdAB24",
    "time_parameter": "created_at"
}

Response

{
    "data": [
        {
            "gas_station_id": "ASDASdAB24",
            "gas_station_name": "Wetzlar",
            "partner_name": "AB24",
            "brand_name": "AB24",
            "total_cost": 184.2109,
            "products": [
                {
                    "product_name": "ad_blue",
                    "currency": "EUR",
                    "price": 0.7259,
                    "total_cost": 37.0209
                },
                {
                    "product_name": "diesel",
                    "currency": "EUR",
                    "price": 1.4719,
                    "total_cost": 147.19
                }
            ]
        },
        {
            "gas_station_id": "AA1234567",
            "gas_station_name": "Frankfurt ",
            "partner_name": "AB24",
            "brand_name": "AB24",
            "total_cost": 147.19,
            "products": [
                {
                    "product_name": "diesel",
                    "currency": "EUR",
                    "price": 1.4719,
                    "total_cost": 147.19
                }
            ]
        }
    ]
}