# Get user by username

Retrieves a user profile by username. Supports both local usernames and federated usernames (user@domain format). Accessible to both authenticated and guest users. If the username was recently changed, returns a 302 redirect to the new username. Use the 'full' parameter to include extended profile data. Authenticated users can request relationship statuses.

Endpoint: GET /api/v1/users
Version: 1.0
Security: 

## Query parameters:

  - `full` (boolean,null)
    If true return also summary, stats, header and fields. Default false.

  - `includeBlockedByStatus` (boolean,null)
    Include blocked_by status (target blocked viewer)

  - `includeBlockedStatus` (boolean,null)
    Include blocked status (viewer blocked target)

  - `includeFollowedStatus` (boolean,null)
    Include followed status

  - `includeFollowingStatus` (boolean,null)
    Include following status

  - `includeMutedStatus` (boolean,null)
    Include muted status

  - `relations` (boolean,null)
    Include all relationship statuses (following, followed, blocked, blocked_by, muted)

  - `username` (string, required)
    Username to look up. Supports local ('alice') or federated ('alice@remote.social') format.

  - `htmlContent` (any)
    Returns text as html if true or original text if false. Applicable only to local posts and users. Default is true.

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation