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

# List email-only users

`GET /v1/users/email-only`

List email-only users and their user attributes. Supports pagination and filtering.

## Query parameters

- `email` string
- `cursor` string
- `pageSize` integer
- `sortDirection` 'asc' | 'desc'

## Response `200`

Paginated list of email-only users

- object
  - `pageInfo` PageInfo — Pagination information for paginated responses.
    - `hasNextPage` boolean — Indicates if there are more records available.
    - `nextCursor` string, nullable — Cursor for the next page of results. `null` if no more results.
    - `pageSize` integer — Number of records per page.
    - `totalRecords` integer — Total number of records matching the query.
  - `records` object[]
    - `email` string, email — User's email address
    - `user_id` string, uuid — User's membership ID
    - `user_attributes` object — Key-value map of user attributes, including system attributes like `omni_user_email`, `omni_user_name`, `omni_user_id`, `omni_is_org_admin`, plus any custom attributes.

## Other responses

- `400` — Bad Request - Invalid parameters or request body
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions
- `500` — Internal Server Error

---

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