# List Users by ID

```http
GET https://api.synup.com/api/v4/users-by-ids
```

This API retrieves user details for one or more specified user IDs in a single request.

**Behavior:**
- Supports fetching multiple users by providing a list of user IDs.
- Returns detailed user information, including role, status, and attributes.

Source: https://developer.synup.com/api/user-management/list-users-by-id

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `userIds` | array | required | Array of user IDs to fetch details for |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/users-by-ids' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved user details |
| `400` | Bad Request - Invalid user IDs format |
| `401` | Unauthorized - Valid API key required |