---
updatedAt: 2026-03-31T12:12:41.000Z
agentTools:
projectIndex: https://api.net2grid.com/llms.txt
---
# /billing/tariff-definition
Defines the tariff information of the user and the date since when they are to be applied.
# 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/billing/tariff-definition": {
"post": {
"tags": [
"Installation Profile"
],
"summary": "/billing/tariff-definition",
"description": "Defines the tariff information of the user and the date since when they are to be applied.",
"operationId": "v2postTariffDefinition",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostTariffDefinitionRequestDTO"
},
"examples": {
"PostTariffDefinitionExample": {
"$ref": "#/components/examples/PostTariffDefinitionExample"
},
"PostTariffDefinitionExample2": {
"$ref": "#/components/examples/PostTariffDefinitionExample2"
},
"PostTariffDefinitionExample3": {
"$ref": "#/components/examples/PostTariffDefinitionExample3"
}
}
}
}
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OkResponseDTO"
},
"examples": {
"OkResponse": {
"$ref": "#/components/examples/OkResponse"
}
}
}
}
},
"400": {
"description": "Invalid request
152: User does not have a valid household object
185: Labelpartner not specified for household
186: Cannot find a profile for this household
250: Unexpected exception while retrieving tariffs information
265: Unexpected exception while retrieving customer information
422: Invalid input
425: This call has been disabled for this user
999: Unspecified Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponseDTO"
}
}
}
}
},
"security": [
{
"bearerAuth": []
}
]
}
}
},
"components": {
"schemas": {
"ErrorDTO": {
"properties": {
"code": {
"type": "integer"
},
"message": {
"type": "string"
}
},
"type": "object"
},
"ErrorResponseDTO": {
"properties": {
"status": {
"type": "string"
},
"error": {
"$ref": "#/components/schemas/ErrorDTO"
}
},
"type": "object"
},
"OkResponseDTO": {
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string"
},
"message": {
"type": "string"
}
},
"type": "object"
},
"PostTariffDefinitionRequestDTO": {
"required": [
"tariff_definition"
],
"properties": {
"tariff_definition": {
"$ref": "#/components/schemas/TariffDefinitionDTO"
},
"reset_future_definitions": {
"description": "This flag should be enabled when the provided definition should overwrite any existing definitions that may be applicable for the user and are later in time than the provided timestamp in applicable_since field.",
"type": "boolean",
"default": "false",
"nullable": true
}
},
"type": "object"
},
"TariffDefinitionDTO": {
"description": "Tariff values for the user. The tariff values fetched from this API are expected to have up to 6 decimal digits.",
"properties": {
"electricity_yearly_fixed_cost": {
"description": "The annual fixed cost for electricity. Defaults to 0.",
"type": "number",
"default": "0"
},
"electricity_tariff": {
"description": "The tariff for electricity consumed from the grid. The applicable unit of measure is configured on the labelpartner of the user. In case the user is billed based on tiers it should be set to relevant value that will be used in results that apply to events or refer to total consumptions. Defaults to 0.",
"type": "number",
"default": "0"
},
"electricity_tariff_tier_1": {
"description": "Τhe tariff for electricity consumed from the grid from tier-1. Tier-1 is either day or night depending on the platform.",
"type": "number",
"default": "0"
},
"electricity_tariff_tier_2": {
"description": "Τhe tariff for electricity consumed from the grid from tier-2. Tier-2 is either day or night depending on the platform.",
"type": "number",
"default": "0"
},
"feedin_tariff": {
"description": "Τhe tariff for the amount of electricity produced and returned to the grid. The unit of measure is the electricity unit configured on the labelpartner of the user. In case the user is billed based on tiers it should be set to a relevant value that will be used in results that apply to events or refer to total consumptions and tier values cannot be calculated.",
"type": "number",
"default": "0"
},
"feedin_tariff_tier_1": {
"description": "Τhe electricity tariff for electricity produced and returned to the grid for tier-1. Tier-1 is either day or night depending on the platform.",
"type": "number",
"default": "0"
},
"feedin_tariff_tier_2": {
"description": "Τhe electricity tariff for electricity produced and returned to the grid for tier-2. Tier-2 is either day or night depending on the platform.",
"type": "number",
"default": "0"
},
"gas_yearly_fixed_cost": {
"description": "The annual fixed cost for gas.",
"type": "number",
"default": "0"
},
"gas_tariff": {
"description": "The tariff for gas consumed. The applicable unit of measure is configured on the labelpartner of the user.",
"type": "number",
"default": "0"
},
"applicable_since": {
"description": "The point in time when the provided tariff definition becomes valid in ISO-8601 format. If not specified defaults to 2000-01-01T00:00:00Z.",
"type": "string",
"default": "2000-01-01T00:00:00Z"
}
},
"type": "object"
}
},
"examples": {
"OkResponse": {
"summary": "Success response",
"value": {
"status": "ok",
"message": "ok"
}
},
"PostTariffDefinitionExample": {
"summary": "Post tariff definition body",
"value": {
"tariff_definition": {
"electricity_yearly_fixed_cost": 200,
"electricity_tariff": 20,
"electricity_tariff_tier_1": 0.13254,
"electricity_tariff_tier_2": 0.126432,
"feedin_tariff": 0.144,
"feedin_tariff_tier_1": 0.1234,
"feedin_tariff_tier_2": 0.145432,
"gas_yearly_fixed_cost": 400,
"gas_tariff": 0.234562,
"applicable_since": "2020-10-10T00:00:00Z"
},
"reset_future_definitions": true
}
},
"PostTariffDefinitionExample2": {
"summary": "Post tariff definition body without providing reset_future_definitions",
"value": {
"tariff_definition": {
"electricity_yearly_fixed_cost": 200,
"electricity_tariff": 20,
"electricity_tariff_tier_1": 0.13254,
"electricity_tariff_tier_2": 0.126432,
"feedin_tariff": 0.144,
"feedin_tariff_tier_1": 0.1234,
"feedin_tariff_tier_2": 0.145432,
"gas_yearly_fixed_cost": 400,
"gas_tariff": 0.234562,
"applicable_since": "2020-10-10T00:00:00Z"
}
}
},
"PostTariffDefinitionExample3": {
"summary": "Post tariff definition body with missing arguments",
"value": {
"tariff_definition": {
"electricity_yearly_fixed_cost": 350,
"electricity_tariff": 0.222423,
"feedin_tariff": 0.245123
},
"reset_future_definitions": ""
}
}
},
"securitySchemes": {
"bearerAuth": {
"type": "http",
"bearerFormat": "JWT",
"scheme": "bearer"
}
}
},
"tags": [
{
"name": "Installation Profile"
}
],
"x-explorer-enabled": false
}
```