# Asesores

En esta sección, explicaremos los servicios que se ofrecen para la gestión de asesores en la API REST de Arrendasoft®.

# Listar Asesores

Permite obtener una lista de elementos, donde cada elemento contiene la información de cada uno de los asesores registrados en el sistema.

**Endpoint:** https://<span style="color: rgb(241, 196, 15);">***{{instancia}}***</span>.arrendasoft.co/service/v2/public/agents

**<span style="color: rgb(241, 196, 15);">{{instancia}}</span>:** Hace referencia a la instancia de cada inmobiliaria.

#### **Petición**

<table border="1" id="bkmrk-m%C3%A9todo-get-content-t" style="border-collapse: collapse; width: 100%; height: 124.781px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Método**</td><td style="height: 29.7969px;">GET</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Content-Type**</td><td style="height: 29.7969px;">application/json</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">****Authorization****</td><td style="height: 35.3906px;">**Bearer token,** Token obtenido al consumir el servicio [Login](https://docs.arrendasoft.co/books/api-arrendasoft-v2/page/login "Login")</td></tr></tbody></table>

#### **Respuesta**

Lista de elementos, donde cada elemento contiene la información de cada uno de los asesores.

```json
[
    {
        "id": "8",
        "documento": "12164587200",
        "nombre": "DANIEL RESTREPO",
        "telefono": "789456123",
        "email": "daniel.restrepo@interservicios.com",
        "path_photo": "https://localhost/arrendasoft/pic/iconos/user_photo.png"
    },
    {
        "id": "6",
        "documento": "1216727504",
        "nombre": "KAREN CANO",
        "telefono": "4447417",
        "email": "karen.cano@interservicios.com",
        "path_photo": "https://localhost/arrendasoft/pic/iconos/user_photo.png"
    }
]
```

Tabla con la descripción de cada campo del JSON

<table id="bkmrk-clave-descripci%C3%B3n-id"><thead><tr><th>**Clave**</th><th>**Descripción**</th></tr></thead><tbody><tr><td>`id`</td><td>Identificador único del usuario</td></tr><tr><td>`documento`</td><td>Número de documento de identificación del usuario</td></tr><tr><td>`nombre`</td><td>Nombre completo del usuario</td></tr><tr><td>`telefono`</td><td>Número de teléfono del usuario</td></tr><tr><td>`email`</td><td>Dirección de correo electrónico del usuario</td></tr><tr><td>`path_photo`</td><td>URL a la foto del usuario</td></tr></tbody></table>

# Buscar Asesor por Documento

Permite obtener un elemento que contiene la información del asesor.

**Endpoint:** https://<span style="color: rgb(241, 196, 15);">***{{instancia}}***</span>.arrendasoft.co/service/v2/public/agents/{{document}}

**<span style="color: rgb(241, 196, 15);">{{instancia}}</span>:** Hace referencia a la instancia de cada inmobiliaria.

#### **Petición**

<table border="1" id="bkmrk-m%C3%A9todo-get-content-t" style="border-collapse: collapse; width: 100%; height: 124.781px;"><colgroup><col style="width: 50.0596%;"></col><col style="width: 50.0596%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Método**</td><td style="height: 29.7969px;">GET</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Content-Type**</td><td style="height: 29.7969px;">application/json</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">****Authorization****</td><td style="height: 35.3906px;">**Bearer token,** Token obtenido al consumir el servicio [Login](https://docs.arrendasoft.co/books/api-arrendasoft-v2/page/login "Login")</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Parámetro**</td><td style="height: 29.7969px;">{{document}}, corresponde al número de documento del asesor a consultar</td></tr></tbody></table>

<span style="color: rgb(230, 126, 35);"><span style="color: rgb(0, 0, 0);">**Ejemplo de petición**</span></span>

```
https://{{instancia}}.arrendasoft.co/service/v2/public/agents/1216727504
```

#### **Respuesta**

Elemento con la información de la propiedad.

```json
{
    "id": "6",
    "documento": "1216727504",
    "nombre": "KAREN CANO",
    "telefono": "4447417",
    "email": "karen.cano@interservicios.com",
    "path_photo": "https://localhost/arrendasoft/pic/iconos/user_photo.png"
}
```

Tabla con la descripción de cada campo del JSON.

<table id="bkmrk-clave-descripci%C3%B3n-id"><thead><tr><th>**Clave**</th><th>**Descripción**</th></tr></thead><tbody><tr><td>`id`</td><td>Identificador único del usuario</td></tr><tr><td>`documento`</td><td>Número de documento de identificación del usuario</td></tr><tr><td>`nombre`</td><td>Nombre completo del usuario</td></tr><tr><td>`telefono`</td><td>Número de teléfono del usuario</td></tr><tr><td>`email`</td><td>Dirección de correo electrónico del usuario</td></tr><tr><td>`path_photo`</td><td>URL a la foto del usuario</td></tr></tbody></table>