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

# Returns the requested user

`GET /api/v4/activations/{activation_id}/users/{user_id}`

## Request

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

You must have access to the requested activation and user; otherwise a 401 is returned. The user is requested in the scope of an activation, then it must be the owner or the host of an activation the API user can manage (or) Users created by API user (or) Users who belong to your company or its branches.

## Path parameters

- `activation_id` integer, required
- `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)