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

# Get a user by id

`GET /users/{user_id}`

This method returns the user that matches the entered ID.

## Path parameters

- `user_id` integer, required

## Response `200`

User object

- User
  - `created_by` integer, required
  - `created_on` string, date-time, required
  - `id` integer, required
  - `is_api` boolean, required
  - `key_handle` string, nullable
  - `last_request` integer, nullable
  - `pub_key` string, nullable
  - `role` union, required
    - 'ADMIN' | 'ADMIN_SYSTEM' | 'OPERATOR' | 'SHARED_OWNER' | 'WRAPPING_KEYS'
    - 'READ_ONLY_API_KEY'
  - `status` union, required
    - 'ACCESS_SUSPENDED' | 'ACTIVE' | 'APPROVED' | 'PENDING_APPROVAL' | 'PENDING_REGISTRATION' | 'PENDING_REVOCATION' | 'REJECTED' | 'REVOKED'
    - 'ABORTED' | 'ACTIVE' | 'PENDING_APPROVAL' | 'PENDING_SECRET' | 'REVOKED' | 'SUSPENDED'
  - `user_id` string, nullable
  - `username` string, required

## Other responses

- `404` — User not found

---

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