---
title: "List Users"
method: GET
path: "/v1/users"
tags: ["BackendService"]
---

# List Users

`GET /v1/users`

List Users.

## Query parameters

- `organizationId` string
- `pageToken` string

## Response `200`

OK

- ListUsersResponse
  - `users` User[] — A list of Users.
    - `id` string — The User ID. Starts with `user_...`.
    - `organizationId` string — The Organization this User belongs to.
    - `email` string — The User's email address. This email is verified and unique within the Organization. Two Users in different Organizations may have the same email.
    - `createTime` string, date-time — When the User was created.
    - `updateTime` string, date-time — When the User was last updated.
    - `owner` boolean — Whether the User is an owner of their Organization.
    - `googleUserId` string — The Google User ID, if the User has ever logged in with Google.
    - `microsoftUserId` string — The Microsoft User ID, if the User has ever logged in with Microsoft.
    - `githubUserId` string — The Github User ID, if the User has ever logged in with GitHub.
    - `hasAuthenticatorApp` boolean — Whether the User has an authenticator app set up.
    - `displayName` string — The User's human-friendly name.
    - `profilePictureUrl` string — The URL of the User's profile picture.
  - `nextPageToken` string — The pagination token for the next page of results. Empty if there is no next page.

## Other responses

- `400` — API Error
- `401` — API Error
- `403` — API Error
- `404` — API Error

---

[API](https://skmtc.net/tesseral-labs/apis/backendservice-api.md) · [All operations](https://skmtc.net/tesseral-labs/apis/backendservice-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tesseral-labs/backendservice-api/versions/fe83f78ae20a/schema)