---
title: "List users for a sub-organization."
method: GET
path: "/print-mail/v1/sub_organizations/{id}/users"
tags: ["Sub-Organizations"]
---

# List users for a sub-organization.

`GET /print-mail/v1/sub_organizations/{id}/users`

## Path parameters

- `id` string, required

## Query parameters

- `skip` integer
- `limit` integer
- `search` union
  - string
  - string — You can supply a structured search query instead of supplying unstructured text to any list endpoint help refine your search for a resource. For example, let's say you created a series of letters that all had `metadata: { campaignID: 'abc' }`. You could search for all those letters by passing in `{ "metadata.campaignID": "abc" }` into the `search` parameter. Note that this string must be valid JSON.

## Response `200`

The request has succeeded.

- UserWithoutAPIKeys[]
  - `id` string, required — A unique ID prefixed with `user_`.
  - `organization` string, required — A unique ID prefixed with `user_`.
  - `pendingInvite` boolean, required — Indicates if the user has a pending invite.
  - `email` string, required — The email of the user.
  - `name` string, required — The name of the user.
  - `phoneNumber` string — The phone number of the user.
  - `lastLoginTime` string, date-time — The date and time at which the user last logged in.
  - `verifiedEmail` boolean, required — Indicates if the user has a verified email or not.
  - `roles` string[], required — The roles given to the user. Roles can be used to restrict access for users.
  - `previousEmails` string[] — A list of emails the user has previously had. If a user has changed their email before, this list will be populated with all of the emails they once had.
  - `emailPreferences` EmailPreferences — A set of preferences for how a user should receive emails.
    - `orderPreviewSendPreference` 'do_not_send' | 'send_live_only' | 'send_live_and_test' — The list of preferences for receiving order preview emails.

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/revisions/537d2bbc624a/schema)