# GET Get Users

```
 https://api.swaycharts.io/dxsca-web/users/{username}
```

Retrieve information for a specified user of for a list of users matching query

Users can always view details about themselves, but can only view details of other users if a special permission is set.

```
// Request

Empty request

Authorization header should be included in case of basic authentication

// Path Parameters

username - full username (URL encoded) in a username@domain format. Wildcards are not supported. Optional value, if omitted, all accessible users will be returned (filtered according to request parameters).

// Query Parameters 

The following parameters are supported to filter and limit users:

limit (optional) - maximum number of users to be returned. Maximum possible value is server-configured; if a larger value is specified, the maximum value is used.
start-from (optional) - indicates the starting index of a user in a response to return. Default value is 0. To use paging set the limit and start-from parameters. Ex. for the limit=10&start-from=100 query the results page will contain users from 101st to 110th.
last-updated-from - time of last user's update in UTC since which to include users. Inclusive. See Dates & Times.
last-updated-to - time of last user's update in UTC till which to include users. By default current timestamp is assumed. See Dates & Times.

// Response

A list of user details that match the request

The ETag header is sent only if a single user is requested.

// Errors

Common errors

API is not permitted for the user

Status code: 404 Not Found
Error code: 2
Description: Entity not found at server
Request URI is malformed (cannot be matched with query criteria)

Status code: 400 Bad Request
Error code: 31
Description: Malformed query URI
Request URI is malformed (request parameters are incorrect; limit or start-from are negative)

Status code: 400 Bad Request
Error code: 32
Description: Incorrect request parameters (<request parameter that was incorrect>)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sway-technologies.gitbook.io/sway-charts-api-documentation/rest-api-specification/users-and-accounts/get-get-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.