---
title: "List"
method: GET
path: "/api/v1/apps/{app_id}/app_users"
tags: ["AppUsers"]
---

# List

`GET /api/v1/apps/{app_id}/app_users`

List app user accounts within a specific app, with pagination support.

## Path parameters

- `app_id` string, required — The ID of the app to list users for.

## Query parameters

- `page_size` integer — The maximum number of results to return per page.
- `page_token` string — The token for fetching the next page of results.

## Response `200`

The response message for listing app users.

- C1ApiAppV1AppUserServiceListResponse — The response message for listing app users.
  - `expanded` object[], nullable — List of serialized related objects.
    - `@type` string — The type of the serialized message.
  - `list` C1ApiAppV1AppUserView[], nullable — The list of app user results.
    - `appPath` string — JSONPATH expression indicating where the app is expanded in expanded arrays indicated in the request.
    - `appUser` C1ApiAppV1AppUser — Application User that represents an account in the application.
      - `agentStatus` 'APP_USER_AGENT_STATUS_UNSPECIFIED' | 'APP_USER_AGENT_STATUS_READY' | 'APP_USER_AGENT_STATUS_DISABLED' | 'APP_USER_AGENT_STATUS_DELETED' — AI-agent lifecycle status when this app user carries the agent trait. UNSPECIFIED marks a non-agent account. Read-only; translated from the model's agent_trait at the API boundary.
      - `appId` string — The ID of the application.
      - `appUserType` 'APP_USER_TYPE_UNSPECIFIED' | 'APP_USER_TYPE_USER' | 'APP_USER_TYPE_SERVICE_ACCOUNT' | 'APP_USER_TYPE_SYSTEM_ACCOUNT' — The appplication user type. Type can be user, system or service.
      - `createdAt` string, date-time, nullable
      - `deletedAt` string, date-time, nullable
      - `displayName` string — The display name of the application user.
      - `email` string — The email field of the application user.
      - `emails` string[], nullable — The emails field of the application user.
      - `employeeIds` string[], nullable — The employee IDs field of the application user.
      - `id` string — A unique idenditfier of the application user.
      - `identityUserId` string — The conductor one user ID of the account owner.
      - `isExternal` boolean — The isExternal field.
      - `nhiDetail` string — Axis-2 detail refining nhi_type (e.g. "aws.role.lambda"). Read-only.
      - `nhiType` 'APP_USER_NHI_TYPE_UNSPECIFIED' | 'APP_USER_NHI_TYPE_APP_REGISTRATION' | 'APP_USER_NHI_TYPE_ASSUMABLE_ROLE' | 'APP_USER_NHI_TYPE_MANAGED_IDENTITY' — NHI classification when this app user carries the non-human-identity trait. Read-only; translated from the model's nhi_trait at the API boundary.
      - `profile` object, nullable
      - `status` C1ApiAppV1AppUserStatus — The satus of the applicaiton user.
        - `details` string — The details of applicaiton user status.
        - `status` 'STATUS_UNSPECIFIED' | 'STATUS_ENABLED' | 'STATUS_DISABLED' | 'STATUS_DELETED' — The application user status field.
      - `updatedAt` string, date-time, nullable
      - `username` string — The username field of the application user.
      - `usernames` string[], nullable — The usernames field of the application user.
    - `identityUserPath` string — JSONPATH expression indicating where the identity user is expanded in expanded arrays indicated in the request.
    - `lastUsagePath` string — JSONPATH expression indicating where the last usage information is expanded in expanded arrays indicated in the request.
  - `nextPageToken` string — The token for fetching the next page of results.

## Changes

> 33 revisions in range; 1 could not be searched.

- **2025-04-10** `17f9f3bcedd5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/apps/:app_id/app_users/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)