# The API endpoint retrieves Gas consumption data in

The API endpoint retrieves Gas consumption data in (m³) from gas meters.   The endpoint utilizes the underlying data from the meters to calculate and return the gas consumed by a customer during a given time period. To use the API endpoint, the user will need to provide the necessary information, such as the date range for which they wish to retrieve data, the device id or space id to which a group of devices belong, and any other relevant parameters.  The endpoint will then gather underlying stores of meter readings and calculate the total gas consumed by the customer during the specified time period such as  15 minutes, 2 hours, 1 day etc.   The gas consumption data will be returned in m³, which is the standard unit of measurement for gas consumption and the time units are in UTC.   This API endpoint can be useful for a variety of applications, such as tracking gas usage for billing purposes, identifying consumption saving opportunities, and monitoring usage for sustainability initiatives. 

Endpoint: GET /energy/gas
Version: v1
Security: ApplicationKey

## Query parameters:

  - `space.id` (string)
    Id of Space

  - `device.id` (string)
    Id of Device

  - `since` (any)
    Retrieve from this timestamp onwards

  - `until` (any)
    Retrieve until this timestamp

  - `continuationToken` (string)
    The continuation token to retrieve the next set of data.

  - `interval` (string)
    Interval for the data aggregation in the format number unit,
where unit can be 'minute', 'hour', 'day', 'week', or 'month'.
    Example: "2 hours"

  - `breakdown` (string)
    The breakdown of the data to retrieve. If not specified,
the data will be retrieved for the entire organisation.
    Enum: "device", "country"

  - `current` (string)
    The current time period to retrieve data for.
When specified, the return timestamps
will be aligned to time period for each timezone in UTC.
    Enum: "hour", "day", "week", "month", "year"

  - `previous` (string)
    The previous time period to retrieve data for.
When specified, the return timestamps
will be aligned to time period for each timezone in UTC.
    Enum: "hour", "day", "week", "month", "year"

## Response 200 fields (application/json):

  - `result` (array, required)

  - `result.energy` (string)
    Example: "1000"

  - `result.timestamp` (integer)
    Example: 1631707200000

  - `continuationToken` (string,null)
    Example: "eyJ0bpo92Dd2twl7ko1="