---
title: "Listar usuarios"
method: GET
path: "/v1/users"
tags: ["Users"]
---

# Listar usuarios

`GET /v1/users`

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Lista de usuarios

- UserListResponse — Respuesta del listado de usuarios (`data` es un arreglo de usuarios).
  - `pagination` Pagination — Metadatos de paginación que acompañan a las respuestas de listado. Usá `page`/`limit` o `offset`/`limit` para recorrer todas las páginas mientras `hasNext` sea `true`.
    - `page` integer — Número de página actual (1-based).
    - `limit` integer — Cantidad de resultados por página. Máximo: 100.
    - `total` integer — Total de resultados que matchean la consulta.
    - `totalPages` integer — Cantidad total de páginas.
    - `hasNext` boolean — Indica si hay una página siguiente.
    - `hasPrev` boolean — Indica si hay una página anterior.
  - `data` User[]
    - `id` string — ID del usuario.
    - `name` string — Nombre del usuario.
    - `email` string, email — Email del usuario.
    - `role` string — Rol del usuario en la empresa. Los valores posibles se listan en `GET /v1/users/roles`.
    - `active` boolean — Indica si el usuario está activo.

---

[API](https://skmtc.net/cliengo/apis/cliengo-public-api.md) · [All operations](https://skmtc.net/cliengo/apis/cliengo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliengo/cliengo-public-api/revisions/94c7ba7d6a11/schema)
