---
title: "List SOCKS5 users"
method: GET
path: "/connect/users"
tags: ["Users"]
---

# List SOCKS5 users

`GET /connect/users`

Returns SOCKS5 users owned by the caller. Passwords are omitted from the list.

## Query parameters

- `page` integer
- `pageSize` integer
- `proxyId` string, uuid

## Response `200`

The caller's SOCKS5 users, without credentials.

- UserList — A page of SOCKS5 users.
  - `items` User[], required
    - `createdAt` string, date-time, required
    - `id` string, uuid, required
    - `proxyId` string, uuid, nullable — The proxy this user routes to (dedicated routing), or null if unbound.
    - `username` string, required
  - `pagination` PaginationMeta1, required — Pagination metadata for a list response.
    - `hasNext` boolean, required — Whether a next page exists.
    - `hasPrev` boolean, required — Whether a previous page exists.
    - `page` integer, required — Current page number (1-based).
    - `pageSize` integer, required — Number of items per page.
    - `pages` integer, required — Total number of pages.
    - `total` integer, required — Total number of items across all pages.

## Other responses

- `401` — The X-User-ID header was missing or invalid, or a present X-Owner-Id header was not a uuid.

## Changes

- **2026-07-08** `6d835ec1e768` — 1 info
  - the endpoint scheme security `OwnerIDHeader AND UserIDHeader` was added to the API
- **2026-07-01** `1229ad911e2e` — 2 info
  - api tag `Users` added
  - api tag `users` removed
- **2026-06-05** `49b7fa16d8f6` — 1 info
  - endpoint added
- **2026-05-30** `51d2493ba0f4` — 1 breaking
  - api path removed without deprecation
- **2026-05-30** `d06ce0f3c00d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/connect/users/get.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/3183ec3153d1/schema)