> For the complete documentation index, see [llms.txt](https://docs.api.persat.com.ar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.persat.com.ar/entidades-basicas/dispositivos/obtener-dispositivo.md).

# Obtener Dispositivo

Para obtener un dispositivo particular se debe realizar un GET como el que se muestra a continuación.

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

#### Path Parameters

| Name                                         | Type   | Description                   |
| -------------------------------------------- | ------ | ----------------------------- |
| device\_id<mark style="color:red;">\*</mark> | Number | Identificador del dispositivo |

#### 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": {
        "id": 104,    
        "type": "VEHICLE",
        "serial_number": "3213213-ABCD....",
        "first_name": "Martin Gonzalez",
        "last_name": "LKL 987",
        "working_zones": [
            {
                "id": 2,
                "created": "2013-08-16T14:27:20.000Z",
                "name": " GBA Norte"
            }, { ... }
        ],
        "working_hours": {
            "monday": [],
            "tuesday": [
                {
                    "start": "05:05",
                    "end": "06:06"
                }
            ],
            "wednesday": [],
            "thursday": [],
            "friday": [],
            "saturday": [],
            "sunday": [
                {
                    "start": "01:01",
                    "end": "02:02"
                }
            ]
        }
    }
}
```

{% endtab %}

{% tab title="404: Not Found No se encontro el dispositivo" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id"
    }
}
```

{% endtab %}

{% tab title="400: Bad Request device\_id no es un número" %}

```javascript
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'device_id' debe ser un número entero"
    }
}
```

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

```json
{
    "success": true,
    "data": {
        "id": 104,    
        "type": "VEHICLE",
        "serial_number": "3213213-ABCD....",
        "first_name": "Martin Gonzalez",
        "last_name": "LKL 987",
        "working_zones": [
            {
                "id": 2,
                "created": "2013-08-16T14:27:20.000Z",
                "name": " GBA Norte"
            }, { ... }
        ],
        "working_hours": {
            "monday": [],
            "tuesday": [
                {
                    "start": "05:05",
                    "end": "06:06"
                }
            ],
            "wednesday": [],
            "thursday": [],
            "friday": [],
            "saturday": [],
            "sunday": [
                {
                    "start": "01:01",
                    "end": "02:02"
                }
            ]
        }
    }
}
```

**id:** Identificador del Dispositivo.&#x20;

**first\_name:** Nombre

**last\_name:** Apellido

{% hint style="info" %}
**first\_name** y **last\_name** se pueden usar libremente y pueden identificar a un vehiculo, por ejemplo con su modelo y patente
{% endhint %}

**type:** Tipo de dispositivo. Puede ser "VEHICLE" o "CELLPHONE"

**serial\_number:** Identificador unico del dispositivo físico. Por ejemplo, los dispositivos de tipo VEHICLE, usan como identificador el número de serie del equipo de rastreo, mientras que los de tipo CELLPHONE usan el imei o el número de serie de la placa de video del teléfono.

{% hint style="danger" %}
El <mark style="color:red;">**serial\_number**</mark> es meramente informativo, bajo ninguna circunstancia debe ser utilizado como identificador
{% endhint %}

**working\_zones**. Array con las zonas de trabajo asignadas. Los campos se describen en [Obtener Zona](/entidades-basicas/zonas-de-trabajo/obtener-zona.md)

**working\_hours.** Objeto json que contiene en cada key el día de la semana. Cada día de la semana es un array con objetos { start: "HH:mm", end: "HH:mm }. Indicando inicio y fin de jornada laboral.

{% hint style="warning" %}
Es un array, ya que se contempla para un futuro permitir horarios partidos. Es decir jornadas laborales con descansos intermedios.

Si el array está vacío, significa que no es un dia laborable.
{% endhint %}