---
title: "Retrieve system for a given envoy serial number"
method: GET
path: "/api/v4/systems/retrieve_system_id"
tags: ["System Details"]
---

# Retrieve system for a given envoy serial number

`GET /api/v4/systems/retrieve_system_id`

## Request

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

Get system ID by passing envoy serial number. If the serial number of a retired envoy is passed in the request param, a 404 Not Found response will be returned.

## Query parameters

- `serial_num` string, required

## Response `200`

search_system_id

- object
  - `system_id` integer: The unique numeric ID of the system

## Other responses

- `401`: Authentication Error
- `404`: Not Found
- `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)