---
title: "Search for users in your organization"
method: GET
path: "/api/public/v1/user/search/list"
tags: ["UserResourceSearch"]
---

# Search for users in your organization

`GET /api/public/v1/user/search/list`

## Request

- Base URL: `https://allquiet.app` (the document declares no server; this is the origin it was published from)
- URL: `https://allquiet.app/api/public/v1/user/search/list`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/allquiet/apis/all-quiet-public-api/docs/api/public/v1/user/search/list/get.ts> (a function with typed inputs; its response is checked against the schema)

Only users provisioned in your organization are returned (created via Terraform, Public API, or SCIM). You cannot list users that are only associated by membership. For a single user reachable by membership only, use GET api/public/v1/user/search without the /list suffix. Supports paging (default limit 100, max 100).

**Required API key permissions**

- **Scope:** `users:list`
- **Accepted key types:** organization API key (org-wide), organization API key (team-scoped), personal access token (org-wide), personal access token (team-scoped)
- **Access:** Access is limited to the teams and organizations visible to the API key.
- **Notes:** Only users provisioned in organizations visible to the caller are returned. Unlike the single-user search, this list never includes users provisioned in the root organization when the key is bound to a sub-organization.

## Query parameters

- `Email` string
- `DisplayName` string
- `Offset` integer
- `Limit` integer

## Response `200`

OK

- AllQuietApiPublicUsersUserResourceListResponse
  - `users` AllQuietApiPublicUsersUserResourceResponse[], nullable
    - `id` string, uuid
    - `email` string, nullable
    - `userName` string, nullable
    - `displayName` string, nullable
    - `phoneNumber` string, nullable
    - `timeZoneId` string, nullable
    - `incidentNotificationSettings` AllQuietApiAuthenticationModelsIncidentNotificationSettings
      - `shouldSendSMS` boolean, nullable
      - `delayInMinSMS` integer, nullable
      - `severitiesSMS` string[], nullable
      - `shouldCallVoice` boolean, nullable
      - `delayInMinVoice` integer, nullable
      - `severitiesVoice` string[], nullable
      - `shouldSendPush` boolean, nullable
      - `delayInMinPush` integer, nullable
      - `severitiesPush` string[], nullable
      - `shouldSendEmail` boolean, nullable
      - `delayInMinEmail` integer, nullable
      - `severitiesEmail` string[], nullable
      - `phoneNumberConfirmations` AllQuietApiAuthenticationModelsPhoneNumberConfirmation[], nullable
        - `phoneNumber` string, nullable
        - `confirmedAt` string, date-time, nullable
        - `requestedAt` string, date-time, nullable
        - `confirmationCode` string, nullable
        - `type` string, nullable
      - `disabledIntentsEmail` string[], nullable
      - `disabledIntentsVoice` string[], nullable
      - `disabledIntentsPush` string[], nullable
      - `disabledIntentsSMS` string[], nullable
    - `calendarPublishingSettings` AllQuietApiCommonCalendarPublishingSettingsResponse
      - `isPublished` boolean
      - `publicCalendarUrlOutlook` string, nullable
      - `publicCalendarUrlGoogle` string, nullable
      - `onlyIncludeTier1` boolean, nullable
    - `disableWeeklyIncidentEngagementReport` boolean
  - `hasMore` boolean

---

[API](https://skmtc.dev/allquiet/apis/all-quiet-public-api.md) - [All operations](https://skmtc.dev/allquiet/apis/all-quiet-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/allquiet/apis/all-quiet-public-api/revisions/a69168a82f2c?raw)