# Listar Usuarios

Para obtener un listado de los usuarios y sus [Dispositivos](/entidades-basicas/dispositivos.md) asignados, se debe enviar un GET como el que se especifica a continuación.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/users`

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK La consulta se ejecutó con éxito" %}

```json
{
    "success": true,
    "data": [
        {
            "user_id": 23
            "group_id": 1,
            "name": "administrativo1@gmail.com",
            "real_name": "Juan Perez",
            "admin": true,
            "verified": true,
            "deleted": false,
        },
        {
            "user_id": 24,        
            "group_id": 1,
            "name": "supervisor@gmail.com",
            "real_name": "Sebastian Gonzalez",
            "admin": false,
            "verified": true,
            "deleted": false,
            "devices": [
                2,
                5,
                3,
                10
            ]
        },     
        {
            "user_id": 27,        
            "group_id": 1,
            "name": "chofer1@gmail.com",
            "real_name": "Diego Rodriguez",
            "admin": false,
            "verified": true,
            "deleted": false,
            "devices": [
                2
            ]
        }, {...}       
    ]
}
```

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

En caso que no haya ningun error, obtenemos

```json
{
    "success": true,
    "data": [
        {
            "user_id": 23
            "group_id": 1,
            "name": "administrativo1@gmail.com",
            "real_name": "Juan Perez",
            "admin": true,
            "verified": true,
            "deleted": false,
        },
        {
            "user_id": 24,        
            "group_id": 1,
            "name": "supervisor@gmail.com",
            "real_name": "Sebastian Gonzalez",
            "admin": false,
            "verified": true,
            "deleted": false,
            "devices": [
                2,
                5,
                3,
                10
            ]
        },     
        {
            "user_id": 27,        
            "group_id": 1,
            "name": "chofer1@gmail.com",
            "real_name": "Diego Rodriguez",
            "admin": false,
            "verified": true,
            "deleted": false,
            "devices": [
                2
            ]
        }, {...}       
    ]
}
```

Lo que se recibe es un array en donde cada elemento son los datos de un usuario.

**user\_id:** Es un Number, identificando inequivocamente al usuario.

**group\_id:** <mark style="color:red;">No usar</mark>. Es un field interno por el momento.

**name:** Email del usuario. Con este email y su contraseña, puede acceder al sistema tanto en la web como en Android.

**real\_name:** Nombre de pila de la persona. Puede ser Nombre y Apellido, o el modelo y la patente del vehículo, o cualquier indicador que sea de utilidad para la empresa.

**admin:** Es un Boolean. En caso de true, el usuario es un Administrador del sistema, con lo cual tiene acceso total y visualización total.

**verified:** Es un Boolean, indicando si el email del usuario fue verificado. No tiene un uso particular específico.&#x20;

**deleted:** Es un Boolean. Indicando si el usuario está activo actualmente.

**devices:** Es un Array de Numbers. Indica cuales [Dispositivos](/entidades-basicas/dispositivos.md) puede visualizar este usuario.

{% hint style="info" %}
Los usuarios **admin**, no poseen el field **devices**, ya que pueden visualizar todo.

Generalmente, los usuarios que son choferes, o técnicos poseen un solo dispositivo asignado (su propio celular o equipo de rastreo en su vehiculo), mientras que los supervisores suelen tener varios **devices** asignados para poder visualizar y generar los reportes correspondientes
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.persat.com.ar/entidades-basicas/usuarios/listar-usuarios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.