---
title: "List users"
description: "Use GET /users to list users. The current public operation is User.findAll."
canonical: https://docs.ordering.co/api-reference/guides/get-users/
---

# List users

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/users/GET/users)

Use `GET /users` to list users. The current public operation is `User.findAll`.

Administrator, business-manager, driver-manager, waiter-manager, and call-center-agent roles can access this operation when authorized. The response also depends on caller, project, relation, and query scope; authentication does not imply that every caller receives every user.

Use `params`, `where`, `page`, and `page_size` only as documented for this operation. Request a bounded page and the fields you need; large unfiltered relationship expansions can be expensive.

```text
GET https://api.ordering.co/v400/en/YOUR_PROJECT/users?page=1&page_size=50&params=id,name,lastname,level,enabled
```

## Legacy SDK example

```javascript
const response = await ordering.users().get()
```

Confirm the SDK package and version before using this helper. For field and role context, see the [User model](https://docs.ordering.co/api-reference/guides/users-model/).

## OpenAPI reference

**Operation:** `GET /users`

**Query parameters**

| Name                     | Type    | Required | Description                                                                                           |
| ------------------------ | ------- | -------- | ----------------------------------------------------------------------------------------------------- |
| `params`                 | string  | No       | —                                                                                                     |
| `orderBy`                | string  | No       | Field to sort by, with `-` prefixed for descending order. Multiple fields can be chained with commas. |
| `page`                   | integer | No       | Page number, starting at 1. Applies only to lists that return a pagination block.                     |
| `page_size`              | integer | No       | Number of items per page.                                                                             |
| `delivery_block_from`    | string  | No       | —                                                                                                     |
| `delivery_block_to`      | string  | No       | —                                                                                                     |
| `orders_count_condition` | string  | No       | —                                                                                                     |
| `orders_count_value`     | integer | No       | —                                                                                                     |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK                                    |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/users/GET/users)