---
title: "Create bulk user lookup using ids"
method: POST
path: "/users-bulk"
tags: ["User"]
---

# Create bulk user lookup using ids

`POST /users-bulk`

Returns user details for the ids provided in the request body.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site ('Can use' global permission).
The user must be able to view user profiles in the Confluence site.

## Request body

- object
  - `accountIds` string[], required — List of accountIds to retrieve user info for.

## Response `200`

Returned if the user info is returned for the account IDs. `results` may be empty if no account IDs were found.

- object
  - `results` User[]
    - `displayName` string — Display name of the user.
    - `timeZone` string — Time zone of the user. Depending on the user's privacy setting, this may return null.
    - `personalSpaceId` string — Space ID of the user's personal space. Returns null, if no personal space for the user.
    - `isExternalCollaborator` boolean — Whether the user is an external collaborator.
    - `accountStatus` 'active' | 'inactive' | 'closed' | 'unknown' — The account status of the user.
    - `accountId` string — Account ID of the user.
    - `email` string — The email address of the user. Depending on the user's privacy setting, this may return an empty string.
    - `accountType` 'atlassian' | 'app' | 'customer' | 'unknown' — The account type of the user.
    - `publicName` string — Public name of the user.
    - `profilePicture` Icon, nullable — This object represents an icon. If used as a profilePicture, this may be returned as null, depending on the user's privacy setting.
      - `path` string, required
      - `isDefault` boolean, required
  - `_links` MultiEntityLinks
    - `next` string — Used for pagination. Contains the relative URL for the next set of results, using a cursor query parameter. This property will not be present if there is no additional data available.
    - `base` string — Base url of the Confluence site.

## Other responses

- `400` — Returned if an invalid request is provided.
- `404` — Returned if the calling user does not have permission to use Confluence or view user profiles.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/c4bd1ed570f2/schema)