# List Users

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

This API retrieves a paginated list of all users in the system.

**Pagination:**
- Uses cursor-based pagination for efficient data retrieval.
- Returns up to 50 users per request.
- Includes pageInfo for navigating through results.

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

## Example request

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

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved users |
| `401` | Unauthorized - Valid API key required |
| `403` | Forbidden - Insufficient permissions to list users |