---
title: "Returns the requested user"
method: GET
path: "/api/v4/partner/users/{user_id}"
tags: ["Users"]
---

# Returns the requested user

`GET /api/v4/partner/users/{user_id}`

## Request

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

You must have permission to view the user. You can view yourself, users you created, and users who belong to your company or its branches. In all other cases, a 401 is returned. Company details are provided in the response only if 'expand' parameter is passed in the URL with value as company. Otherwise, company information will not be provided in the response.

## Path parameters

- `user_id` integer, required

## Query parameters

- `expand` 'company'

## Response `200`

OK

- object
  - `active` boolean: Whether the user is allowed to log in to Enlighten
  - `user_roles` string[]: What type of user this is in Enlighten. Possible values are ['self_installer']. For self installer user user_roles will be ['self_installer']. For other users user_roles will be empty.
  - `email` string: The email address of the user
  - `enlighten_emails` boolean: Whether the user receives automated emails from Enlighten
  - `enlighten_view` string: Which view of Enlighten the user has
  - `first_name` string: The user's first name
  - `last_name` string: The user's last name
  - `phone` string: The telephone number of the user
  - `uri` string: URI to the show() method for the user. System-generated
  - `user_id` integer: The Enlighten ID of the user. System-generated
  - `updated_at` integer: Last updated date and time in Epoch format
  - `company` object
    - `company_id` integer: The Enlighten-generated ID of the company to which the user belongs
    - `company_name` string: Name of the company to which the user belongs
    - `location` string: Company location
    - `roles` string[]: What type of company this is in Enphase. Possible values are ['installer']. For installer company roles will be ['installer']. For other role roles will be empty.
    - `uri` string: URI to the show() method for the company. System-generated

## Other responses

- `401`: Unauthorized
- `404`: Not found
- `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)