---
updatedAt: 2026-03-31T12:12:41.000Z
agentTools:
  projectIndex: https://api.net2grid.com/llms.txt
---

# /events/daily/{year}/{month}/{day}

Returns the appliance events of the user for the given day.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "NET2GRID Customer Engagement API",
    "description": "This is the B2C NET2GRID API that can be used by mobile and web apps to manage the accounts and the data that are provided by the NET2GRID Meter Data Analytics Platform.",
    "version": "13.6.0"
  },
  "servers": [
    {
      "url": "http://api.net2grid.docker",
      "description": "API server"
    }
  ],
  "paths": {
    "/v2/events/daily/{year}/{month}/{day}": {
      "get": {
        "tags": [
          "NILM - Disaggregation"
        ],
        "summary": "/events/daily/{year}/{month}/{day}",
        "description": "Returns the appliance events of the user for the given day.",
        "operationId": "v2getApplianceEventsForDay",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "description": "The year for which the appliance events are requested.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "month",
            "in": "path",
            "description": "The month for which the appliance events are requested.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "day",
            "in": "path",
            "description": "The day for which the appliance events are requested.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsDailyResponseDTO"
                },
                "examples": {
                  "EventsDailyResponseExample": {
                    "$ref": "#/components/examples/EventsDailyResponseExample"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request<br/>113: Gateway not found.<br/>152: User does not have a valid household object.<br/>153: No valid meter found for user.<br/>185: Labelpartner not specified for household.<br/>186: Cannot find a profile for this household.<br/>250: Unexpected exception while retrieving tariffs information.<br/>251: No cost calculation available.<br/>252: Tariff agreement not found.<br/>265: Unexpected exception while retrieving customer information.<br/>274: Unit conversion not applicable.<br/>400: User not provisioned.<br/>422: Invalid day/month/year provided.<br/>999: Unspecified Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDTO"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "EventsDailyDataDTO": {
        "required": [
          "Total"
        ],
        "properties": {
          "Total": {
            "description": "The usage of the appliance in kWh.",
            "type": "number"
          }
        },
        "type": "object",
        "additionalProperties": {
          "description": "The list of appliance events items for this activity.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/EventsDailyUsageDTO"
          }
        }
      },
      "EventsDailyResponseDTO": {
        "required": [
          "status",
          "data",
          "timestamp",
          "day"
        ],
        "properties": {
          "status": {
            "type": "string"
          },
          "data": {
            "$ref": "#/components/schemas/EventsDailyDataDTO"
          },
          "timestamp": {
            "description": "Timestamp of response in ISO-8601 format.",
            "type": "string"
          },
          "day": {
            "description": "The day for which we requested data in “YYYY-MM-DD” format.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "EventsDailyUsageDTO": {
        "required": [
          "usage",
          "cost"
        ],
        "properties": {
          "usage": {
            "description": "The usage of the appliance in kWh.",
            "type": "number"
          },
          "cost": {
            "description": "The cost of the usage.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "ErrorDTO": {
        "properties": {
          "code": {
            "type": "integer"
          },
          "message": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "ErrorResponseDTO": {
        "properties": {
          "status": {
            "type": "string"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDTO"
          }
        },
        "type": "object"
      }
    },
    "examples": {
      "EventsDailyResponseExample": {
        "summary": "Get daily events response",
        "value": {
          "status": "ok",
          "data": {
            "Refrigeration": {
              "Refrigeration": {
                "usage": 0.749,
                "cost": 0.17
              }
            },
            "Always On": {
              "AlwaysOn": {
                "usage": 0.48,
                "cost": 0.1
              }
            },
            "Entertainment": {
              "Entertainment": {
                "usage": 1.261,
                "cost": 0.27
              }
            },
            "Lighting": {
              "Lighting": {
                "usage": 1.1239999999999999,
                "cost": 0.25
              }
            },
            "Production": {
              "SolarProduction": {
                "usage": 0.8280000000000001,
                "cost": 0.18
              }
            },
            "Laundry": {
              "WashingMachine": {
                "usage": 0.015,
                "cost": 0
              }
            },
            "Total": 0.97
          },
          "timestamp": "2022-08-17T08:22:15+02:00",
          "day": "2022-06-02"
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "bearerFormat": "JWT",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "NILM - Disaggregation"
    }
  ],
  "x-explorer-enabled": false
}
```