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

# /registration/provision

Initiates email verification. Sends email to the user
    to confirm that the email is valid. The link in the email must be followed
    to complete the provisioning.

# 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/registration/provision": {
      "post": {
        "tags": [
          "Registration"
        ],
        "summary": "/registration/provision",
        "description": "Initiates email verification. Sends email to the user\n    to confirm that the email is valid. The link in the email must be followed\n    to complete the provisioning.",
        "operationId": "v2postProvisionAccount",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProvisionAccountDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OkResponseDTO"
                },
                "examples": {
                  "OkResponse": {
                    "$ref": "#/components/examples/OkResponse"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request<br/>126: Unverified user not found\n    <br/>115: User is already verified\n    <br/>422: Invalid input\n    <br/>240: Invalid email address\n    <br/>185: Labelpartner not specified for household\n    <br/>265: Unexpected exception while retrieving customer information\n    <br/>210: User not provisioned<br/>999: Unspecified Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDTO"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProvisionAccountDTO": {
        "required": [
          "email_address",
          "first_name",
          "last_name"
        ],
        "properties": {
          "email_address": {
            "description": "The email address of the user.",
            "type": "string"
          },
          "first_name": {
            "description": "The first name of the user.",
            "type": "string"
          },
          "last_name": {
            "description": "The last name of the user.",
            "type": "string"
          },
          "labelpartner": {
            "description": "The name of the labelpartner. Defaults to platform default labelpartner.",
            "type": "string"
          },
          "imported": {
            "description": "In case the imported flag is true then we expect the user to be already provisioned\n            and the call is used to verify the email. Defaults to false.",
            "type": "boolean",
            "default": false
          }
        },
        "type": "object"
      },
      "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"
      }
    },
    "examples": {
      "OkResponse": {
        "summary": "Success response",
        "value": {
          "status": "ok",
          "message": "ok"
        }
      }
    }
  },
  "tags": [
    {
      "name": "Registration"
    }
  ],
  "x-explorer-enabled": false
}
```