Enrolment State - Flatpeak

This page shows the status programme enrolment. It can be accessed from the VPP Summary page via the MANAGE_PARTICIPATION action. While the request is being processed, it moves through a series of states, from the initial request through to fully enrolled or unenrolled. Where supported, participation details can be updated before the request is finalised.

View Enrolment State Codes

Enrolment State Codes are used to track the progress of a customer’s request to join or leave a VPP programme and to track programme status.

#	State	Kind	Description
1	`ENROLMENT_REQUESTED`	transient	Enrolment request arrived, nothing provisioned yet.
2	`INITIALISING`	transient	Upserting site and assets, returning eligibility.
3	`ELIGIBILITY_CHECKING`	transient	Assessing site and assets against propositions.
4	`ELIGIBLE`	resting	Qualifies for one or more propositions, not yet committed.
5	`INELIGIBLE`	terminal	No matching proposition. Recoverable only if site properties change.
6	`METER_ACCESS_REQUIRED`	resting	Awaiting boundary meter access information from the customer.
7	`CONSENT_REQUIRED`	resting	Awaiting dispatch consent from the customer.
8	`PROVISIONING`	transient	Enrol called, provisioning and controllability checks running.
9	`AWAITING_TELEMETRY`	resting	Telemetry is not being received: either not yet established during onboarding (controllability unconfirmed, cannot activate) or lost after activation (not dispatchable). Moves to `ACTIVE` when telemetry arrives or resumes.
10	`ACTIVE`	resting	Dispatchable and participating in the market, receiving VPP events.
11	`SUSPENDED`	resting	Enrolled but temporarily not dispatchable. Returns to `ACTIVE` once resolved.
12	`UNENROLMENT_REQUESTED`	transient	Customer or operator has asked to leave.
13	`WINDING_DOWN`	transient	Serving notice, settling open rewards, removing dispatch consent.
14	`UNENROLLED`	resting	Out of the programme, records retained.
15	`OFFBOARDED`	terminal	Site and assets deleted.
16	`FAILED`	terminal	Provisioning broke mid flow, or telemetry never established during onboarding. Reachable from any transient state and from `AWAITING_TELEMETRY`.

Preview
Code

{
    "connect_token": "cot_6587fa4362341be5b524de3b",
    "route": "manage_participation",
    "timezone": "America/Denver",
    "currency_code": "USD",
    "live_mode": true,
    "actions": [
        "CANCEL",
        "BACK",
        "CLOSE"
    ],
    "programme": {
        "provider_id": "prv_8587fa49c7e5297ccc6c57e5",
        "provider_display_name": "Leap",
        "programme_id": "vpr_6a1f8e375db9de605baadd46",
        "programme_display_name": "Community Powershare",
        "learn_more_url": "https://leap.com/programmes/community-powershare"
    },
    "status": {
        "support_reference": "AZ01346701301",
        "support_email": "help@leap.com",
        "enrolment_state": [
            {
                "order": 1,
                "state": "UNENROLMENT_REQUESTED",
                "status": "COMPLETE",
                "description": "Unenrolment requested.",
                "date": "2026-05-02T11:12:21Z"
            },
            {
                "order": 2,
                "state": "WINDING_DOWN",
                "status": "IN_PROGRESS",
                "description": "Your device is no longer dispatching to new evens."
            },
            {
                "order": 3,
                "state": "UNENROLLED",
                "status": "PENDING",
                "description": "You will be unenrolled from the programme by",
                "date": "2026-06-02T11:12:21Z"
            }
        ]
    }
}

Actions

The following actions are supported when responding to Connect on this route:

Action	Result
`CANCEL`	Cancels the request to join or leave the programme.
`BACK`	Returns to the previous page. If there is none, returns `callback_url`.
`CLOSE`	Returns the `callback_url` you specified when creating the Connect token.

Enrolment State Codes (system tracking)

See top of page for the list of enrolment state codes. These are used to track the progress of a customer’s request to join or leave a VPP programme.

Enrolment Progress Status Codes

The following status codes indicate the processing status of a step:

Status	Description
`COMPLETE`	Step completed successfully.
`IN_PROGRESS`	Step is in progress.
`PENDING`	Step in queue.
`FAILED`	Step failed to complete.

Errors

When you POST your response to Connect, the following validation errors may be returned:

Error Code	Error Description
`data_json_invalid`	Data does not conform to the JSON schema.

​Actions

​Enrolment State Codes (system tracking)

​Enrolment Progress Status Codes

​Errors

Actions

Enrolment State Codes (system tracking)

Enrolment Progress Status Codes

Errors