User Account Details

Shows details for a user account.

Requirements

A username is required (for example): collis.

Usage

Request

Method: GET Path: /users/{username}

Example

curl -X GET "https://api.example.com/users/collis"

Path Parameters

| Name | Type | Required | Description | |----------|--------|----------|------------------------------| | username | string | Yes | The user’s unique username. |

Response

200 OK

Returns a standard API envelope with the user details in

Example Success Response

{data:{
{
  "status": true,
  "path": "/users/collis",
  "statusCode": 200,
  "message": "User account details fetched successfully",
  "data": {
    "sub": "user_123",
    "email": "collis@example.com",
    "first_name": "Collis",
    "last_name": "Ta'eed",
    "user_title": "Designer",
    "location": "Melbourne, AU",
    "avg_rating": 4.9,
    "total_reviews": 128,
    "type": "seller",
    "member_since": "2026-03-09T06:28:42.413Z",
    "last_active": "2026-03-09T06:40:10.000Z",
    "profile_completion": 92,
    "badges": [
      {
        "badge_icon": "https://cdn.example.com/badges/top-rated.svg",
        "badge_name": "Top Rated",
        "badge_description": "Maintains a high rating over time."
      }
    ],
    "seller_info": {
      "seller_level": "Level 2",
      "success_rate": "98%",
      "response_time": "1 hour"
    }
  }
}}

Error Responses

400 Bad Request

Returned when username is missing/invalid.

Example:

{
  "status": false,
  "path": "/users/",
  "statusCode": 400,
  "message": "username is required",
  "data": null
}

404 Not Found

Returned when no user exists with the given username.

Example:

{
  "status": false,
  "path": "/users/collis",
  "statusCode": 404,
  "message": "User not found",
  "data": null
}