---
title: "Check multiple users"
method: POST
path: "/checkusers"
tags: ["User Checking"]
---

# Check multiple users

`POST /checkusers`

Batch check multiple users and retrieve their group memberships or group counts

## Request body

- object
  - `userIds` union[], required — Array of user IDs to check (strings or numbers)
    - union
      - string
      - number

## Response `200`

Batch check completed successfully

- object
  - `success` boolean
  - `total` number — Total number of user IDs checked
  - `found` number — Number of users found
  - `notFound` number — Number of users not found
  - `users` object[]
    - `success` boolean
    - `userId` string
    - `username` string
    - `groupCount` number — Only included if canViewGroupId is false
    - `lastSeen` string, date-time
    - `found` boolean

## Other responses

- `400` — Bad Request - Invalid input
- `401` — Unauthorized - Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/moco-co/apis/moco-co-api.md) · [All operations](https://skmtc.dev/moco-co/apis/moco-co-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moco-co/moco-co-api/revisions/c28fab28152c/schema)