---
title: "Retrieves a System by id"
method: GET
path: "/api/v4/systems/{system_id}"
tags: ["System Details"]
---

# Retrieves a System by id

`GET /api/v4/systems/{system_id}`

## Request

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

Retrieves a System by ID

## Path parameters

- `system_id` integer, required

## Response `200`

System fetched

- object
  - `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
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `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)