> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Users

> Syteca Data Connector REST API endpoint to retrieve the list of users — returns each user's ID and name.

Returns the full list of Syteca users visible to the API key — each user's ID and display name. Used for translating user IDs returned by other endpoints (like [`GET /sessions`](/docs/api/data-connector/endpoints/get-sessions)) into human-readable names.

```http theme={"system"}
GET https://<hostname>/ekranapi/user
```

## Authentication

<ParamField header="ApiKey" type="string" required>
  Your Active API Key from the Management Tool. See [Manage → Get an API key](/docs/api/data-connector/manage#get-an-api-key).
</ParamField>

## Query parameters

*This endpoint takes no query parameters — the response always contains the full list of users visible to the API key's user.*

## Response (200 OK)

<ResponseField name="item1" type="int32">
  The ID of the user.
</ResponseField>

<ResponseField name="item2" type="string">
  The user name.
</ResponseField>

<Note>
  The `item1` / `item2` field names reflect the API's underlying .NET Tuple serialization — preserved verbatim in the response. Same shape as [`GET /client`](/docs/api/data-connector/endpoints/get-clients).
</Note>

## Example

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET https://<hostname>/ekranapi/user \
    -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  [
    {
      "item1": 234,
      "item2": "username1"
    },
    {
      "item1": 13,
      "item2": "username2"
    }
  ]
  ```
</ResponseExample>

## Errors

See [Status codes](/docs/api/data-connector/api-reference#status-codes). Common errors:

* **403 Forbidden** — Data Connector not registered. See [Deactivate](/docs/api/data-connector/manage#deactivate-the-data-connector).
* **503 Service Unavailable** — Application Server stopped or unreachable.

## Related

<CardGroup cols={2}>
  <Card title="User productivity" icon="user-check" href="/docs/api/data-connector/endpoints/get-user-productivity">
    Total active time per user, per hour, per day.
  </Card>

  <Card title="List sessions with productivity" icon="bar-chart-3" href="/docs/api/data-connector/endpoints/post-sessions">
    Per-session info — includes user IDs that this endpoint can translate.
  </Card>

  <Card title="API reference" icon="square-code" href="/docs/api/data-connector/api-reference">
    Base URL, authentication, status codes.
  </Card>
</CardGroup>