---
title: "List pending users"
method: GET
path: "/users/v1/pending-users"
tags: ["Users:v1:Pending Request Users"]
---

# List pending users

`GET /users/v1/pending-users`

List pending user join requests, optionally filtered by IDs and/or status.

## Query parameters

- `ids` integer[], nullable — Filter by pending user IDs. Default: all.
- `status` 'approved' | 'declined' | 'pending'

## Response `200`

Successful Response

- APIResponseGetPendingUsersResponse
  - `requestId` string
  - `data` GetPendingUsersResponse, required
    - `pendingUsers` PendingUserDataResponse[], required — List of pending user data
      - `id` integer, required — Pending user request ID
      - `userFields` object, required — User profile fields submitted with the request
      - `rawFields` object — Raw unprocessed fields from the source
      - `source` string — Origin source of the pending user request
      - `sourceIcon` string — Icon representing the request source
      - `userId` integer — Associated user ID if the request was approved
      - `externalUserId` string — External system user identifier
      - `suggestedUserId` integer — Suggested matching user ID
      - `integrationId` integer — Integration that created this request
      - `linkId` integer — Invite link ID associated with this request
      - `status` string, required — Current status of the pending user request

## Other responses

- `422` — Validation Error

---

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