---
title: "Get users list with pagination and filters"
method: GET
path: "/admin/users"
tags: ["Admin Users"]
---

# Get users list with pagination and filters

`GET /admin/users`

Retrieve a paginated list of users with optional filtering by search terms and explicit content flag

## Query parameters

- `page` number
- `limit` number
- `search` string
- `useExplicitContent` boolean
- `isSubscribed` boolean
- `createdFrom` string
- `createdTo` string
- `isAnonymous` boolean
- `useGiftSuggestions` boolean
- `subscriptionSource` 'apple' | 'stripe' | 'funnelfox'
- `cardFirst6` string
- `cardLast4` string

## Response `200`

Users list retrieved successfully

- UsersListResponseDto
  - `users` UserListItemDto[], required — List of users
    - `id` string, required — User ID
    - `firebaseUserId` string, required — Firebase User ID
    - `email` string, nullable, required — Email
    - `phoneNumber` string, nullable, required — Phone number
    - `timezone` string, nullable, required — Timezone identifier (IANA)
    - `language` string, nullable, required — Preferred language (BCP-47 code)
    - `name` string, nullable, required — Display name
    - `fcmToken` string, nullable, required — FCM Token
    - `appAccountToken` string, nullable, required — App Account Token
    - `useExplicitContent` boolean, required — Use Explicit Content Flag
    - `isDeleted` boolean, required — Is Deleted Flag
    - `isAnonymous` boolean, required — Is Anonymous/Demo User Flag
    - `useGiftSuggestions` boolean, required — Gift suggestions A/B flag
    - `createdAt` string, date-time, required — Created At
    - `updatedAt` string, date-time, required — Updated At
    - `isSubscribed` boolean, required — Whether the user currently has an active subscription
    - `autoRenewal` boolean, nullable, required — Auto-renewal status of the latest subscription
    - `subscriptionSource` 'apple' | 'stripe' | 'funnelfox', nullable, required — Source of the subscription (apple, stripe, funnelfox)
  - `total` number, required — Total number of users
  - `page` number, required — Current page number
  - `limit` number, required — Number of items per page
  - `totalPages` number, required — Total number of pages

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)