Get User

Retrieve a user by ID. Admins can view any user; regular users can only view their own profile.

GET /api/users/{user_id}

Returns the full profile for a single user. Administrators can retrieve any user. Non-admin users can only retrieve their own profile — requests for another user’s ID will receive a 403 Forbidden response.

Authentication

Requires a valid Bearer access token.

Authorization: Bearer <access_token>

Path Parameters

user_id · integer · required

The ID of the user to retrieve.

Response

success · boolean

true when the request succeeds.

data · object

Show data

id · integer

Unique identifier for the user.

username · string

The user’s unique username.

email · string

The user’s email address.

first_name · string

The user’s first name.

last_name · string

The user’s last name.

full_name · string

Concatenation of first_name and last_name. Falls back to username if names are not set.

is_active · boolean

Whether the user account is currently active.

role · object

Show role

id · integer

Role identifier.

name · string

Role name. Either admin or user.

description · string

Human-readable description of the role.

created_at · string

ISO 8601 timestamp of when the user was created.

updated_at · string

ISO 8601 timestamp of the last update to the user record.

Errors

Status	Description
401	Missing or invalid access token.
403	The authenticated user is not an admin and is requesting a different user’s profile.
404	No user exists with the given user_id.

Example

curl -X GET "https://task-forge-gbd6h8gtg8hchve9.chilecentral-01.azurewebsites.net/api/users/42" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

{
  "success": true,
  "data": {
    "id": 42,
    "username": "jdoe",
    "email": "[e-mail]",
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "is_active": true,
    "role": {
      "id": 2,
      "name": "user",
      "description": "Standard user"
    },
    "created_at": "2024-01-15T10:30:00",
    "updated_at": "2024-03-01T08:12:45"
  }
}