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

# /recommendations/monthly

Returns an array of recommendation attributes for the previous month.
    For the first 7 days, users receive demographic-based disaggregation reports and there are no personalized insights.
    During this period, only generic recommendations are sent, omitting deltaPerc and savingCostsKWh.

# 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/recommendations/monthly": {
      "get": {
        "tags": [
          "Recommendations"
        ],
        "summary": "/recommendations/monthly",
        "description": "Returns an array of recommendation attributes for the previous month.\n    For the first 7 days, users receive demographic-based disaggregation reports and there are no personalized insights.\n    During this period, only generic recommendations are sent, omitting deltaPerc and savingCostsKWh.",
        "operationId": "v2/getMonthlyRecommendations",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecommendationsReportResponseDTO"
                },
                "examples": {
                  "GetRecommendationsReportResponse": {
                    "$ref": "#/components/examples/GetRecommendationsReportResponse"
                  },
                  "GetRecommendationsReportFirstWeek": {
                    "$ref": "#/components/examples/GetRecommendationsReportFirstWeek"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request\n    <br/>122: Corrupted report.\n    <br/>156: User or meter validation failed..\n    <br/>190: No recommendations available.\n    <br/>424: Invalid time period or timezone.\n    <br/>999: Unspecified Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDTO"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "RecommendationsReportDTO": {
        "properties": {
          "id": {
            "description": "The id code of the recommendation.",
            "type": "string"
          },
          "deltaPerc": {
            "description": "This is the difference, as a percentage value, between the usage and the benchmark value.",
            "type": "number",
            "nullable": true
          },
          "potentialSavingsCost": {
            "description": "The consumption saving costs in KWh.",
            "type": "number",
            "nullable": true
          },
          "disaggregation_category": {
            "description": "The disaggregation category of the recommendation.",
            "type": "string"
          },
          "appliance": {
            "description": "Name of corresponding appliance.",
            "type": "string"
          },
          "action_type": {
            "description": "What type of action the recommendations is.",
            "type": "string"
          },
          "timestamp": {
            "description": "Timestamp of the recommendation creation in ISO 8601 format.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "RecommendationsReportResponseDTO": {
        "properties": {
          "status": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RecommendationsReportDTO"
            }
          },
          "timestamp": {
            "description": "Timestamp of the API response returned by the platform, in ISO 8601 format.",
            "type": "string"
          }
        },
        "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": {
      "GetRecommendationsReportResponse": {
        "summary": "Recommendations for a month/week.",
        "value": {
          "status": "ok",
          "data": {
            "id": "T360",
            "deltaPerc": 25,
            "potentialSavingsCost": 10,
            "disaggregation_category": "Refrigeration",
            "appliance": "Refrigeration",
            "action_type": "Behaviour",
            "timestamp": "2023-01-09T14:17:31+00:00"
          },
          "timestamp": "2023-01-09T14:17:31+00:00"
        }
      },
      "GetRecommendationsReportFirstWeek": {
        "summary": "Recommendations for first week.",
        "value": {
          "status": "ok",
          "data": {
            "id": "T360",
            "disaggregation_category": "Refrigeration",
            "appliance": "Refrigeration",
            "action_type": "Behaviour",
            "timestamp": "2023-01-09T14:17:31+00:00"
          },
          "timestamp": "2023-01-09T14:17:31+00:00"
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "bearerFormat": "JWT",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Recommendations"
    }
  ],
  "x-explorer-enabled": false
}
```