---
title: "Get user"
method: GET
path: "/users/{user_id}"
tags: ["Users"]
---

# Get user

`GET /users/{user_id}`

Get details for a user.

## Path parameters

- `user_id` string, string, required

## Headers

- `Authorization` string, required
- `Pelm-Client-Id` string, required
- `Pelm-Secret` string, required

## Response `200`

Successful operation

- User
  - `id` string — This is the id specified by you when you initially created the Connect Token to connect this user's utility account.
  - `utility` Utility
    - `id` number
    - `full_name` string
  - `utility_username` string
  - `credentials_valid` boolean — Boolean field indicating whether the credentials we have for this User are valid. A common scenario that would cause this field to become false is the User changing their password. If this field is false, then we're unable to pull the latest data for this User, and your User needs to go through the Connect flow again.

## Other responses

- `400` — Client error
- `401` — Unauthorized
- `402` — Quota reached
- `403` — Permission denied
- `500` — Server error

---

[API](https://skmtc.net/pelm/apis/pelm-api.md) · [All operations](https://skmtc.net/pelm/apis/pelm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pelm/pelm-api/revisions/99451cd0e777/schema)