---
title: "Fetch a User by ID"
method: GET
path: "/users/{user_id}"
tags: ["Users"]
---

# Fetch a User by ID

`GET /users/{user_id}`

Retrieve the details of an existing `User`.

## Headers

- `Finix-Version` string

## Response `200`

A single `User`

- User
  - `id` string — The ID of the resource.
  - `created_at` string, date-time — Timestamp of when the object was created.
  - `updated_at` string, date-time — Timestamp of when the object was last updated.
  - `created_by` string — The ID of the application user that created _this_ user.
  - `email` string — The email address of the application user (max 100 characters).
  - `enabled` boolean — Whether the `User` is enabled and active. Set to `false` to disable the `User`.
  - `first_name` string, nullable — The first name of the User ID (Max 50 characters).
  - `identity` string, nullable — ID of the `Identity` that the `User` object was created under.
  - `last_name` string, nullable — The last name of the User ID (Max 50 characters).
  - `last_used_date` string, date-time — Timestamp of when the user credentials were last used to make an API call.
  - `password` string, nullable — The `password` you'll use to authetnicate requests.
  - `role` 'ROLE_PLATFORM' | 'ROLE_PARTNER' | 'ROLE_MERCHANT' — Details the level of access the [`User`](#Users) has available.
  - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
  - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.
    - `application` object — Link to the `Application` the resource was created under.
      - `href` string
    - `applications` object
      - `href` string
    - `self` object — Link to the resource that was used in the request.
      - `href` string

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)