---
title: "Fetch systems"
method: GET
path: "/api/v4/systems"
tags: ["System Details"]
---

# Fetch systems

`GET /api/v4/systems`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of systems for which the user can make API requests. By default, systems are returned in batches of 10. The maximum size is 100.

## Query parameters

- `page` integer
- `size` integer
- `sort_by` 'id' | '-id'

## Response `200`

List of Systems

- object
  - `total` integer: Total number of systems
  - `current_page` integer: Number of the current page fetched
  - `size` integer: Maximum number of records shown per page. Default=10, Min=1, Max=100.
  - `count` integer: Total number of systems actually returned for the current page
  - `items` string: Named key of the list data. In this endpoint, it is systems
  - `systems` object[]: List of systems. It contains the following:
    - `system_id` integer: The unique numeric ID of the system
    - `name` string: Name of the system
    - `public_name` string: Name displayed on the public system page. Available values are All, Residential System, Commercial etc. Default='Residential System'. Only for systems that allow public access.
    - `timezone` string: Timezone to which the system belongs
    - `address` object: Address object for the system. It can contain the following items
      - `city` string: City in which the system is located
      - `state` string: State in which the system is located
      - `country` string: Country in which the system is located
      - `postal_code` string: Postal Code of the system's location
    - `connection_type` string: Connection Type of the system. Available values are ethernet, Wi-Fi, Cellular
    - `energy_lifetime` integer: Deprecated field. The API will always return this field as -1
    - `energy_today` integer: Deprecated field. The API will always return this field as -1
    - `system_size` number, float: Deprecated field. The API will always return this field as -1
    - `status` string: System's status. Corresponding Enlighten values can be found in table added at the end of page.
    - `stage` integer: Current stage of the system. Stage values indicate the system's progression through the activation process.
    - `last_report_at` integer: Timestamp (in epoch format) at which the system's Envoy last submitted a report
    - `last_energy_at` integer: Timestamp (in epoch format) at which the systems's produced energy was last reported. Even if the last produced energy is 0, its timestamp will be returned.
    - `operational_at` integer: Timestamp (in epoch format) at which this system became operational. Corresponds to the system’s interconnect time, if one is specified. Otherwise, it is the system’s first reported interval end time.
    - `attachment_type` string: Micro inverter attachment type. Available values are rack_mount, zep, acm, bipv, frame_mount, railless_mount
    - `interconnect_date` integer: Date on which the system was approved to connect to the grid
    - `reference` string: If the calling user belongs to a company and that company has provided its own identifier for a system, that ID is included here. Otherwise, this attribute is not returned.
    - `other_references` string[]: If any other companies have provided their own identifiers for a system, those identifiers are included here. Otherwise, this attribute is not returned.

## Other responses

- `401`: Authentication Error
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `501`: Not Implemented

---

[API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)