--- title: "List of Activations" method: GET path: "/api/v4/partner/activations" tags: ["Activations"] --- # List of Activations `GET /api/v4/partner/activations` ## Request - Base URL: `https://api-qa2.enphaseenergy.com` - URL: `https://api-qa2.enphaseenergy.com/api/v4/partner/activations` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns a list of activations for which the user can make API requests. There is a limit to the number of activations which can be returned at one time. If the first request does not return a full list, use the 'next' attribute in the response body to request the next page. By default, activations are returned in batches of 100. The maximum page size is 1000. Provide only valid filters. During filter the activations empty and invalid filter fields are ignored. In case the installer ID doesn’t exist, API will return an empty array. ## Query parameters - `next` string - `limit` integer - `stage` string - `reference` string - `installer_id` integer - `system_name` string - `city` string - `state` string - `country` string - `postal_code` string - `street1` string - `street2` string - `host_id` integer - `owner_id` integer ## Response `200` OK - object - `systems` object[]: Zero or more activations - `system_id` integer: The Enlighten ID of this system. System-generated - `system_name` string: The name of the system. - `system_type` string: The type of the system. One of 'residential', 'commercial', or 'other'. Default 'residential'. Cannot be null. - `status` string: System's status. - `timezone` string: System's timezone. - `stage` integer: What stage of the activation process this activation is in. System-generated. - `internet_connection` string: How the system's Envoys connect to the Internet. Possible values are none, cellular, broadband, dialup. Use 'dialup' if the Internet connection is satellite or dial-up - `lease` boolean: Whether the system is leased. Possible values true, false. Default false - `operational` boolean: Whether this system is permitted to operate. Possible values true, false. Default true - `owner` string: Name of the system owner. Owner must be an Enlighten user. If the user of the API is a self-installer, the owner must be himself - `owner_id` integer: The Enlighten ID of this system owner. System-generated - `host` string: Name of the system host. Please see “Specifying an Owner and Lease Arrangement”, above, for more information. - `host_id` integer: The Enlighten ID of this system host. System-generated - `installer_name` string: Name of the installer. - `installer_id` integer: The Enlighten ID of the installer of this system - `maintainer_name` string: Name of the maintainer. - `maintainer_id` integer: The Enlighten ID of the maintainer of this system - `authorized_subcontractors` object[]: List of sub-contractors of this system. - `authorized_subcontractor_id` integer: The Enlighten ID of the sub-contractor of this system. System-generated. - `authorized_subcontractor_name` string: Name of the sub-contractor of this system. - `status` string: Current status of the subcontractor for the site. This field will be shown only for pending and rejected sub-contractors. - `grid_connection_type` object: Possible values for parameter: 1 – Net Billing Tariff (NEM 3.0), 2 – Net Metering, 3 – Net Feed-in tariff, 4 – Gross Feed-in tariff, 5 – Solar and/or Storage (with utility service), 6 – Full Off‑Grid (without utility service), 7 – Legacy: Net Metering Tariff, 8 – Legacy: Net Metering Tariff (with Hourly Dynamic Pricing), 9 – Smart Solar Billing, 10 – Smart Solar Billing (with Hourly Dynamic Pricing) - `type` integer - `value` string - `battery_grid_mode` string: Battery grid mode can be of two types - Export Only, Import Only - `third_party_storage_device_installed` boolean: If third party storage device is installed on the site. - `third_party_storage_device_manufacturer` string: Manufacturer name of the third party storage device. - `interconnection_application_date` integer: Date in epoch format - `permission_to_operate` boolean: boolean (true / false) - `uri` string: URI for this activation - `updated_at` integer: Activation last updated timestamp - `reference` string: The identifier of this system as provided by the calling user's company. This attribute is not present if the calling user's company does not have a reference for this system. - `other_references` string[]: The identifiers assigned to this activation by other companies which have access to it. This attribute is not present if there are no other references for this system. - `address` object: The location of the system. Use the ISO 3166-1 2-letter code for the country. Latitude and longitude are calculated by Enlighten, not provided by the client - `street1` string: Street line 1 - `city` string: City - `state` string: State - `postal_code` string: Postal code - `country` string: Country - `latitude` integer: Latitude - `longitude` integer: Longitude - `street2` string: Street line 2. This field is Optional - `next` string: If the first request does not return a full list, use the 'next' attribute in the response body to request the next page. By default, activations are returned in batches of 10. The maximum page size is 1000 ## Other responses - `401`: Unauthorized - `405`: Method Not Allowed - `422`: Unprocessable entity. The body contains error information in a hash of errorMessages and an optional errorCode - `429`: Too Many Requests - `501`: Not Implemented --- [API](https://skmtc.dev/enphase/apis/commissioning-api.md) - [All operations](https://skmtc.dev/enphase/apis/commissioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/commissioning-api/revisions/73a4001046e2?raw)