---
title: "List email-only users"
method: GET
path: "/api/v1/users/email-only"
tags: ["Users"]
---

# List email-only users

`GET /api/v1/users/email-only`

## Query parameters

- `cursor` string — Cursor for pagination
- `email` string — Filter by email address
- `pageSize` number — Number of results per page (max 20)
- `sortDirection` 'asc' | 'desc' — Sort direction for results

## Response `200`

Paginated list of email-only users

- UsersListEmailOnlyResponse
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether more results are available
    - `nextCursor` string, nullable, required — Cursor for fetching the next page
    - `pageSize` number, required — Number of results per page
    - `totalRecords` number, required — Total number of records matching the query
  - `records` object[], required
    - `email` string, required — User email address
    - `user_attributes` object, required — User attributes as key-value pairs
    - `user_id` string, uuid, required — User ID

## Other responses

- `401` — Authentication required
- `403` — Permission denied - admin role required

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)