---
title: "Query users"
method: GET
path: "/users"
tags: ["users", "query"]
---

# Query users

`GET /users`

Query users by a set of filters.

## Query parameters

- `username` string — Filter users by username.
- `email` string — Filter users by email address.
- `phoneNumber` string — Filter users by phone number in E.164 format.
- `token` string — Filter users by token.
- `limit` integer — The maximum number of users to return.
- `lastEvaluatedUserId` string — The user ID to start the query from. Use this for pagination by passing the `lastEvaluatedUserId` from the previous response.

## Response `200`

OK

- QueryUsersResponse
  - `users` QueryUsersResponseUser[] — The list of users matching the query.
    - `userId` string, required — The user's ID.
    - `email` string — The user's email address.
    - `phoneNumber` string — The user's phone number in E.164 format.
    - `username` string — The username used as the primary identifier for passkeys, e.g. an email address.
    - `displayName` string — The display name used as an optional secondary identifier for passkeys, e.g. the user's full name.
    - `isEnrolled` boolean — True if the user is enrolled with at least one verification method and can be challenged.
    - `enrolledVerificationMethods` VerificationMethod[] — The list of verification methods which the user has enrolled.
    - `createdAt` string, date-time — The time when the user was created.
  - `lastEvaluatedUserId` string — The user ID to use as the starting point for the next page of results. If not present, there are no more results.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/authsignal/apis/call-connect-api.md) · [All operations](https://skmtc.net/authsignal/apis/call-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/authsignal/call-connect-api/versions/5604d744e3ad/schema)